Se connecter au service de calcul

Cette section porte sur la connexion du service de calcul de votre atelier de plate-forme de données d'intelligence artificielle à d'autres outils d'intelligence d'affaires.

Rubriques :

• Connexions
• Connecter Oracle Analytics à AI Data Platform Workbench
• Télécharger le pilote JDBC
• Connecter Tableau à AI Data Platform à l'aide de JDBC
• Télécharger le pilote ODBC

Connexions

Vous pouvez connecter votre atelier de plate-forme de données d'intelligence artificielle à Oracle Analytics Cloud ou à d'autres outils d'intelligence d'affaires.

Vous pouvez vous connecter à Oracle AI Data Platform Workbench à partir de différents outils d'intelligence d'affaires à l'aide d'un JDBC ou d'un ODBC personnalisé fourni par AI Data Platform Workbench. AI Data Platform Workbench prend également en charge les connexions à partir d'outils BI commerciaux tiers (Tableau, Power BI) ou d'outils BI open source tels que DBeaver. Pour vous connecter à partir de ces outils, vous avez besoin des détails de connexion de la grappe de calcul dans AI Data Platform Workbench, que vous pouvez trouver dans l'onglet Détails de la connexion. Les informations requises varient en fonction du produit à partir duquel vous êtes connecté.

Connecter Oracle Analytics à AI Data Platform Workbench

Vous pouvez vous connecter au catalogue ou aux tables gérés par votre instance AI Data Platform Workbench à partir d'une instance Oracle Analytics Cloud.

Pour créer une connexion d'Oracle Analytics à Oracle AI Data Platform Workbench, vous devez effectuer les opérations suivantes :

1. Obtenir une clé d'API à partir d'OCI.
2. Obtenez un fichier de configuration de connexion Oracle Analytics.
3. Combinez la clé d'API et le fichier de configuration pour créer la connexion. Voir Créer un fichier de connexion Oracle Analytics.
4. Utilisez la connexion dans Oracle Analytics Cloud. Voir Connecter l'atelier Plate-forme de données d'Oracle AI à Oracle Analytics.

Vous pouvez exécuter les étapes 1 et 2 dans n'importe quel ordre, mais elles doivent toutes deux être exécutées avant de continuer.

Oracle recommande de créer un utilisateur dans OCI dédié au cas d'utilisation d'Oracle Analytics. Cet utilisateur doit disposer des autorisations appropriées pour les tables de l'atelier Plate-forme de données d'intelligence artificielle auxquelles vous souhaitez accéder à partir d'Oracle Analytics. Générez la clé d'API nécessaire dans OCI et téléchargez le fichier PEM pour l'utilisateur créé à cette fin.

Note :

• Pour vous connecter à l'atelier Plate-forme de données d'intelligence artificielle à partir d'Oracle Analytics, vous devez fournir le nom du catalogue lors de la configuration de la connexion.
• Le catalogue est actuellement nécessaire pour que le système localise le schéma et les objets de données appropriés dans la grappe AI Data Platform.
• Cette exigence sera allégée dans une version ultérieure.

Obtenir une clé d'API à partir d'OCI

Vous avez besoin d'une clé d'API d'OCI pour un utilisateur ayant accès à votre atelier de plate-forme de données Oracle AI lors de la création d'une connexion à Oracle Analytics.

L'utilisateur pour lequel vous créez la clé d'API doit être le créateur de l'instance AI Data Platform Workbench ou disposer des autorisations d'administrateur pour l'instance. Vous devez également disposer d'une grappe AI Data Platform Workbench valide dans l'instance.

1. Dans OCI, cliquez sur l'icône d'utilisateur, puis sur Paramètres de l'utilisateur.
   
   

   

   
   
2. Dans Mon profil, cliquez sur Jeux et clés, puis sur Ajouter une clé d'API.
   
   

   

   
   
3. Sélectionnez Générer une paire de clés d'API, puis cliquez sur Télécharger la clé privée.
   
   

   

   
   
4. Cliquez sur Ajouter.

Enregistrez la clé privée (fichier .pem) que vous recevez dans un emplacement sécurisé et persistant. Elle est requise pour les connexions et ne peut être téléchargée qu'une seule fois. Ce fichier est utilisé comme empreinte numérique lors de la connexion d'Oracle Analytics à l'atelier Plate-forme de données d'intelligence artificielle.

