Création de liens de base de données à partir d'une base de données Autonomous AI vers une base de données Oracle AI Database sur une adresse privée

Vous pouvez créer des liens de base de données à partir d'une base de données Autonomous AI vers une base de données Oracle AI Database cible qui se trouve sur une adresse privée.

Selon le type et la configuration de la base de données Oracle AI Database cible :

Autre base de données Oracle AI Database, telle qu'une base de données sur site ou Database Cloud Service, sur une adresse privée configurée pour SSL (TCPS) : dans ce cas, vous pouvez créer le lien de base de données avec un portefeuille et le lien de base de données communique avec TCPS. Pour plus de détails, reportez-vous à Création de liens de base de données à partir d'une base de données Autonomous AI vers des bases de données Oracle AI sur une adresse privée avec un portefeuille (mTLS) :
Oracle AI Database, comme une base de données sur site ou Database Cloud Service, sur une adresse privée configurée pour TCP : dans ce cas, vous créez le lien de base de données sans portefeuille et le lien de base de données communique avec TCP. Pour plus de détails, reportez-vous à Création de liens de base de données vers des bases de données Oracle AI sur une adresse privée sans portefeuille.

Pour plus d'informations, reportez-vous à Création d'un lien de base de données à partir de votre base de données Autonomous AI vers une instance Database Cloud Service.

Prérequis

Répertorie les prérequis pour créer des liens de base de données à partir d'une base de données Autonomous AI vers une base de données Oracle AI Database cible située sur une adresse privée.

Pour créer un lien de base de données vers une base de données Oracle AI Database cible sur une adresse privée, procédez comme suit :

