Répertorie les prérequis pour la création de liens de base de données à partir d'une instance Autonomous Database avec une connectivité hétérogène gérée par le client aux bases de données autres qu'Oracle qui se trouvent sur une adresse privée.

Vous pouvez créer des liens de base de données d'une instance Autonomous Database vers une instance Oracle Database Gateway afin d'accéder aux bases de données non Oracle qui se trouvent sur une adresse privée, en vous connectant avec un portefeuille (TCPS) ou sans portefeuille (TLS).

1. Sur Autonomous Database, créez des informations d'identification permettant d'accéder à la base de données cible. Les valeurs username et password que vous indiquez avec DBMS_CLOUD.CREATE_CREDENTIAL correspondent aux informations d'identification de la base de données cible utilisées dans le lien de base de données (où la base de données cible est accessible via Oracle Database Gateway).

   Vous devez indiquer le paramètre credential_name.

   Exemple :

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'DB_LINK_CRED',
       username => 'NICK',
       password => 'password'
     );
   END;
   /
   

   Les caractères du paramètre username doivent être en majuscules.

   Cette opération stocke les informations d'identification dans la base de données dans un format crypté. Vous pouvez utiliser tout nom d'informations d'identification.

2. Créez le lien de base de données vers la passerelle cible à l'aide de DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

   Exemple :

   BEGIN
        DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
             db_link_name =>       'SALESLINK', 
             hostname =>           'example.com', 
             port =>               '1522',
             service_name =>       'example_service_name',
             ssl_server_cert_dn => 'ssl_server_cert_dn',
             credential_name =>    'DB_LINK_CRED',
             directory_name =>      NULL,
             gateway_link =>        TRUE,
             private_target =>      TRUE,
             gateway_params =>      NULL);
   END;
   /

   Le paramètre ssl_server_cert_dn est facultatif si la connexion est créée en tant que lien de base de données TCP (sans portefeuille).

   Lorsque directory_name est défini sur NULL, la connexion est créée en tant que lien de base de données basé sur TCP (sans portefeuille).

   Le paramètre private_target doit être défini sur TRUE lorsque le non-Oracle Database cible se trouve sur une adresse privée (c'est-à-dire que le lien de base de données accède à un nom d'hôte qui doit être résolu dans un serveur DNS VCN). Lorsque private_target a la valeur TRUE, le paramètre hostname doit être un seul nom d'hôte (sur une adresse privée, à l'aide d'une adresse IP, d'une adresse IP SCAN ou d'un nom d'hôte SCAN n'est pas pris en charge).

   Lorsque gateway_link est défini sur TRUE et que gateway_params est défini sur NULL, cela indique que le lien de base de données est vers une passerelle Oracle gérée par le client.

   Les utilisateurs autres que l'utilisateur ADMIN nécessitent des privilèges pour exécuter DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

3. Utilisez le lien de base de données que vous avez créé pour accéder aux données de la passerelle cible.

   Par exemple :

   SELECT * FROM employees@SALESLINK;
   

BEGIN
    DBMS_CLOUD.UPDATE_CREDENTIAL (
       credential_name => 'DB_LINK_CRED',
       attribute => 'PASSWORD',
       value => 'password');
END;
/

Vous pouvez créer des liens de base de données d'une instance Autonomous Database vers une instance Oracle Database Gateway afin d'accéder aux bases de données non Oracle qui se trouvent sur une adresse privée, en vous connectant avec un portefeuille (TCPS) ou sans portefeuille (TLS).

1. Copiez le portefeuille auto-signé Oracle Database Gateway cible vers la banque d'objets. Par exemple, copiez cwallet.sso, contenant les certificats pour Oracle Database Gateway, vers la banque d'objets.

   Le fichier de portefeuille, ainsi que l'ID utilisateur et le mot de passe de la base de données, permettent d'accéder aux données disponibles via la passerelle cible. Stockez les fichiers de portefeuille dans un emplacement sécurisé. Partagez les fichiers de portefeuille uniquement avec les utilisateurs autorisés.