Obtenir un fichier de configuration de connexion Oracle Analytics

Vous devez télécharger un fichier config.json à partir de votre instance Oracle AI Data Platform Workbench pour le connecter à Oracle Analytics.

Vous avez besoin d'une grappe de calcul avec au moins 2 OCPU, 32 Go de mémoire pour les noeuds de pilote et de travail et au moins 2 programmes.

1. Naviguez jusqu'à votre espace de travail et cliquez sur Calcul.
   
   

   

   
   
2. Cliquez sur la grappe à laquelle vous voulez vous connecter à Oracle Analytics.
3. Dans l'onglet Détails de la connexion, cliquez sur l'icône Télécharger sous le logo Oracle Analytics Cloud. Un fichier config.json est téléchargé sur votre ordinateur.
   
   

   

   
   

La paire de valeurs de clé d'empreinte digitale est manquante dans le fichier config.json que vous avez téléchargé. Il doit être combiné avec la valeur de clé d'empreinte numérique provenant d'une clé d'API appartenant à un utilisateur OCI qui a créé l'atelier Plate-forme de données d'intelligence artificielle ou à un utilisateur disposant des autorisations d'administration.

Créer un fichier de connexion Oracle Analytics

Vous devez ajouter manuellement la paire clé-valeur d'empreinte numérique au fichier config.json téléchargé à partir de votre atelier de plate-forme de données Oracle AI afin que le fichier puisse être utilisé pour la connexion à Oracle Analytics.

Vous devez avoir créé une clé d'API pour un utilisateur OCI qui a créé l'instance AI Data Platform Workbench ou qui dispose des autorisations d'administrateur pour l'instance. Vous devez également avoir téléchargé config.json à partir de la grappe à laquelle vous voulez vous connecter à Oracle Analytics.

1. Ouvrez le fichier config.json et le fichier de configuration de la clé d'API.
2. Modifiez config.json pour ajouter la valeur d'empreinte numérique à partir du fichier de configuration de la clé d'API.
   
   

   

   
   
3. Enregistrez vos modifications dans le fichier config.json.
   
   

   

   
   

Dans une version future, config.json inclura l'empreinte numérique de la clé publique de l'API et vous n'aurez plus à l'ajouter manuellement. Dans cette version, la dernière clé d'API disponible pour l'utilisateur sera utilisée dans config.json.

Connecter l'atelier de plate-forme de données d'Oracle AI à Oracle Analytics

Vous pouvez vous connecter au catalogue ou aux tables gérés par votre instance AI Data Platform Workbench à partir d'une instance Oracle Analytics.

Les connexions d'Oracle Analytics aux instances AI Data Platform Workbench ne prennent en charge qu'un seul catalogue par connexion. Vous devez créer des connexions supplémentaires pour utiliser plusieurs catalogues.

1. Dans la page d'accueil Oracle Analytics, cliquez sur Créer, puis sur Connexion.
   
   

   

   
   
2. Cliquez sur Plate-forme de données Oracle AI.
   
   

   

   
   
3. Entrez un nom et une description pour la connexion.
   
   

   

   
   
4. Pour les détails de la connexion, cliquez sur Sélectionner, naviguez jusqu'à votre fichier config.json et cliquez sur Ouvrir. Pour plus d'informations, voir Créer un fichier de connexion Oracle Analytics.
5. Sélectionnez Clé d'API comme type d'authentification.
6. Entrez le nom du catalogue à utiliser dans vos jeux de données.
7. Pour la clé d'API privée, cliquez sur Sélectionner, naviguez jusqu'à votre clé d'API privée (). Fichier PEM), puis cliquez sur Ouvrir. Pour plus d'informations, voir Obtenir une clé d'API à partir d'OCI.
8. Cliquez sur Enregistrer.
9. Testez votre nouvelle connexion en créant un nouveau jeu de données. Pour plus d'informations, voir Créer un jeu de données à partir d'une connexion.

Si vous avez suivi les instructions et que des problèmes surviennent encore lors de l'enregistrement de la connexion ou de la liste de vos schémas, un redémarrage de grappe peut être nécessaire.