La base de données cible doit être accessible à partir du VCN Oracle Cloud Infrastructure de la base de données source. Par exemple, vous pouvez vous connecter à la base de données cible lorsque :
- La base de données cible se trouve sur une adresse privée.
- La base de données source et la base de données cible se trouvent toutes deux dans le même VCN Oracle Cloud Infrastructure.
- La base de données source et la base de données cible se trouvent dans différents réseaux cloud virtuels Oracle Cloud Infrastructure associés.
- La base de données cible est une base de données sur site connectée à l'Oracle Cloud Infrastructure VCN de la base de données source à l'aide de FastConnect ou du VPN.
Deux options permettent d'indiquer la base de données cible, à savoir le paramètre hostname ou le paramètre rac_hostnames :
- Pour une cible sur une adresse privée, DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK prend en charge la spécification d'un nom d'hôte unique avec le paramètre hostname. Sur une adresse privée, l'utilisation d'une adresse IP, d'une adresse IP SCAN ou d'un nom d'hôte SCAN n'est pas prise en charge (lorsque la cible se trouve sur une adresse publique, CREATE_DATABASE_LINK prend en charge l'utilisation d'une adresse IP, d'une adresse IP SCAN ou d'un nom d'hôte SCAN).
- Lorsque la cible est une base de données Oracle RAC, utilisez le paramètre rac_hostnames pour indiquer des noms d'hôte avec DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK. Vous pouvez ainsi tirer parti des fonctionnalités de haute disponibilité d'Oracle RAC. L'utilisation d'une adresse IP, d'une IP SCAN ou d'un nom d'hôte SCAN dans la valeur rac_hostnames n'est pas prise en charge.
  
  Lorsque vous indiquez une liste de noms d'hôte dans le paramètre rac_hostnames, CREATE_DATABASE_LINK utilise tous les noms d'hôte indiqués comme adresses dans la chaîne de connexion. Si l'un des hôtes indiqués n'est pas disponible sur la base de données Oracle RAC cible, la base de données Autonomous AI tente automatiquement de se connecter en utilisant un autre nom d'hôte de la liste.
Les règles entrantes et sortantes suivantes doivent être définies pour l'adresse privée :
- Définissez une règle sortante dans la liste de sécurité de sous-réseau ou le groupe de sécurité réseau de la base de données source de sorte que le trafic sur TCP soit autorisé vers l'adresse IP et le numéro de port de la base de données cible.
- Définissez une règle entrante dans la liste de sécurité de sous-réseau ou le groupe de sécurité réseau de la base de données cible de sorte que le trafic sur TCP soit autorisé à partir de l'adresse IP de la base de données source vers le port de destination.
Pour plus d'informations sur la configuration des adresses privées avec des règles entrantes et sortantes, reportez-vous à Configuration de l'accès réseau avec des adresses privées.

Remarque

Remarque : lorsque votre instance de base de données Autonomous AI est configurée avec une adresse privée, définissez la propriété de base de données ROUTE_OUTBOUND_CONNECTIONS pour indiquer que tous les liens de base de données sortants sont soumis aux règles sortantes du VCN de l'adresse privée de l'instance de base de données Autonomous AI. Pour plus d'informations, reportez-vous à Sécurité améliorée pour les connexions sortantes avec des adresses privées.

Création de liens de base de données vers des bases de données Oracle AI sur une adresse privée sans portefeuille

Utilisez DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK pour créer des liens de base de données à partir d'une base de données Autonomous AI vers une base de données Oracle AI Database cible qui se trouve sur une adresse privée et qui se connecte sans portefeuille (TCP).

Remarque

Remarque : cette option concerne les bases de données Oracle AI cible qui se trouvent sur une adresse privée et pour lesquelles SSL/TCPS n'est pas configuré.

Effectuez les étapes prérequises, le cas échéant. Pour plus de détails, reportez-vous à Prérequis pour les liens de base de données d'une base de données Autonomous AI vers des bases de données Oracle AI sur une adresse privée.

Pour créer un lien de base de données vers une base de données cible sur une adresse privée à l'aide d'une connexion TCP sécurisée sans portefeuille, procédez comme suit :

Sur la base de données Autonomous AI, créez des informations d'identification pour accéder à la base de données cible. Les informations d'identification username et password que vous indiquez avec DBMS_CLOUD.CREATE_CREDENTIAL sont celles de la base de données cible utilisée dans le lien de base de données (où la base de données cible est accessible via le VCN).

Par exemple :
```
BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'PRIVATE_ENDPOINT_CRED',
    username => 'NICK',
    password => 'password'
  );
END;
/
```
Les caractères du paramètre username doivent être en majuscules.

Remarque

Remarque : vous pouvez utiliser des informations d'identification de clé secrète de coffre pour les informations d'identification de base de données cible dans un lien de base de données. Pour plus d'informations, reportez-vous à Utilisation des informations d'identification de clé secrète de coffre.

Cette opération stocke les informations d'identification dans la base de données dans un format crypté. Vous pouvez utiliser n'importe quel nom d'informations d'identification.
Créez le lien de base de données vers la base de données cible à l'aide de DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

Par exemple :
```
BEGIN
  DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
    db_link_name => 'PRIVATE_ENDPOINT_LINK',
    hostname => 'exampleHostname',
    port => '1522',
    service_name => '*exampleServiceName*',
    ssl_server_cert_dn => NULL,
    credential_name => 'PRIVATE_ENDPOINT_CRED',
    directory_name => NULL,
    private_target => TRUE
  );
END;
/
```
Pour une cible sur une adresse privée, DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK prend en charge la spécification d'un nom d'hôte unique avec le paramètre hostname. Sur une adresse privée, l'utilisation d'une adresse IP, d'une adresse IP SCAN ou d'un nom d'hôte SCAN n'est pas prise en charge (lorsque la cible se trouve sur une adresse publique, CREATE_DATABASE_LINK prend en charge l'utilisation d'une adresse IP, d'une adresse IP SCAN ou d'un nom d'hôte SCAN).

Lorsque la cible est une base de données Oracle RAC, utilisez le paramètre rac_hostnames pour indiquer des noms d'hôte avec DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK. Vous pouvez ainsi tirer parti des fonctionnalités de haute disponibilité d'Oracle RAC. L'utilisation d'une adresse IP, d'une IP SCAN ou d'un nom d'hôte SCAN dans la valeur rac_hostnames n'est pas prise en charge.

Par exemple, avec une base de données Oracle RAC cible, utilisez le paramètre rac_hostnames :
```
BEGIN
     DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
         db_link_name => 'PRIVATE_ENDPOINT_LINK',
         rac_hostnames => '["sales1-svr1.example.adb.us-ashburn-1.oraclecloud.com",
                            "sales1-svr2.example.adb.us-ashburn-1.oraclecloud.com",
                            "sales1-svr3.example.adb.us-ashburn-1.oraclecloud.com"]',
         port => '1522',
         service_name => '*exampleServiceName*',
         ssl_server_cert_dn => NULL,
         credential_name => 'PRIVATE_ENDPOINT_CRED',
         directory_name => NULL,
         private_target => TRUE);
END;
/
```
DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK ne prend pas en charge la valeur localhost pour hostname ou dans le paramètre rac_hostnames.

Les utilisateurs autres qu'ADMIN ont besoin de privilèges pour exécuter DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

Comme indiqué dans l'exemple, pour créer un lien de base de données avec DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK vers une base de données cible sur une adresse privée à l'aide d'une connexion TCP sécurisée sans portefeuille, les éléments suivants sont requis :
- Le paramètre directory_name doit être NULL.
- Le paramètre ssl_server_cert_dn doit être NULL.
- Le paramètre private_target doit être TRUE.
  
  Remarque
  
  Remarque : si vous définissez la propriété de base de données ROUTE_OUTBOUND_CONNECTIONS, il n'est pas nécessaire de définir le paramètre private_target sur TRUE dans cette API. Pour plus d'informations, reportez-vous à Sécurité améliorée pour les connexions sortantes avec des adresses privées.
Utilisez le lien de base de données que vous avez créé pour accéder aux données de la base cible.

Par exemple :
```
SELECT * FROM employees@PRIVATE_ENDPOINT_LINK;
```
Remarque

Remarque : pour les informations d'identification que vous créez à l'étape 1, les informations d'identification Oracle AI Database, si le mot de passe de l'utilisateur cible change, vous pouvez mettre à jour les informations d'identification qui contiennent les informations d'identification de l'utilisateur cible comme suit :
```
BEGIN
  DBMS_CLOUD.UPDATE_CREDENTIAL (
   credential_name => 'DB_LINK_CRED',
   attribute => 'PASSWORD',
   value => 'password'
  );
END;
/
```
Où password correspond au nouveau mot de passe.

Après cette opération, les liens de base de données existants qui utilisent ces informations d'identification continuent de fonctionner sans avoir à supprimer ni à recréer les liens de base de données.

Pour plus d'informations, reportez-vous à Procédure CREATE_DATABASE_LINK.

Création de liens de base de données d'une base de données Autonomous AI vers des bases de données Oracle AI sur une adresse privée avec un portefeuille (mTLS)

Vous pouvez créer des liens de base de données à partir d'une base de données Autonomous AI vers une base de données Oracle AI Database cible qui se trouve sur une adresse privée.

Remarque

Remarque : cette option concerne les bases de données Oracle AI cible pour lesquelles SSL/TCPS est configuré et qui se trouvent sur une adresse privée.

Si le protocole SSL/TCPS n'est pas configuré pour Oracle AI Database cible, vous disposez de deux options :

Vous pouvez configurer la base de données Oracle AI Database cible pour qu'elle utilise TCP/IP avec l'authentification SSL (TCPS). Pour plus d'informations sur la configuration de SSL/TCPS, reportez-vous à Configuration de l'authentification Transport Layer Security.
Vous pouvez vous connecter à la base de données Oracle AI Database cible avec TCP. Pour plus de détails, reportez-vous à Création de liens de base de données vers des bases de données Oracle AI sur une adresse privée sans portefeuille.

Pour créer un lien de base de données vers une base de données Oracle AI Database cible sur une adresse privée à l'aide de l'authentification TCP/IP avec SSL (TCPS), procédez comme suit :

Copiez le portefeuille de base de données cible, cwallet.sso, contenant les certificats de la base de données cible vers la banque d'objets.

Remarque

Remarque : 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 dans l'instance Oracle AI Database cible. Stockez les fichiers de portefeuille dans un emplacement sécurisé. Partagez les fichiers de portefeuille uniquement avec les utilisateurs autorisés.
Créez des informations d'identification pour accéder à la banque d'objets dans laquelle stocker le fichier cwallet.sso. Pour plus d'informations sur les paramètres de nom utilisateur et de mot de passe des différents services de stockage d'objets, reportez-vous à Procédure CREATE_CREDENTIAL.
Créez un répertoire sur la base de données Autonomous AI pour le fichier de portefeuille cwallet.sso.

Par exemple :
```
 CREATE DIRECTORY WALLET_DIR AS 'directory_path_of_your_choice';
```
Pour plus d'informations sur la création de répertoires, reportez-vous à Création d'un répertoire dans la base de données Autonomous AI.
Utilisez DBMS_CLOUD.GET_OBJECT pour télécharger le portefeuille de base de données cible vers le répertoire que vous avez créé à l'étape précédente, WALLET_DIR.

Par 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 => 'WALLET_DIR');
END;
/
```
Dans cet exemple, namespace-string est l'espace de noms Oracle Cloud Infrastructure Object Storage et bucketname est le nom du bucket. Pour plus d'informations, reportez-vous à Présentation des espaces de noms Object Storage.

Remarque

Remarque : le fichier credential_name que vous utilisez dans 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 base de données cible.
Sur la base de données Autonomous AI, créez des informations d'identification pour accéder à la base de données cible. Les informations d'identification username et password que vous indiquez avec DBMS_CLOUD.CREATE_CREDENTIAL sont celles de la base de données cible utilisée dans le lien de base de données (où la base de données cible est accessible via le VCN).

Remarque

Remarque : vous devez indiquer le paramètre credential_name.

Par 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.

Remarque

Remarque : vous pouvez utiliser des informations d'identification de clé secrète de coffre pour les informations d'identification de base de données cible dans un lien de base de données. Pour plus d'informations, reportez-vous à Utilisation des informations d'identification de clé secrète de coffre.

Cette opération stocke les informations d'identification dans la base de données dans un format crypté. Vous pouvez utiliser n'importe quel nom d'informations d'identification.
Créez le lien de base de données vers la base de données cible à l'aide de DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

Par exemple :
```
BEGIN
  DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
    db_link_name => 'PEDBLINK1',
    hostname => 'example1.adb.ap-osaka-1.oraclecloud.com',
    port => '1522',
    service_name => '*example_high.adb.oraclecloud.com*',
    ssl_server_cert_dn => '*ssl_server_cert_dn*',
    credential_name => 'DB_LINK_CRED',
    directory_name => 'WALLET_DIR',
    private_target => TRUE);
