Accès à Oracle Autonomous AI Lakehouse

Étapes pour accéder à Oracle Autonomous AI Lakehouse à partir d'Oracle NoSQL Database Analytics Integrator.

Créer une base de données dans Oracle Autonomous AI Lakehouse

Vous devez créer une base de données pour accéder à Oracle Autonomous AI Lakehouse à partir de l'intégrateur d'analyses d'Oracle NoSQL Database. Pour créer une base de données dans Oracle Autonomous AI Lakehouse, allez à la console Oracle Cloud et effectuez les opérations suivantes :

Rubriques connexes

Installer les données d'identification nécessaires pour établir une connexion sécurisée à la base de

Les connexions à la base de données que vous avez créée dans Oracle Autonomous AI Lakehouse doivent être sécurisées. Pour que l'intégrateur Oracle NoSQL Database Analytics puisse se connecter en toute sécurité à la base de données Oracle Autonomous AI Lakehouse, l'utilitaire utilise les données d'identification contenues dans un portefeuille Oracle Wallet.

Pour obtenir Oracle Wallet, allez à la console Oracle Cloud et effectuez les opérations suivantes :
Le fichier zip produit comprend les éléments suivants :
  • Les fichiers de configuration réseau (tnsnames.ora et sqlnet.ora) nécessaires pour se connecter à la base de données.
  • Fichier de portefeuille d'authentification unique à ouverture automatique, cwallet.SSO.
  • Le fichier PKCS12, ewallet.p12, qui est protégé par le mot de passe de portefeuille que vous avez fourni lorsque vous avez téléchargé le fichier zip au moyen de la console Oracle Cloud.
  • Magasin de clés Java et fichiers de banque de certificats SSL, keystore.jks et truststore.jks; protégés par le mot de passe du portefeuille.
  • Le fichier ojdbc.properties, qui spécifie la propriété de système Java liée au portefeuille requise pour la connexion à la base de données au moyen de JDBC.
  • Fichier README contenant les informations d'expiration du portefeuille.

Après avoir obtenu le fichier zip de portefeuille, notez le mot de passe et stockez le portefeuille dans n'importe quel environnement à partir duquel vous allez vous connecter à la base de données. De plus, pour utiliser l'intégrateur d'analyses d'Oracle NoSQL Database, le contenu extrait du fichier zip de portefeuille doit être installé dans l'environnement dans lequel vous exécuterez l'utilitaire. Par exemple, si vous exécutez l'utilitaire à partir d'une instance de calcul Oracle Cloud, vous devez extraire le contenu du fichier zip dans n'importe quel répertoire de cette instance. Utilisez ensuite le chemin d'accès à ce répertoire en tant que valeur du paramètre databaseWallet dans la section de base de données du fichier de configuration de l'utilitaire.

Activer les données d'identification du principal de ressource ou stocker/activer le stockage d'objets de l'utilisateur AUTH_TOKEN dans la base de données Oracle Autonomous AI Lakehouse

Après avoir extrait les données de la table Cloud Service NoSQL souhaitée et écrit ces données dans les fichiers Parquet du service de stockage d'objets, Oracle NoSQL Database Analytics Integrator utilise des sous-programmes de l'ensemble Oracle PL/SQL DBMS_CLOUD pour extraire les fichiers Parquet du service de stockage d'objets. Il charge ensuite les données contenues dans ces fichiers dans une table de la base de données que vous avez créée dans Oracle Autonomous AI Lakehouse.

Pour que l'intégrateur d'analyse d'Oracle NoSQL Database puisse faire cela, vous devez fournir un moyen à la base de données Oracle Autonomous AI Lakehouse de s'authentifier avec le service de stockage d'objets pour accéder à ces fichiers Parquet. La base de données Oracle Autonomous AI Lakehouse peut s'authentifier avec le service de stockage d'objets de l'une des deux façons suivantes : à l'aide du principal de ressource OCI ou d'un AUTH_TOKEN propre à l'utilisateur que vous ou l'administrateur de système générez. Le mécanisme d'authentification que vous décidez d'utiliser est activé en exécutant les étapes suivantes à partir de la console Oracle Cloud.
  • Sélectionnez Oracle AI Database dans le menu de gauche de l'affichage.
  • Sélectionnez Autonomous AI Database.
    Description d'oci-orcldb.png :
    Description de l'illustration oci-orcldb.png

  • Dans Filtres appliqués, sélectionnez le compartiment dans lequel se trouve la base de données.
  • Sélectionnez le lien avec le nom d'affichage que vous avez entré lors de la création de la base de données.
    Description d'adb-listdb.png :
    Description de l'illustration adb-listdb.png

  • Sous Actions de base de données, sélectionnez SQL.
  • Dans la fenêtre étiquetée [Feuille de calcul]*, si vous souhaitez authentifier la base de données Oracle Autonomous AI Lakehouse avec le service de stockage d'objets à l'aide du principal de ressource, exécutez la procédure suivante.
    EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();

    Description de dbactions-resource-principal.png :
    Description de l'illustration dbactions-resource-principal.png

    Sinon, si vous souhaitez effectuer l'authentification à l'aide de AUTH_TOKEN que l'administrateur de système vous a fourni ou que vous avez généré vous-même, exécutez la procédure,

    BEGIN
DBMS_CLOUD.CREATE_CREDENTIAL (
credential_name => 'NOSQLADWDB_OBJ_STORE_CREDENTIAL',
username => '<your-Oracle-Cloud-username>',
password => '<cut-and-paste-the-AUTH_TOKEN>'
);
END;

    Description de dbactions-worksheet.png :
    Description de l'illustration dbactions-worksheet.png

La procédure DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL active le principal de ressource OCI (nommé OCI$RESOURCE_PRINCIPAL) à utiliser par la base de données Oracle Autonomous AI Lakehouse lors de l'authentification auprès d'une ressource OCI telle que le stockage d'objets. La procédure DBMS_CLOUD.CREATE_CREDENTIAL chiffre les données d'identification AUTH_TOKEN spécifiées et les stocke dans une table de la base de données nommée adwc_user. Quelle que soit la procédure que vous employez, cette procédure doit être exécutée une seule fois; après quoi le même nom de données d'identification peut être spécifié pour tous les transferts du service de stockage d'objets vers la base de données Oracle Autonomous AI Lakehouse.

Note :

Lorsque la base de données Oracle Autonomous AI Lakehouse utilise le principal de ressource OCI pour s'authentifier auprès du service de stockage d'objets, le nom des données d'identification est OCI$RESOURCE_PRINCIPAL. Sinon, lors de l'utilisation de AUTH_TOKEN pour l'authentification auprès du service de stockage d'objets, le nom des données d'identification est la valeur que vous spécifiez pour le paramètre credential_name dans la procédure DBMS_CLOUD.CREATE_CREDENTIAL. Mais notez que la valeur indiquée ci-dessus (NOSQLADWDB_OBJ_STORE_CREDENTIAL) n'est qu'un exemple. Vous pouvez utiliser n'importe quel nom que vous souhaitez. Ainsi, le paramètre dbmsCredentialName dans le fichier de configuration doit contenir la valeur OCI$RESOURCE_PRINCIPAL ou le nom que vous spécifiez ici pour le paramètre credential_name; selon le mécanisme d'authentification que vous choisissez d'utiliser pour authentifier la base de données Oracle Autonomous AI Lakehouse avec le stockage d'objets.