Télécharger le pilote JDBC

Vous pouvez télécharger le pilote JDBC à partir de l'onglet Détails de la connexion et le configurer pour différents outils BI.

1. Naviguez jusqu'à votre espace de travail et cliquez sur Calcul.
2. Cliquez sur la grappe à laquelle vous voulez vous connecter à un outil BI compatible JDBC et cliquez sur Connexions.
3. Cliquez sur Télécharger le pilote JDBC.

Configurer DBeaver

Vous devez installer DBeaver et préparer les fichiers téléchargés à partir d'Oracle AI Data Platform Workbench avant de pouvoir les connecter à une grappe de calcul dans votre AI Data Platform Workbench.

1. Télécharger et installer le client DBeaver. Vous pouvez utiliser les versions Community ou Enterprise, mais elles doivent être au moins 22.x.DBeaver n'est disponible que pour Windows, Mac OS X, Eclipse Plugin et Linux.
2. Décompressez le fichier à partir du télécharger le pilote JDBC.
3. Dans les fichiers décompressés, décompressez le fichier du pilote simbaSpark.zip.

Configurer DBeaver avec le pilote JDBC Spark Simba

Vous pouvez configurer DBeaver pour vous connecter à une grappe de calcul dans votre atelier de plate-forme de données Oracle AI.

Vous devez avoir installé DBeaver et extrait les fichiers simbaSpark.zip téléchargés à partir de AI Data Platform Workbench.

1. Ouvrez DBeaver.
2. Cliquez sur Navigateur de base de données.
3. Cliquez sur Gestionnaire de pilote.
4. Cliquez sur Nouveau.
5. Entrez Plate-forme de données IA dans le champ Nom du pilote.
6. Cliquez sur Bibliothèques.
7. Cliquez sur Ajouter un dossier.
8. Accédez à l'emplacement de l'extrait sparkSimba.zip.
9. Cliquez sur Rechercher une classe.
10. Sélectionnez OK.
11. Réglez la classe de pilote à com.simba.spark.jdbc.Driver.
12. Cliquez sur Paramètres.
13. Réglez le nom de la classe à com.simba.spark.jdbc.Driver.
14. Cliquez sur OK.

Créer une connexion à une base de données dans DBeaver

Pour connecter DBeaver à une grappe de calcul dans Oracle AI Data Platform Workbench, vous devez d'abord créer une connexion à la base de données dans DBeaver.

Vous devez avoir configuré DBeaver avec le pilote JDBC Simba Spark téléchargé à partir de AI Data Platform Workbench. Pour plus d'informations, voir Configurer DBeaver avec le pilote JDBC Spark Simba.

1. Ouvrez DBeaver.
2. Cliquez sur Base de données.
3. Cliquez sur Nouvelle connexion à la base de données.
4. Cliquez sur Tout.
5. Sélectionnez Plate-forme de données IA.
6. Cliquez sur Suivant.
7. Entrez l'URL du pilote JDBC. Vous pouvez trouver l'URL JDBC dans l'onglet Détails de la connexion de votre grappe de calcul dans AI Data Platform Workbench.
8. Cliquez sur Terminer.

Connecter DBeaver à Oracle AI Data Platform Workbench à l'aide de JDBC

Une fois que DBeaver est configuré et a une connexion de base de données à votre AI Data Platform Workbench, vous pouvez terminer la connexion entre DBeaver et AI Data Platform Workbench.

1. Ouvrez DBeaver.
2. Cliquez sur Se connecter.
3. Choisissez de vous connecter à l'aide d'un jeton d'autorisation ou d'une clé d'API.
   • Se connecter à l'aide d'un jeton d'autorisation
     • Utilisez un jeton en ne spécifiant aucun profil dans l'URL si vous n'avez pas de profil DEFAULT. Par exemple : jdbc:spark://gateway.aidp.me-riyadh-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/cf18b4ef-b83e-41dd-82b6-8d391584f6c5

       L'URL ouvre une fenêtre de navigateur.

       Connectez-vous à la location où l'instance AI Data Platform Workbench est créée.

       Pour plus d'informations, voir Authentification basée sur un jeton pour l'interface de ligne de commande.

   • Connectez-vous à l'aide d'une clé d'API en spécifiant le profil OCI avec ociProfile=<profile_name> dans l'URL de connexion.

     • Utilisez l'authentification par clé d'API pour vous connecter à une instance AI Data Platform Workbench.

       Utilisez la clé d'API en spécifiant le profil OCI avec ociProfile=<profile_name> dans l'URL de connexion. Par exemple, pour utiliser la démonstration du nom du profil OCI : jdbc:spark://gateway.aidp.me-riyadh-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/cf18b4ef-b83e-41dd-82b6-8d391584f6c5 ;ociProfile=Demo

       Pour plus d'informations, voir Clés et OCID requis.