END;
/
```
Remarque

Remarque : si vous définissez la propriété de base de données ROUTE_OUTBOUND_CONNECTIONS, il n'est pas nécessaire de définir le paramètre private_target sur TRUE dans cette API. Pour plus d'informations, reportez-vous à Sécurité améliorée pour les connexions sortantes avec des adresses privées.

Pour une cible sur une adresse privée, DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK prend en charge la spécification d'un nom d'hôte unique avec le paramètre hostname. Sur une adresse privée, l'utilisation d'une adresse IP, d'une adresse IP SCAN ou d'un nom d'hôte SCAN n'est pas prise en charge (lorsque la cible se trouve sur une adresse publique, CREATE_DATABASE_LINK prend en charge l'utilisation d'une adresse IP, d'une adresse IP SCAN ou d'un nom d'hôte SCAN).

Lorsque la cible est une base de données Oracle RAC, utilisez le paramètre rac_hostnames pour indiquer des noms d'hôte avec DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK. Vous pouvez ainsi tirer parti des fonctionnalités de haute disponibilité d'Oracle RAC. L'utilisation d'une adresse IP, d'une IP SCAN ou d'un nom d'hôte SCAN dans la valeur rac_hostnames n'est pas prise en charge.

Par exemple, avec une base de données Oracle RAC cible, utilisez le paramètre rac_hostnames :
```
BEGIN
  DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
    db_link_name => 'PEDBLINK1',
    rac_hostnames => '["sales1-svr1.example.adb.us-ashburn-1. oraclecloud.com",
                       "sales1-svr2.example.adb.us-ashburn-1.oraclecloud.com",
                       "sales1-svr3.example.adb.us-ashburn-1.oraclecloud.com"]',
    port => '1522',
    service_name => '*example_high.adb.oraclecloud.com*',
    ssl_server_cert_dn => '*ssl_server_cert_dn*',
    credential_name => 'DB_LINK_CRED',
    directory_name => 'WALLET_DIR',
    private_target => TRUE);
