Connexion à Compute

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

Rubriques :

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 à 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 à Oracle AI Data Platform Workbench, vous devez effectuer les opérations suivantes :

  1. Obtention d'une clé d'API à partir d'OCI.
  2. Obtention d'un fichier de configuration de connexion Oracle Analytics.
  3. Combinez la clé d'API et le fichier de configuration pour créer la connexion. Reportez-vous à Création d'un fichier de connexion Oracle Analytics.
  4. Utilisez la connexion dans Oracle Analytics Cloud. Reportez-vous à Connexion d'Oracle AI Data Platform Workbench à Oracle Analytics.

Vous pouvez effectuer les étapes 1 et 2 dans n'importe quel ordre, mais elles doivent toutes deux être effectué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 droits d'accès appropriés aux tables de votre pupitre AI Data Platform auxquelles vous souhaitez accéder à partir d'Oracle Analytics. Générez la clé d'API requise dans OCI et téléchargez le fichier PEM pour l'utilisateur créé à cette fin.

Remarques :

  • Pour vous connecter à AI Data Platform Workbench à partir d'Oracle Analytics, vous devez indiquer 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 corrects dans le cluster AI Data Platform.
  • Cette exigence sera allégée dans une prochaine version.

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

Vous avez besoin d'une clé d'API à partir d'OCI pour un utilisateur ayant accès à Oracle AI Data Platform Workbench 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 droits d'accès administrateur pour l'instance. Vous devez également avoir un cluster AI Data Platform Workbench valide dans l'instance.
  1. Dans OCI, cliquez sur l'icône utilisateur, puis sur Paramètres d'utilisateur.

    Page d'accueil OCI avec profil utilisateur ouvert et paramètres utilisateur mis en évidence

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

    Profil utilisateur OCI ouvert avec nom utilisateur, clés d'API et ajout de clés d'API mis en évidence

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

    Page Ajouter une clé d'API ouverte avec l'option Générer une paire de clés d'API sélectionnée et télécharger la clé privée mise en évidence

  4. Cliquez sur Ajouter.
Enregistrez la clé privée (fichier .pem) que vous recevez dans un emplacement sécurisé et persistant. Il est requis pour les connexions et ne peut être téléchargé qu'une seule fois. Ce fichier est utilisé comme empreinte lors de la connexion d'Oracle Analytics à AI Data Platform Workbench.

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

La paire de valeurs de clé d'empreinte est manquante dans le fichier config.json que vous avez téléchargé. Il doit être combiné avec la valeur de clé d'empreinte d'une clé d'API appartenant à un utilisateur OCI qui a créé AI Data Platform Workbench ou à un utilisateur disposant de droits d'accès d'administration.
Contenu du fichier config.json, notamment nom utilisateur, location, région et dsn

Création d'un fichier de connexion Oracle Analytics

Vous devez ajouter manuellement la paire de valeurs de clé d'empreinte au fichier config.json téléchargé à partir d'Oracle AI Data Platform Workbench 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 de droits d'accès administrateur pour l'instance. Vous devez également avoir téléchargé le fichier config.json à partir du cluster auquel vous souhaitez vous connecter à Oracle Analytics.
  1. Ouvrez le fichier config.json et le fichier de configuration de la clé API.
  2. Modifiez config.json pour ajouter la valeur d'empreinte à partir du fichier de configuration de clé d'API.

    Clé d'API avec l'utilisateur, l'empreinte, la location et la région en surbrillance et la copie en surbrillance

  3. Enregistrez les modifications apportées au fichier config.json.

    Fichier config.json ouvert avec la paire de clés d'empreinte digitale incluse

Dans une prochaine version, config.json inclura l'empreinte de la clé publique de la clé d'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.

Connectez Oracle AI Data Platform Workbench à 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.

Les connexions 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. Sur la page d'accueil d'Oracle Analytics, cliquez sur Créer, puis sur Connexion.

    Page d'accueil d'Oracle Analytics avec création et connexion mises en évidence

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

    Boîte de dialogue Créer une connexion ouverte avec la plate-forme de données Oracle AI mise en évidence

  3. Entrez le nom et la description de la connexion.

    Créer une connexion pour Oracle AI Data Platform ouverte avec les détails de connexion, le catalogue et la clé d'API privée mis en évidence

  4. Pour les détails de connexion, cliquez sur Sélectionner, accédez à votre fichier config.json et cliquez sur Ouvrir. Pour plus d'informations, reportez-vous à Création d'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 une clé d'API privée, cliquez sur Sélectionner et accédez à votre clé d'API privée (. Fichier PEM), puis cliquez sur Ouvrir. Pour plus d'informations, reportez-vous à Obtention d'une clé d'API auprès d'OCI.
  8. Cliquez sur Enregistrer.
  9. Testez votre nouvelle connexion en créant un ensemble de données. Pour plus d'informations, reportez-vous à Création d'un ensemble de données à partir d'une connexion.

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.

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

Vous pouvez connecter les données de votre plateforme de données d'IA à Tableau pour les utiliser avec ses analyses et ses visualisations.

  1. Accédez à votre espace de travail et cliquez sur Compute.
  2. Cliquez sur le cluster auquel vous voulez vous connecter à Tableau et sur l'onglet Détails de 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 du 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 est ~/Library/Tableau/Drivers/SparkJDBC42.jar.
  6. Ouvrez le client Tableau.
  7. Dans la liste Se connecter à un serveur, recherchez les bases de données JDBC.
  8. Copiez l'URL JDBC.
  9. Sélectionnez SQL92 pour Dialect.
  10. Authentifiez votre connexion à l'aide de 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. 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 à la fin de l'URL JDBC de connexion. 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 à la fin de l'URL JDBC de connexion. 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>
    • Authentifiez-vous à 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. 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, reportez-vous à Authentification basée sur un jeton pour l'interface de ligne de commande.

  11. Cliquez sur Connexion.
  12. Facultatif : si vous utilisez l'authentification par jeton, connectez-vous à la location dans laquelle votre plate-forme de données AI a été créée dans la fenêtre de navigateur qui apparaît.

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