Vous pouvez créer, mettre à jour, supprimer et partager des connexions à des sources de données. En tant qu'utilisateur Oracle Analytics doté du privilège Auteur de contenu DV, vous pouvez effectuer ces actions.
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 la connexion à une source de données.
Si vous modifiez une connexion SSL à une base de données Oracle Database et que vous devez utiliser un nouveau fichier cwallet.sso
dans le champ Portefeuille du client, cliquez sur Sélectionner pour rechercher le fichier cwallet.sso
. Demandez à l'administrateur où se trouve le fichier cwallet.sso
.
Vous pouvez supprimer une connexion à une source de données à partir d'Oracle Analytics Cloud. Par exemple, vous devez supprimer une connexion à la base de données et en créer une nouvelle lorsque le mot de passe de la base de données est modifié.
Si la connexion comporte des jeux de données, vous devez d'abord supprimer ces derniers pour pouvoir supprimer la connexion.
Vous pouvez affecter des autorisations d'accès aux connexions aux sources de données que vous créez ou administrez.
Lorsque vous spécifiez des détails de connexion à l'aide de la boîte de dialogue Créer une connexion ou Inspecter, certains types de base de données présentent des options de configuration supplémentaires.
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 en masse - Si vous chargez un jeu de données pour un classeur, cette option doit être désactivée. Vous pouvez l'ignorer. Cette option est réservée aux analystes de données et aux utilisateurs avancés pour la réplication de données à partir d'une base de données vers une autre.
Options d'authentification
Connexion au système
Cliquez sur Copier pour copier l'ID objet de la connexion. Les modélisateurs de l'entreprise peuvent coller l'ID objet pour identifier et utiliser une connexion de données dans l'outil d'administration de modèle (boîte de dialogue Réserve de connexions).
Note : Si vous ne cliquez pas sur Connexion au système lorsque vous créez initialement la connexion, vous devez créer une nouvelle connexion et sélectionner Connexion au système si vous voulez que les modélisateurs de données utilisent ultérieurement les détails de la connexion. En d'autres termes, vous ne pouvez pas modifier la connexion ultérieurement et sélectionner cette option.
Il importe de bien comprendre les exigences relatives à la connexion à la base de données avant de la créer.
Le nombre maximal de tables de base de données affichées dans Oracle Analytics est 10 000. Si vous avez besoin de tables supplémentaires, Oracle recommande de demander à l'administrateur de la base de données de créer un utilisateur de base de données avec accès aux objets précis à analyser et de spécifier les données 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, Oracle Autonomous Data Warehouse, Oracle Transaction Processing, Snowflake, SQL Server ou My SQL, vous pouvez modifier le type de guillemet par défaut afin de pouvoir lire des données comportant des caractères majuscules, minuscules ou mixtes dans les noms de table ou de colonne.
select "EfG_Field" from "AbCd";
au lieu d'émettre l'énoncé select EfG_Field from AbCd;
(qui échouerait).Vous pouvez utiliser les API REST d'Oracle Analytics Cloud pour gérer par programmation les connexions vers diverses sources de données. Par exemple, vous pouvez créer un script qui crée (ou modifie) le même jeu de connexions dans vos environnements Oracle Analytics Cloud de test et de production.
Vous pouvez créer, mettre à jour et supprimer des connexions pour diverses sources de données à l'aide des API REST. Cette rubrique liste les types de connexion aux sources de données pouvant être gérés à l'aide d'API REST.
Note :
API REST pour Oracle Analytics Cloud fournit des informations détaillées sur chaque API REST. Voir Points d'extrémité 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 sont différents. Si vous voulez utiliser les API REST pour créer ou mettre à jour une connexion, vous devez connaître le format des données utiles JSON requis pour votre source de données. Voir Exemples de données utiles JSON pour les sources de données.
Les tâches courantes pour commencer à utiliser les API REST d'Oracle Analytics Cloud pour gérer les connexions par programmation sont décrites ci-dessous. Si vous utilisez les API REST pour la première fois, servez-vous des tâches suivantes comme guide.
Tâche | Description | Documentation d'API REST |
---|---|---|
Présentation des conditions requises |
Comprenez et exécutez plusieurs tâches préalables. Vous devez disposer des autorisations de création de classeurs et de connexion aux données d'Oracle Analytics Cloud pour gérer les connexions de données à l'aide des API REST (Auteur de contenu DV). |
Conditions requises |
Présenter 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. Pour 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 | Lisez la rubrique qui décrit les types de connexion de données pouvant être gérés à l'aide d'API REST. | Sources de données prises en charge |
Déterminer les formats des données utiles JSON | Lisez la rubrique qui décrit le format des données utiles JSON pour votre source de données et obtenez les paramètres de connexion requis. | Exemples de données 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 (Prévisualisation) |
Mettre à jour une connexion | Mettez à jour une ou plusieurs propriétés d'une connexion de données existante. | Mettre à jour une connexion (Prévisualisation) |
Supprimer une connexion | Supprimez une connexion de données. | Supprimer une connexion (Prévisualisation) |
Utilisez ces exemples pour vous aider à gérer les connexions aux sources 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 du porteur OAuth 2.0 requis pour authentifier les appels aux API REST d'Oracle Analytics Cloud. Voir Authentification par jeton OAuth 2.0.
<hostname> - Hôte sur lequel Oracle Analytics Cloud s'exécute.
<data source connection payload> - Informations de connexion propres à la source de données. Voir Exemples de données utiles JSON pour les sources de données.
<security wallet file> - Contient les informations SSL, telles que les données d'identification pour l'authentification et la signature, les clés privées, les certificats et le certificat approuvé. Requis pour certains types de connexion, notamment Oracle Database avec SSL et Oracle Autonomous Data Warehouse (authentification TLS mutuelle).
Exemples
Les exemples ci-dessous montrent comment créer une connexion à Oracle Autonomous Data Warehouse (ADW).
cwallet.sso
(authentification TLS mutuelle)Vous trouverez d'autres exemples dans API REST pour Oracle Analytics Cloud. Voir Créer une connexion (Prévisualisation), Mettre à jour une connexion (Prévisualisation) et Supprimer une connexion (Prévisualisation).
Note :
Les données utiles JSON de ces exemples sont propres à Oracle ADW. Le format des données utiles JSON est différent pour les autres sources de données. Voir Exemples de données utiles JSON pour les sources de données prises en charge.
Exemple 1 Créer une connexion sans portefeuille (TLS) à Oracle ADW
oracle_adw_walletless
. Le corps de la demande inclut le format 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_adw_walletless", "description": "Sample Oracle ADW 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_adwwalletless_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 la valeur connectionId
encodée en Base64 dans le corps de la réponse. Vous pourrez utiliser cette valeur pour mettre à jour ou supprimer la connexion.
Exemple 2 Créer une connexion à Oracle ADW qui utilise un fichier de portefeuille (authentification TLS mutuelle)
oracle_adw_with_wallet
. Le corps de la demande contient multipart/form-data
, c'est-à-dire qu'un fichier de portefeuille Oracle ADW (cwallet.sso
) et des paramètres de connexion à Oracle ADW sont requis.
curl --header "Authorization: Bearer <token>" -–request POST https://<hostname>/api/20210901/catalog/connections --form "cert=@"/Users/scott/Downloads/Wallet_adw/cwallet.sso"" --form "connectionParams= "{ "version": "2.0.0", "type": "connection", "name": "oracle_adw_with_wallet", "description": "Sample Oracle ADW 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_walletadw_high.adwc.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 la valeur connectionId
encodée en Base64 dans le corps de la réponse. Vous pourrez utiliser cette valeur pour mettre à jour ou supprimer la connexion.
Pour vous connecter à une source de données, vous indiquez des paramètres de connexion. Lorsque vous utilisez l'API REST de connexion, vous spécifiez les paramètres de connexion dans un format de données utiles JSON. Utilisez ce tableau pour identifier les données utiles JSON pour la source de données à laquelle vous voulez vous connecter.
Source de données | Type de demande | Données utiles d'entrée |
---|---|---|
Oracle 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 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 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 Database avec SSL |
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_db_ssl", "description": "Sample Oracle 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 Data Warehouse - Sans portefeuille (TLS) |
application/json |
Type de connexion de base { "version": "2.0.0", "type": "connection", "name": "oracle_adw_walletless_basic", "description": "Sample Oracle ADW 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 Data Warehouse - 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_adw_with_wallet", "description": "Sample Oracle ADW 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" } } } |