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 dans 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 Database.

description de l'illustration oci-orcldb.png,
Dans Filtres appliqués, sélectionnez le compartiment de création de la base de données.
Sélectionnez Create Autonomous Database (Créer une base de données Autonomous).
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 30 caractères).
description de l'illustration crtadb-dbname.png,
Sélectionnez le type de charge globale Data Warehouse.

description de l'illustration crtadb-wltype.png,
Utilisez la configuration par défaut pour la base de données.

description de l'illustration crtadb-param.png,
Définissez un mot de passe sous Création d'informations d'identification d'administrateur.

description de l'illustration crtadb-admin.png,
Sélectionnez Sécuriser l'accès à partir de n'importe quel emplacement pour le type d'accès.

description de l'illustration crtadb-network.png,
Sélectionnez le type de licence approprié. Si vous disposez de votre propre licence, activez Bring Your Own License (BYOL).

description de l'illustration crtadb-license.png,
Sélectionnez Créer.

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 de manière sécurisée à la base de données ADW, l'utilitaire utilise les informations d'identification contenues dans un 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 Database.

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 saisi lors de la création de la base de données.

description de l'illustration adb-listdb.png,
Sélectionnez Connexion à la base de données.

description de l'illustration adb-srvconsole.png,
Sélectionnez Télécharger le 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.
Fichier de clés et fichiers de truststore Java, keystore.jks et truststore.jks; protégés par le mot de passe du 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.

Une fois le fichier ZIP de portefeuille obtenu, notez son mot de passe et stockez-le dans n'importe quel environnement à partir duquel vous allez vous connecter à la base de données. En outre, 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 Oracle Cloud Compute, 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 comme 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 Database.

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 saisi lors de la création de la base de données.

description de l'illustration adb-listdb.png,
Sous Database actions (Actions de base de données), sélectionnez 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.