Vous pouvez créer, mettre à jour, enlever et partager des connexions à des sources de données. En tant qu'utilisateur Oracle Analytics disposant d'un accès Auteur de contenu DV, vous pouvez effectuer les opérations suivantes.
Rubriques :
Vous pouvez créer une connexion pour pouvoir analyser les données de cette source de données.
Vous pouvez mettre à jour les détails de connexion d'ne source de données.
Si vous modifiez une connexion SSL à Oracle AI Database et que vous devez utiliser un nouveau fichier cwallet.sso, dans le champ Portefeuille client, cliquez sur Sélectionner pour rechercher le fichier cwallet.sso. Demandez à l'administrateur l'emplacement du fichier cwallet.sso.
Vous pouvez enlever une connexion à une source de données à partir d'Oracle Analytics Cloud. Par exemple, vous devez supprimer une connexion de base de données et en créer une autre lorsque le mot de passe de la base de données a été modifié.
Si la connexion contient des ensembles de données, vous devez les supprimer pour pouvoir supprimer la connexion.
Vous pouvez affecter des droits d'accès aux connexions de source de données que vous créez ou administrez.
Lorsque vous indiquez les détails de connexion dans la boîte de dialogue Créer une connexion ou Inspecter, des options de configuration supplémentaires sont disponibles pour certains types de base de données.
Options générales
sales.example.com =(DESCRIPTION= (ADDRESS_LIST= (LOAD_BALANCE=on)(FAILOVER=ON) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.111)(PORT=1521)) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.222)(PORT=1521)) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.333)(PORT=1521))) (CONNECT_DATA=(SERVICE_NAME= salesservice.example.com)))
Activer la réplication globale : si vous chargez un ensemble de données pour un classeur, cette option doit être désactivée et vous pouvez l'ignorer. Cette option est réservée aux analystes de données et aux utilisateurs avancés pour leur permettre de répliquer des données d'une base de données vers une autre.
Emplacement : dossier de catalogue dans lequel les détails de connexion sont stockés. Utilisez l'option Parcourir pour modifier le dossier par défaut (c'est-à-dire Mes dossiers). Si vous souhaitez que d'autres utilisateurs puissent utiliser la connexion, enregistrez-la dans la zone Dossiers partagés.
Options d'authentification
Connexion système
Sélectionnez Connexion système si vous voulez utiliser ces détails de connexion dans le modeleur sémantique ou dans l'outil d'administration de modèle.
Remarque : si vous ne cliquez pas sur Connexion système lors de la création initiale de la connexion et que vous voulez ultérieurement que les modeleurs de données utilisent les détails de connexion, vous devez créer une autre connexion et sélectionner Connexion système. Autrement dit, vous ne pouvez pas modifier ultérieurement la connexion et sélectionner cette option.
Comprenez bien les exigences de connexion à la base de données avant de créer la connexion.
Le nombre maximal de tables de base de données affichées dans Oracle Analytics est de 10 000. Si vous avez besoin de tables supplémentaires, Oracle recommande de demander à l'administrateur de base de données de créer un utilisateur de base de données avec accès aux objets spécifiques à analyser et d'indiquer les informations d'identification de cet utilisateur lorsque vous créez la connexion à la base de données.
Si vous vous connectez à une base de données Oracle Autonomous AI Lakehouse, Oracle Autonomous AI Transaction Processing, Snowflake, SQL Server ou My SQL, vous pouvez modifier l'identificateur de placement entre des symboles par défaut afin de pouvoir lire les données avec des caractères en majuscules, en minuscules ou combinant les deux dans les noms de table ou de colonne.
select "EfG_Field" from "AbCd"; au lieu de générer select EfG_Field from AbCd; (qui échouerait).Vous pouvez utiliser des API REST Oracle Analytics Cloud pour gérer par programmation des connexions à un large éventail de sources de données. Par exemple, si vous voulez créer un script qui crée (ou modifie) le même ensemble de connexions dans les environnements Oracle Analytics Cloud de test et de production.
Vous pouvez créer, mettre à jour et supprimer des connexions pour un large éventail de sources de données à l'aide des API REST. Cette rubrique répertorie les types de connexion de source de données que vous pouvez gérer avec des API REST.
Remarque :
API REST pour Oracle Analytics Cloud fournit des informations détaillées sur chaque API REST. Reportez-vous à Adresses REST de connexion.Sources de données prises en charge
Paramètres de connexion
Les paramètres de connexion requis pour chaque source de données diffèrent. Si vous voulez utiliser l'API REST afin de créer ou de mettre à jour une connexion, vous devez connaître le format de charge utile JSON requis pour votre source de données. Reportez-vous à Exemples de charges utiles JSON pour les sources de données.
Voici les tâches courantes pour à utiliser des API REST Oracle Analytics Cloud afin de gérer des connexions par programmation. Si vous utilisez les API REST pour la première fois, servez-vous de ces tâches comme guide.
| Tâche | Description | Documentation relative à l'API REST |
|---|---|---|
| Comprendre les prérequis |
Découvrez et effectuez plusieurs tâches de prérequis. Vous devez disposer de droits d'accès permettant de créer des classeurs et de vous connecter aux données dans Oracle Analytics Cloud pour gérer des connexions de données à l'aide d'API REST (Auteur de contenu DV). |
Prérequis |
| Comprendre l'authentification par jeton OAuth 2.0 | L'authentification et l'autorisation dans Oracle Analytics Cloud sont gérées par Oracle Identity Cloud Service. Afin d'accéder aux API REST Oracle Analytics Cloud, vous avez besoin d'un jeton d'accès OAuth 2.0 à utiliser pour l'autorisation. | Authentification par jeton OAuth 2.0 |
| Comprendre les sources de données prises en charge | Lisez la rubrique qui décrit les types de connexion de données que vous pouvez gérer avec des API REST. | Sources de données prises en charge |
| Déterminer les formats de charge utile JSON | Lisez la rubrique qui décrit le format de charge utile JSON correspondant à votre source de données afin de connaître les paramètres de connexion requis. | Exemples de charges utiles JSON pour les sources de données |
| Créer une connexion | Créez une connexion de données à utiliser dans les classeurs, les rapports et les tableaux de bord. | Créer une connexion |
| Mettre à jour une connexion | Mettez à jour les propriétés d'une connexion de données existante. | Mettre à jour une connexion |
| Supprimer une connexion | Supprimez une connexion de données. | Supprimer une connexion |
Utilisez les exemples suivants pour gérer les connexions de source de données avec des demandes d'API REST à l'aide de cURL.
Exemple de format cURL
curl --header "Authorization: Bearer <token>" --header "Content-Type: application/json" --request POST|PUT https://<hostname>/api/20210901/catalog/connections --data "<data source connection payload>"
curl --header "Authorization: Bearer <token>" --request POST|PUT https://<hostname>/api/20210901/catalog/connections --form "cert=<security wallet file>" --form "connectionParams=<data source connection payload>"
<token> : jeton de service support OAuth 2.0 requis pour authentifier les appels aux API REST Oracle Analytics Cloud. Reportez-vous à Authentification par jeton OAuth 2.0 .
<hostname> : hôte où est exécuté Oracle Analytics Cloud.
<data source connection payload> : informations de connexion propres à la source de données. Reportez-vous à Exemples de charges utiles JSON pour les sources de données.
<security wallet file> : stocke des informations relatives à SSL, telles que les informations d'identification pour l'authentification et la signature, les clés privées, les certificats et le certificat sécurisé. Requis pour certains types de connexion, par exemple Oracle AI Database avec SSL et Oracle Autonomous AI Lakehouse (authentification TLS mutuelle).
Exemples
Les exemples suivants vous montrent comment créer une connexion à Oracle Autonomous AI Lakehouse (ALK).
cwallet.sso (authentification TLS mutuelle)Remarque :
Les charges utiles JSON de ces exemples sont propres à Oracle ALK. Le format de charge utile JSON est différent pour les autres sources de données. Reportez-vous à Exemples de charges utiles JSON pour les sources de données.Exemple 1 : création d'une connexion sans portefeuille (TLS) à Oracle Autonomous AI Lakehouse
oracle_ALK_walletless. Le corps de demande inclut une structure JSON simple : application/json.
curl
--header "Authorization: Bearer <token>"
--header "Content-Type: application/json"
--request POST https://example.com/api/20210901/catalog/connections
--data "{
"version": "2.0.0",
"type": "connection",
"name": "oracle_ALK_walletless",
"description": "Sample Oracle ALK connection without a wallet created using Connections API",
"content": {
"connectionParams": {
"connectionType": "oracle-autonomous-data-warehouse",
"connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1521)(host=adb.us-ashburn-1.oraclecloud.com))(connect_data=(service_name=abcdefg1hijkl2m_ALKwalletless_high.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes)))",
"username": "ADMIN",
"password": "<<password>>",
"systemConnection": false,
"remoteData": false,
"sslType": "ServerSideSSL"
}
}
}"Corps de la réponse
{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}
Notez l'ID de connexion (connectionId) encodé en Base64 qui figure dans le corps de réponse. Vous pourrez utiliser cette valeur ultérieurement pour mettre à jour ou supprimer la connexion.
Exemple 2 : création d'une connexion à Oracle ALK utilisant un fichier de portefeuille (authentification TLS mutuelle)
oracle_ALK_with_wallet. Le corps de demande inclut multipart/form-data. Autrement dit, un fichier de portefeuille d'Oracle ALK (cwallet.sso) et des paramètres de connexion Oracle ALK sont requis.
curl
--header "Authorization: Bearer <token>"
-–request POST https://<hostname>/api/20210901/catalog/connections
--form "cert=@"/Users/scott/Downloads/Wallet_ALK/cwallet.sso""
--form "connectionParams= "{
"version": "2.0.0",
"type": "connection",
"name": "oracle_ALK_with_wallet",
"description": "Sample Oracle ALK connection with a wallet created using Connections API",
"content": {
"connectionParams": {
"connectionType": "oracle-autonomous-data-warehouse",
"connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps) (port=1522)(host=adb.us-ashburn-1.oraclecloud.com))(connect_data=(service_name=abcdefg1hijkl2m_walletALK_high.ALKc.oraclecloud.com/))(security=(ssl_server_dn_match=yes)))",
"username": "ADMIN",
"password": "<<password>>",
"remoteData": "false",
"systemConnection": false,
"sslType": "ClientSideSSL"
}
}
}"Corps de la réponse
{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}
Notez l'ID de connexion (connectionId) encodé en Base64 qui figure dans le corps de réponse. Vous pourrez utiliser cette valeur ultérieurement pour mettre à jour ou supprimer la connexion.
D'autres exemples sont disponibles dans API REST pour Oracle Analytics Cloud. Reportez-vous à Créer une connexion, à Mettre à jour une connexion et à Supprimer une connexion.
Pour vous connecter à une source de données, vous devez indiquer des paramètres de connexion. Lorsque vous utilisez l'API REST des connexions, vous devez indiquer les paramètres de connexion dans un format de charge utile JSON. Utilisez le tableau ci-après pour déterminer la charge utile JSON de la source de données à laquelle se connecter.
| Source de données | Type de demande | Charge utile d'entrée |
|---|---|---|
|
Oracle AI Database (Non SSL) |
application/json |
Type de connexion de base {
"version": "2.0.0",
"type": "connection",
"name": "oracle_db_non_ssl_basic",
"description": "Sample non-SSL Oracle AI Database connection created using Connections API",
"content": {
"connectionParams": {
"connectionType": "oracle-database",
"host": "example.com",
"port": "1521",
"serviceName": "orcl",
"username": "admin",
"password": "<password>",
"remoteData": false,
"systemConnection": false
}
}
}
Type de connexion avancé {
"version": "2.0.0",
"type": "connection",
"name": "oracle_db_non_ssl_advanced ",
"description": " Sample non-SSL Oracle AI Database connection created with the advanced connection string format using Connections API",
"content": {
"connectionParams": {
"connectionString": "(DESCRIPTION= (ADDRESS_LIST= (LOAD_BALANCE=on)(FAILOVER=ON) (ADDRESS=(PROTOCOL=tcp)(HOST=example.com)(PORT=1521))) (CONNECT_DATA=(SERVICE_NAME=ORCLPDB1)))",
"username": "admin",
"password": "<password>",
"connectionType": "oracle-database",
"remoteData": false,
"systemConnection": false
}
}
} |
|
Oracle AI Database avec SSL |
multi-part/form-data |
cwallet.sso (client credentials file) Type de connexion de base cert: <cwallet.sso file location>
connectionParams: {
"version": "2.0.0",
"type": "connection",
"name": "oracle_db_ssl",
"description": "Sample Oracle AI Database connection with SSL created using Connections API",
"content": {
"connectionParams": {
"connectionType": "oracle-database",
"host": "example.com",
"port": "2484",
"serviceName": "ORCLPDB1",
"username": "admin",
"password": "<password>",
"systemConnection": false,
"remoteData": false
}
}
} |
|
Oracle Autonomous AI Lakehouse - Sans portefeuille (TLS) |
application/json |
Type de connexion de base {
"version": "2.0.0",
"type": "connection",
"name": "oracle_ALK_walletless_basic",
"description": "Sample Oracle ALK connection without a wallet created using Connections API",
"content": {
"connectionParams": { "connectionType": "oracle-autonomous-data-warehouse",
"connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1521) (host=example.com)) (connect_data=(service_name=example.com)) (security=(ssl_server_dn_match=yes)))",
"username": "admin",
"password": "<password>",
"systemConnection": false,
"remoteData": false,
"sslType": "ServerSideSSL"
}
}
} |
|
Oracle Autonomous AI Lakehouse - Portefeuille (authentification TLS mutuelle) |
multipart/form-data |
cwallet.sso (client credentials file) Type de connexion de base cert: <cwallet.sso file location>
connectionParams: {
"version": "2.0.0",
"type": "connection",
"name": "oracle_ALK_with_wallet",
"description": "Sample Oracle ALK connection with wallet created using Connections API",
"content": {
"connectionParams": {
"connectionType": "oracle-autonomous-data-warehouse",
"connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)
(port=1522)(host=example.com))
(connect_data=(service_name=example.com))
(security=(ssl_server_dn_match=yes)))",
"username": "admin",
"password": "<password>",
"remoteData": "false",
"systemConnection": false,
"sslType": "ClientSideSSL"
}
}
} |
|
PostgreSQL (Non SSL) |
application/json |
Type de connexion de base {
"version":"2.0.0",
"type": "connection",
"name": "postgres_non_SSL",
"description": "Sample PostgreSQL connection created using Connections API",
"content": {
"connectionParams": {
"connectionType": "postgresql-database",
"host": "example.com",
"port": "5432",
"serviceName": "postgres",
"username": "admin",
"password": "<password>",
"remoteData": false,
"systemConnection": false
}
}
} |
|
PostgreSQL avec SSL |
application/json |
Type de connexion de base {
"version":"2.0.0",
"type": "connection",
"name": "postgres_SSL_Conn",
"description": "Sample PostgreSQL connection with SSL created using Connections API",
"content": {
"connectionParams": {
"connectionType": "postgresql-database",
"host": "example.com",
"port": "5432",
"serviceName": "postgres",
"username": "admin",
"password": "<password>",
"sslType":"ServerSideSSL",
"remoteData": false,
"systemConnection": false
}
}
} |
|
SQL Server (Non SSL) |
application/json |
Type de connexion de base {
"version":"2.0.0",
"type": "connection",
"name": "SqlServer_non_ssl",
"description": "Sample non-SSL SQL Server connection created using Connections API",
"content": {
"connectionParams": {
"connectionType": "sqlserver-database",
"host": "example.com",
"port": "1400",
"serviceName": "sqlserver1",
"username": "admin",
"password": "<password>",
"remoteData": false,
"systemConnection": false
}
}
} |
| SQL Server avec SSL | application/json |
Type de connexion de base {
"version":"2.0.0",
"type": "connection",
"name": "SqlServer_ssl",
"description": "Sample SQL Server connection with SSL created using the Connections API",
"content": {
"connectionParams": {
"connectionType": "sqlserver-database",
"host": "example.com",
"port": "60190",
"serviceName": "sqlserver1",
"username": "admin",
"password": "<password>",
"sslType":"ServerSideSSL",
"remoteData": false,
"systemConnection": false
}
}
} |
|
MySQL (Non SSL) |
application/json |
Type de connexion de base {
"version":"2.0.0",
"type": "connection",
"name": "MySql_no_SSL",
"description": "Sample MySQL connection created using the Connections API",
"content": {
"connectionParams": {
"connectionType": "mysql-database",
"host": "example.com",
"port": "3307",
"serviceName": "mysql1",
"username": "admin",
"password": "<password>",
"remoteData": false,
"systemConnection": false
}
}
} |
| MySQL avec SSL | application/json |
Type de connexion de base {
"version":"2.0.0",
"type": "connection",
"name": "MySql_ssl",
"description": "Sample MySQL connection with SSL created using Connections API",
"content": {
"connectionParams": {
"connectionType": "mysql-database",
"host": "example.com",
"port": "3306",
"serviceName": "mysql1",
"username": "admin",
"password": "<password>",
"sslType":"ServerSideSSL",
"remoteData": false,
"systemConnection": false
}
}
} |
|
Oracle Essbase |
application/json |
Type de connexion de base {
"version":"2.0.0",
"type": "connection",
"name": "Oracle_Essbase",
"description": "Sample Oracle Essbase connection created using Connections API",
"content": {
"connectionParams": {
"connectionType": "oracle-essbase",
"dsn":"example.com",
"username":"admin",
"password":"<password>",
"remoteData": false,
"systemConnection": false,
"authentication":"current"/"private"/"sso"
}
}
} |