Accès à Oracle Cloud Autonomous Data Warehouse

Création d'une base de données dans Autonomous Data Warehouse

Vous devez créer une base de données pour accéder à Oracle Cloud Autonomous Data Warehouse à partir d'Oracle NoSQL Database Analytics Integrator. Pour créer une base de données sur Oracle Cloud Autonomous Data Warehouse, accédez à la console Oracle Cloud et procédez comme suit :

Sélectionnez Oracle Database dans le menu situé à gauche de l'affichage.
Sélectionnez Autonomous Data Warehouse.

Description de l'illustration oci-orcldb.png
Sélectionnez le compartiment dans lequel créer la base de données.
Cliquez sur Créer une base de données autonome.
Saisissez les informations de base sur Autonomous Database. Par exemple :
- Compartiment : entrez le nom de compartiment sélectionné ci-dessus.
- Nom d'affichage : nom à afficher sur la console ; par exemple, NoSqlToAdwDb.
- Nom de la base de données : nom à utiliser lors de la connexion à la base de données, par exemple. NoSqlToAdwDb (ne peut pas comporter plus de 14 caractères).
Description de l'illustration crtadb-dbname.png
Choisissez le type de charge globale de l'entrepôt de données.
Sélectionnez le type de déploiement Infrastructure partagée.

Description de l'illustration crtadb-wltype.png
Choisissez la configuration par défaut de la base de données.

Description de l'illustration crtadb-param.png
Définissez un mot de passe sous Créer des informations d'identification d'administrateur.

Description de l'illustration crtadb-admin.png
Choisissez Autoriser l'accès sécurisé à partir de n'importe quel emplacement pour Type d'accès.
Choisissez le type de licence approprié. Si vous disposez de votre propre licence, choisissez Bring Your Own License (BYOL).
Cliquez sur Créer une base de données autonome.

Description de l'illustration crtadb-network.png

Rubriques connexes

Génération d'un jeton d'autorisation pour Object Storage

Installer les informations d'identification requises pour une connexion sécurisée à une base de données

Les connexions à la base de données que vous avez créée dans Autonomous Data Warehouse doivent être sécurisées. Pour qu'Oracle NoSQL Database Analytics Integrator se connecte en toute sécurité à la base de données ADW, l'utilitaire utilise les informations d'identification contenues dans un portefeuille Oracle Wallet.

Pour obtenir Oracle Wallet, accédez à la console Oracle Cloud et procédez comme suit :

Sélectionnez Oracle Database dans le menu situé à gauche de l'affichage.
Sélectionnez Autonomous Data Warehouse.

Description de l'illustration oci-orcldb.png
Sélectionnez le compartiment dans lequel se trouve la base de données.
Cliquez sur le lien avec le nom d'affichage que vous avez saisi lors de la création de la base de données.

Description de l'illustration adb-listdb.png
Cliquez sur Console de service.

Description de l'illustration adb-srvconsole.png
Cliquez sur le lien Administration à gauche de l'affichage.
Sélectionnez Télécharger les informations d'identification client (portefeuille) et entrez le mot de passe d'administration défini lors de la création de la base de données.

Description de l'illustration adb-adminstration.png
Enregistrez le fichier (zip) dans un emplacement sûr.

Le fichier ZIP généré inclut 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 SSO ouvert automatiquement, cwallet.sso.
Fichier PKCS12, ewallet.p12 protégé par le mot de passe de portefeuille que vous avez fourni lors du téléchargement du fichier ZIP via la console Oracle Cloud.
Fichiers de clés et de trustore Java, keystore.js et truststore.jks; protégés par le mot de passe de portefeuille.
Fichier ojdbc.properties, qui indique la propriété système Java liée au portefeuille requise pour la connexion à la base de données via 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. Par ailleurs, pour utiliser Oracle NoSQL Database Analytics Integrator, le contenu extrait du fichier ZIP de portefeuille doit être installé dans l'environnement dans lequel vous allez exécuter 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.

Activation des informations d'identification du principal de ressource ou stockage/activation de AUTH_TOKEN Object Storage de l'utilisateur dans la base de données ADW

Après avoir extrait les données de la table NoSQL Cloud Service souhaitée et écrit ces données dans des fichiers Parquet dans Object Storage, Oracle NoSQL Database Analytics Integrator utilise des sous-programmes du package PL/SQL DBMS_CLOUD Oracle pour extraire les fichiers Parquet d'Object Storage. 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 Cloud Autonomous Data Warehouse.

Pour que l'intégrateur d'analyses Oracle NoSQL Database puisse effectuer cette opération, vous devez fournir un moyen pour la base de données ADW de s'authentifier auprès d'Object Storage afin d'accéder à ces fichiers Parquet. La base de données ADW peut s'authentifier auprès du service Object Storage de deux manières : à l'aide du principal de ressource OCI ou d'un AUTH_TOKEN propre à l'utilisateur que vous ou l'administrateur 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 Database dans le menu situé à gauche de l'affichage.
Sélectionnez Autonomous Data Warehouse.

Description de l'illustration oci-orcldb.png
Sélectionnez le compartiment dans lequel se trouve la base de données.
Cliquez sur le lien avec le nom d'affichage que vous avez saisi lors de la création de la base de données.

Description de l'illustration adb-listdb.png
Cliquez sur Console de service.

Description de l'illustration adb-srvconsole.png
Sélectionnez Development (Développement) dans le menu situé à gauche de l'affichage.

Description de l'illustration adb-development.png
Sélectionnez Database Actions et connectez-vous à la base de données, par exemple :
- Nom utilisateur : ADMIN
- Mot de passe : <password-set-during-database-creation>
Description de l'illustration dbactions-login.png
Sélectionnez l'élément SQL.

Description de l'illustration dbactions-sqlsheet.png
Dans la fenêtre intitulée [Worksheet]*, si vous souhaitez authentifier la base de données ADW avec Object Storage à l'aide du principal de ressource, exécutez la procédure suivante.
```
EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();
```
Description de l'illustration dbactions-resource-principal.png
Sinon, si vous souhaitez effectuer l'authentification à l'aide du fichier AUTH_TOKEN que l'administrateur 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 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 ADW lors de l'authentification auprès d'une ressource OCI telle qu'Object Storage. La procédure DBMS_CLOUD.CREATE_CREDENTIAL crypte les informations d'identification AUTH_TOKEN indiqué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 utilisez, cette procédure ne doit être exécutée qu'une seule fois, après quoi le même nom d'informations d'identification peut être indiqué pour tous les transferts d'Object Storage vers la base de données ADW.

Remarques :

Lorsque la base de données ADW utilise le principal de ressource OCI pour s'authentifier auprès d'Object Storage, le nom des informations d'identification est OCI$RESOURCE_PRINCIPAL. Sinon, lors de l'utilisation de AUTH_TOKEN pour l'authentification auprès d'Object Storage, le nom des informations d'identification est la valeur que vous indiquez pour le paramètre credential_name dans la procédure DBMS_CLOUD.CREATE_CREDENTIAL. Notez toutefois que la valeur indiquée ci-dessus (NOSQLADWDB_OBJ_STORE_CREDENTIAL) n'est qu'un exemple. Vous pouvez utiliser le nom de votre choix. Par conséquent, le paramètre dbmsCredentialName du fichier de configuration doit contenir la valeur OCI$RESOURCE_PRINCIPAL ou le nom indiqué ici pour le paramètre credential_name, en fonction du mécanisme d'authentification que vous choisissez d'utiliser pour authentifier la base de données ADW avec Object Storage.