END;
/
```
DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK ne prend pas en charge la valeur localhost pour hostname ou dans le paramètre rac_hostnames.

Les utilisateurs autres qu'ADMIN ont besoin de privilèges pour exécuter DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.
Utilisez le lien de base de données que vous avez créé pour accéder aux données de la base cible.

Par exemple :
```
SELECT * FROM employees@PEDBLINK1;
```
Remarque

Remarque : pour les informations d'identification que vous créez à l'étape 5, les informations d'identification Oracle AI Database, si le mot de passe de l'utilisateur cible change, vous pouvez mettre à jour les informations d'identification qui contiennent les informations d'identification de l'utilisateur cible comme suit :
```
BEGIN
  DBMS_CLOUD.UPDATE_CREDENTIAL (
    credential_name => 'DB_LINK_CRED',
    attribute => 'PASSWORD',
    value => 'password');
END;
/
```
Où password correspond au nouveau mot de passe.

Après cette opération, les liens de base de données existants qui utilisent ces informations d'identification continuent de fonctionner sans avoir à supprimer ni à recréer les liens de base de données.

Pour plus d'informations, reportez-vous à Procédure CREATE_DATABASE_LINK.

Documentation Oracle Cloud Infrastructure

Création de liens de base de données à partir d'une base de données Autonomous AI vers une base de données Oracle AI Database sur une adresse privée

Prérequis

Création de liens de base de données vers des bases de données Oracle AI sur une adresse privée sans portefeuille

Création de liens de base de données d'une base de données Autonomous AI vers des bases de données Oracle AI sur une adresse privée avec un portefeuille (mTLS)