Creación de enlaces de base de datos con conectividad heterogénea gestionada por el cliente a bases de datos no Oracle en un punto final privado

Muestra los requisitos para crear enlaces de base de datos a partir de una base de datos de IA autónoma con conectividad heterogénea gestionada por el cliente a bases de datos no de Oracle que estén en un punto final privado.

Puede crear enlaces de base de datos desde una instancia de base de datos de IA autónoma a Oracle Database Gateway para acceder a bases de datos que no sean de Oracle y que estén en un punto final privado, conectándose con una cartera (TCPS) o sin una cartera (TLS).

1. En Autonomous AI Database, cree credenciales para acceder a la base de datos de destino. username y password que especifique con DBMS_CLOUD.CREATE_CREDENTIAL son las credenciales de la base de datos destino utilizada en el enlace de base de datos (donde se accede a la base de datos destino a través de Oracle Database Gateway).

   Se necesita proporcionar el parámetro credential_name.

   Por ejemplo:

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

   Los caracteres del parámetro username deben estar en mayúsculas.

   Esta operación almacena las credenciales en la base de datos en un formato cifrado. Puede utilizar cualquier nombre para el nombre de credencial.

2. Cree el enlace de base de datos al gateway de destino mediante DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

   Por ejemplo:

   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;
   /

   El parámetro ssl_server_cert_dn es opcional si la conexión se crea como un enlace de base de datos basado en TCP (sin cartera).

   Cuando directory_name es NULL, la conexión se crea como un enlace de base de datos basado en TCP (sin cartera).

   El parámetro private_target se debe definir en TRUE cuando el destino que no es Oracle Database está en un punto final privado (es decir, el enlace de base de datos accede a un nombre de host que se debe resolver en un servidor DNS de VCN). Cuando private_target es TRUE, el parámetro hostname debe ser un único nombre de host (en un punto final privado, no está soportado el uso de una dirección IP, una IP de SCAN o un nombre de host de SCAN).

   Cuando gateway_link es TRUE y gateway_params es NULL, especifica que el enlace de base de datos es a un gateway de Oracle gestionado por el cliente.

   Los usuarios que no sean ADMIN necesitan privilegios para ejecutar DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

3. Utilice el enlace de base de datos que ha creado para acceder a los datos del gateway de destino.

   Por ejemplo:

   SELECT * FROM employees@SALESLINK;
   

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

Puede crear enlaces de base de datos desde una instancia de base de datos de IA autónoma a Oracle Database Gateway para acceder a bases de datos que no sean de Oracle y que estén en un punto final privado, conectándose con una cartera (TCPS) o sin una cartera (TLS).

1. Copie la cartera autofirmada de Oracle Database Gateway de destino en Object Store. Por ejemplo, copie cwallet.sso, que contiene los certificados para Oracle Database Gateway, en el almacén de objetos.

   El archivo de cartera, junto con el ID de usuario y la contraseña de la base de datos, proporcionan acceso a los datos disponibles a través del gateway de destino. Almacene los archivos de cartera en una ubicación segura. Comparta los archivos de cartera solo con usuarios autorizados.

2. Cree credenciales para acceder al almacén de objetos en el que almacena cwallet.sso. Consulte el procedimiento CREATE_CREDENTIAL para obtener información sobre los parámetros de nombre de usuario y contraseña para diferentes servicios de almacenamiento de objetos.
3. Cree un directorio en la base de datos de IA autónoma para el archivo de cartera cwallet.sso.

   Por ejemplo:

   CREATE DIRECTORY dblink_wallet_dir AS 'directory_path_of_your_choice';
   

   Consulte Crear directorio en base de datos de IA autónoma para obtener información sobre la creación de directorios.

4. Utilice DBMS_CLOUD.GET_OBJECT para cargar la cartera auto firmada del gateway de destino en el directorio que ha creado en el paso anterior, DBLINK_WALLET_DIR.

   Por ejemplo:

   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;
   /

   En este ejemplo, namespace-string es el espacio Oracle Cloud Infrastructure Object Storage Namepace, y bucketname es el nombre del cubo. Consulte Descripción de los espacios de nombres de Object Storage para obtener más información.

   Nota
   
   El credential_name que utiliza en este paso son las credenciales para el almacén de objetos. En el siguiente paso, cree las credenciales para acceder al gateway de destino.
5. En Autonomous AI Database, cree credenciales para acceder a la base de datos de destino. username y password que especifique con DBMS_CLOUD.CREATE_CREDENTIAL son las credenciales de la base de datos destino utilizada en el enlace de base de datos (donde se accede a la base de datos destino a través de Oracle Database Gateway).

   Se necesita proporcionar el parámetro credential_name.

   Por ejemplo:

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

   Los caracteres del parámetro username deben estar en mayúsculas.

   Esta operación almacena las credenciales en la base de datos en un formato cifrado. Puede utilizar cualquier nombre para el nombre de credencial.

6. Cree el enlace de base de datos al gateway de destino mediante DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

   Por ejemplo:

   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 no es NULL, se crea un enlace de base de datos basado en TCPS.

   El parámetro private_target se debe definir en TRUE cuando el destino que no es Oracle Database está en un punto final privado (es decir, el enlace de base de datos accede a un nombre de host que se debe resolver en un servidor DNS de VCN). Cuando private_target es TRUE, el parámetro hostname debe ser un único nombre de host (en un punto final privado, no está soportado el uso de una dirección IP, una IP de SCAN o un nombre de host de SCAN).

   Cuando gateway_link es TRUE y gateway_params es NULL, especifica que el enlace de base de datos es a un gateway de Oracle gestionado por el cliente.

   Los usuarios que no sean ADMIN necesitan privilegios para ejecutar DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

7. Utilice el enlace de base de datos que ha creado para acceder a los datos del gateway de destino.

   Por ejemplo:

   SELECT * FROM employees@SALESLINK;
   

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