2. Créez des informations d'identification permettant d'accéder à la banque d'objets dans laquelle vous stockez cwallet.sso. Reportez-vous à Procédure CREATE_CREDENTIAL pour plus d'informations sur les paramètres de nom utilisateur et de mot de passe des différents services de stockage d'objet.
3. Créez un répertoire sur Autonomous Database pour le fichier de portefeuille cwallet.sso.

   Par exemple :

   CREATE DIRECTORY dblink_wallet_dir AS 'directory_path_of_your_choice';
   

   Reportez-vous à Création d'un répertoire dans Autonomous Database pour plus d'informations sur la création de répertoires.

4. Utilisez DBMS_CLOUD.GET_OBJECT pour télécharger le portefeuille auto- signé de la passerelle cible vers le répertoire créé à l'étape précédente, DBLINK_WALLET_DIR.

   Exemple :

   BEGIN 
        DBMS_CLOUD.GET_OBJECT(
           credential_name => 'DEF_CRED_NAME',
           object_uri => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/cwallet.sso',
           directory_name => 'DBLINK_WALLET_DIR'); 
   END;
   /

   Dans cet exemple, namespace-string est l'espace de noms de stockage d'objet Oracle Cloud Infrastructure et bucketname est le nom du bucket. Pour plus d'informations, reportez-vous à Présentation des espaces de noms Object Storage.

   Remarque
   
   La valeur de credential_name utilisée à cette étape correspond aux informations d'identification de la banque d'objets. A l'étape suivante, vous allez créer les informations d'identification permettant d'accéder à la passerelle cible.
5. Sur Autonomous Database, créez des informations d'identification permettant d'accéder à la base de données cible. Les valeurs username et password que vous indiquez avec DBMS_CLOUD.CREATE_CREDENTIAL correspondent aux informations d'identification de la base de données cible utilisées dans le lien de base de données (où la base de données cible est accessible via Oracle Database Gateway).

   Vous devez indiquer le paramètre credential_name.

   Exemple :

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'DB_LINK_CRED',
       username => 'NICK',
       password => 'password'
     );
   END;
   /
   

   Les caractères du paramètre username doivent être en majuscules.

   Cette opération stocke les informations d'identification dans la base de données dans un format crypté. Vous pouvez utiliser tout nom d'informations d'identification.

6. Créez le lien de base de données vers la passerelle cible à l'aide de DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

   Exemple :

   BEGIN
        DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
             db_link_name =>       'SALESLINK', 
             hostname =>           'example.com', 
             port =>               '1522',
             service_name =>       'example_service_name',
             ssl_server_cert_dn => 'ssl_server_cert_dn',
             credential_name =>    'DB_LINK_CRED',
             directory_name =>     'DBLINK_WALLET_DIR',
             gateway_link =>        TRUE,
             private_target =>      TRUE,
             gateway_params =>      NULL);
   END;
   /

   Si directory_name n'est pas NULL, un lien de base de données basé sur TCPS est créé.

   Le paramètre private_target doit être défini sur TRUE lorsque le non-Oracle Database cible se trouve sur une adresse privée (c'est-à-dire que le lien de base de données accède à un nom d'hôte qui doit être résolu dans un serveur DNS VCN). Lorsque private_target a la valeur TRUE, le paramètre hostname doit être un seul nom d'hôte (sur une adresse privée, à l'aide d'une adresse IP, d'une adresse IP SCAN ou d'un nom d'hôte SCAN n'est pas pris en charge).

   Lorsque gateway_link est défini sur TRUE et que gateway_params est défini sur NULL, cela indique que le lien de base de données est vers une passerelle Oracle gérée par le client.

   Les utilisateurs autres que l'utilisateur ADMIN nécessitent des privilèges pour exécuter DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

7. Utilisez le lien de base de données que vous avez créé pour accéder aux données de la passerelle cible.

   Exemple :

   SELECT * FROM employees@SALESLINK;
   

BEGIN
    DBMS_CLOUD.UPDATE_CREDENTIAL (
       credential_name => 'DB_LINK_CRED',
       attribute => 'PASSWORD',
       value => 'password');
END;
/