10Connexion à Compute

Cette section traite de la connexion du calcul dans AI Data Platform Workbench à d'autres outils décisionnels.

Connexions

Vous pouvez connecter AI Data Platform Workbench à Oracle Analytics Cloud ou à d'autres outils décisionnels.

Vous pouvez vous connecter à Oracle AI Data Platform Workbench à partir de différents outils décisionnels à l'aide d'un JDBC ou 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 du cluster de calcul dans AI Data Platform Workbench, que vous pouvez trouver dans l'onglet Détails de connexion. Les informations requises varient en fonction du produit à partir duquel vous êtes connecté.


Onglet Détails de connexion pour le cluster de calcul Dev_cluster_1

Connexion d'Oracle Analytics à Oracle AI Data Platform Workbench

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

Pour créer une connexion d'Oracle Analytics au workbench AI Data Platform, vous avez besoin d'un fichier de connexion de AI Data Platform et d'une clé d'API d'Oracle Analytics Cloud.

Obtention d'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'un cluster de calcul avec au moins 2 OCPU, 32 Go de mémoire pour les noeuds de processus actif et de pilote, et au moins 2 processus actifs.
  1. Accédez à votre espace de travail et cliquez sur Compute.

    Page de calcul ouverte avec cluster de calcul Cluster_High en surbrillance

  2. Cliquez sur le cluster auquel vous connecter à Oracle Analytics.
  3. Dans l'onglet Détails de 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.

    Page de calcul pour le cluster Cluster_High ouverte avec l'onglet Détails de connexion et téléchargement d'Oracle Analytics Cloud mis en évidence

Connexion à Oracle Analytics

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

Assurez-vous que vous disposez d'un fichier de configuration de connexion à partir de AI Data Platform avant de créer la connexion dans Oracle Analytics. Reportez-vous à Obtention d'un fichier de configuration de connexion Oracle Analytics.
Les connexions Oracle Analytics aux instances du pupitre AI Data Platform ne prennent en charge qu'un catalogue par connexion. Vous devez créer des connexions supplémentaires pour utiliser plusieurs catalogues.
  1. Sur la page d'accueil d'Oracle Analytics, cliquez sur Créer, puis sur Connexion.
  2. Cliquez sur Plate-forme de données Oracle AI.
  3. Entrez le nom et la description de la connexion.
  4. Dans Emplacement, indiquez où enregistrer la connexion. Pour partager la connexion avec d'autres utilisateurs, enregistrez-la dans /Dossiers partagés.
  5. Dans Oracle Analytics Cloud, pour les détails de connexion, cliquez sur Sélectionner, accédez à votre fichier config.json et cliquez sur Ouvrir.
  6. Sélectionnez Clé d'API comme type d'authentification.
  7. Sous Clé d'API publique, cliquez sur Générer, puis sur Copier.
  8. Dans OCI, ajoutez une clé d'API.
    1. Dans OCI, cliquez sur l'icône utilisateur, puis sur Paramètres d'utilisateur.
    2. Dans Mon profil, cliquez sur Jetons et clés, puis sur Ajouter une clé d'API.
    3. Sélectionnez Coller une clé publique, puis copiez la clé que vous avez générée à l'étape 7, puis cliquez sur Ajouter.
    Attendez deux à trois minutes que la clé d'API se synchronise.
  9. Dans Catalogue, indiquez le nom du catalogue à utiliser dans vos jeux de données.
    Si la liste Catalogue ne se charge pas et que le message d'alerte "L'utilisateur ne dispose pas de privilèges suffisants pour effectuer l'opération" s'affiche, attendez un peu plus longtemps que la clé d'API soit synchronisée.
  10. Cliquez sur Enregistrer.
  11. Testez votre nouvelle connexion en créant un ensemble de données.

Si vous avez suivi les instructions et que vous avez toujours rencontré des problèmes lors de l'enregistrement de votre connexion ou de la liste de vos schémas, un redémarrage de cluster 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 connexion et le configurer pour différents outils BI.

  1. Accédez à votre espace de travail et cliquez sur Compute.
  2. Cliquez sur le cluster auquel vous voulez vous connecter à un outil BI compatible JDBC, puis sur Connexions.
  3. Cliquez sur Télécharger le chauffeur JDBC.

Configuration de 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 à un cluster de calcul dans AI Data Platform Workbench.

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

Configuration de DBeaver avec le pilote JDBC Simba Spark

Vous pouvez configurer DBeaver pour qu'il se connecte à un cluster de calcul dans Oracle AI Data Platform Workbench.

Vous devez avoir installé DBeaver et extrait les fichiers simbaSpark.zip téléchargés à partir d'AI Data Platform Workbench.
  1. Ouvrez DBeaver.
  2. Cliquez sur Navigateur de base de données.
  3. Cliquez sur Gestionnaire de pilotes.
  4. Cliquez sur Nouveau.
  5. Entrez Plate-forme de données AI dans le champ Nom de l'inducteur.
  6. Cliquez sur Bibliothèques.
  7. Cliquez sur Ajouter un dossier.
  8. Accédez à l'emplacement de l'extraction sparkSimba.zip.
  9. Cliquez sur Rechercher une classe.
  10. Sélectionnez OK.
  11. Définissez la classe de pilote sur com.simba.spark.jdbc.Driver.
  12. Cliquez sur Paramètres.
  13. Définissez le nom de classe sur com.simba.spark.jdbc.Driver.
  14. Cliquez sur OK.

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

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

Vous devez avoir configuré DBeaver avec le pilote JDBC Simba Spark téléchargé à partir d'AI Data Platform Workbench. Pour plus d'informations, reportez-vous à Configuration de DBeaver avec le pilote JDBC Simba Spark.
  1. Ouvrez DBeaver.
  2. Cliquez sur Base de données.
  3. Cliquez sur Nouvelle connexion de base de données.
  4. Cliquez sur Tous.
  5. Sélectionnez Plate-forme de données AI.
  6. Cliquez sur Suivant.
  7. Entrez l'URL du pilote JDBC. Vous pouvez trouver l'URL JDBC dans l'onglet Détails de connexion de votre cluster 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 dispose d'une connexion de base de données à AI Data Platform Workbench, vous pouvez établir la connexion entre DBeaver et AI Data Platform Workbench.

  1. Ouvrez DBeaver.
  2. Cliquez sur Connexion.
  3. Choisissez de vous connecter à l'aide d'un jeton d'autorisation ou d'une clé d'API.
    • Connexion à l'aide du 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 dans laquelle l'instance AI Data Platform Workbench est créée.

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

    • Connectez-vous à l'aide d'une clé d'API en indiquant 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 indiquant le profil OCI avec ociProfile=<profile_name> dans l'URL de connexion. Par exemple, pour utiliser le nom de profil OCI Demo : 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, reportez-vous à 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 les connexions sont limitées, vous pouvez désactiver la seconde pour que DBeaver utilise une seule connexion pour toutes les opérations.
    1. Cliquez sur Préférences.
    2. Cliquez sur Common.
    3. Cliquez sur Métadonnées.
    4. Désélectionnez Ouvrir une connexion distincte pour les lectures de métadonnées.

Télécharger le pilote ODBC

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

  1. Accédez à votre espace de travail et cliquez sur Compute.
  2. Cliquez sur le cluster auquel vous voulez vous connecter à un outil BI compatible ODBC, puis sur Connexions.
  3. Cliquez sur Télécharger le pilotes ODBC.
  4. Sélectionnez le système d'exploitation approprié dans la liste.

    Liste déroulante ODBC Driver OS ouverte avec les options Mac, Windows et Linx affichées