4. DBeaver crée une connexion pour la lecture des métadonnées et une connexion pour toutes les autres opérations. Si vous êtes limité pour les connexions, vous pouvez désactiver la seconde afin que DBeaver utilise une connexion pour toutes les opérations.
   1. Cliquez sur Préférences.
   2. Cliquez sur Commun.
   3. Cliquez sur Métadonnées.
   4. Désélectionnez Ouvrir une connexion distincte pour les lectures de métadonnées.

Connecter Tableau à AI Data Platform à l'aide de JDBC

Vous pouvez connecter les données de votre plate-forme de données IA à Tableau pour les utiliser avec ses analyses et visualisations.

1. Naviguez jusqu'à votre espace de travail et cliquez sur Calcul.
2. Cliquez sur la grappe à laquelle vous voulez vous connecter à Tableau et cliquez sur l'onglet Détails de la connexion.
3. Cliquez sur Télécharger le pilote JDBC.
4. Extrayez les fichiers du fichier .zip téléchargé.
5. Ouvrez le dossier principal à partir des fichiers extraits et extrayez le fichier JAR Simba vers le dossier suivant en fonction de votre type de système d'exploitation :
   • Linux : /opt/tableau/tableau_driver/jdbc
   • MacOS : ~/Library/Tableau/Drivers/
   • Windows : C:\Program Files\Tableau\Driver
   Par exemple, dans MacOS, l'emplacement du fichier JAR serait ~/Library/Tableau/Drivers/SparkJDBC42.jar.
6. Ouvrez le client Tableau.
7. Dans la liste Se connecter à un serveur, recherchez des bases de données JDBC.
8. Copiez l'URL JDBC.
9. Sélectionnez SQL92 pour Dialect.
10. Authentifiez votre connexion avec l'une des méthodes suivantes :
    • Authentifier avec une clé d'API
      • Utilisez le fichier de configuration OCI par défaut et le profil par défaut. Par exemple :

        jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0

      • OU, si vous n'utilisez pas l'emplacement par défaut, ajoutez l'emplacement du fichier de configuration OCI dans l'URL JDBC de connexion. Par exemple :

        jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0;OCIConfigFile=<config_file_absolute_path>

      • OU, si vous n'utilisez pas le profil par défaut, ajoutez le profil OCI dans l'URL JDBC de la connexion. Par exemple :

        jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0;OCIConfigFile=<config_file_absolute_path>OCIProfile=<profile_name>

    • Authentifier à l'aide d'un jeton d'autorisation :
      • Pour utiliser un jeton d'autorisation, n'avez pas de fichier de configuration dans le chemin par défaut (par exemple, /Users/xyz/.oci/config) et n'indiquez aucun profil dans l'URL. Par exemple :

        jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0

      Pour plus d'informations, voir Authentification basée sur un jeton pour l'interface de ligne de commande.

11. Cliquez sur Connexion.
12. Facultatif : Si vous utilisez l'authentification basée sur un jeton, connectez-vous à la location où votre plate-forme de données d'intelligence artificielle a été créée dans la fenêtre du navigateur qui s'affiche.

Télécharger le pilote ODBC

Vous pouvez télécharger le pilote ODBC à partir de l'onglet Détails de la connexion et le configurer pour différents outils BI.

1. Naviguez jusqu'à votre espace de travail et cliquez sur Calcul.
2. Cliquez sur la grappe à laquelle vous voulez vous connecter à un outil BI compatible ODBC et cliquez sur Connexions.
3. Cliquez sur Télécharger le pilote ODBC.
4. Sélectionnez le système d'exploitation approprié dans la liste.