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 à une base de données Oracle et que vous devez utiliser un nouveau fichier cwallet.sso
, dans le champ Portefeuille client, cliquez sur Sélectionner pour accéder au 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.
Options d'authentification
Connexion système
Cliquez sur Copier pour copier l'ID d'objet de la connexion. Les modeleurs peuvent coller l'ID d'objet pour identifier et utiliser une connexion de données dans l'outil d'administration de modèle (boîte de dialogue Pool de connexions).
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, Oracle Autonomous Data Warehouse, Oracle 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éation d'une connexion (Aperçu) |
Mettre à jour une connexion | Mettez à jour les propriétés d'une connexion de données existante. | Mise à jour d'une connexion (Aperçu) |
Supprimer une connexion | Supprimez une connexion de données. | Suppression d'une connexion (Aperçu) |
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 Database avec SSL et Oracle Autonomous Data Warehouse (authentification TLS mutuelle).
Exemples
Les exemples suivants vous montrent comment créer une connexion à Oracle Autonomous Data Warehouse Cloud (ADW).
cwallet.sso
(authentification TLS mutuelle)D'autres exemples sont disponibles dans API REST pour Oracle Analytics Cloud. Reportez-vous à Création d'une connexion (Aperçu), à Mise à jour d'une connexion (Aperçu) et à Suppression d'une connexion (Aperçu).
Remarque :
Les charges utiles JSON de ces exemples sont propres à Oracle ADW. 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 prises en charge (Aperçu).
Exemple 1 : création d'une connexion sans portefeuille (TLS) à Oracle ADW
oracle_adw_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_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 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 ADW utilisant un fichier de portefeuille (authentification TLS mutuelle)
oracle_adw_with_wallet
. Le corps de demande inclut multipart/form-data
. Autrement dit, un fichier de portefeuille d'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 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.
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 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 } } } |
Base de données Oracle 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 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" } } } |