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

Puede crear enlaces de base de datos de una instancia de Autonomous Database en una infraestructura de Exadata dedicada a una instancia de Oracle Database Gateway para acceder a bases de datos que no sean de Oracle que estén en un punto final privado.

Una instancia de Oracle Database Gateway es un gateway diseñado para acceder a un sistema que no sea Oracle concreto. Con Oracle Database Gateway, puede acceder a los datos desde cualquier lugar de un sistema de base de datos distribuido sin conocer la ubicación de los datos ni cómo se almacenan. El uso de enlaces de base de datos en Autonomous Database con Oracle Database Gateway soporta entornos heterogéneos y elimina la necesidad de personalizar las aplicaciones para acceder a los datos de sistemas que no sean de Oracle.

Note:

La creación de enlaces de base de datos con conectividad heterogénea gestionada por el cliente a bases de datos que no sean de Oracle en un punto final privado solo está soportada con las versiones 19.25 y posteriores para 19c y 23.6 y posteriores para 23ai.

Temas relacionados

Paquete DBMS_CLOUD

Requisitos

Para utilizar enlaces de base de datos de una instancia de Autonomous Database en un punto final público, realice lo siguiente:

Configure Oracle Database Gateway para acceder a una base de datos que no sea de Oracle. Consulte Oracle Database Gateways en Oracle Database 19c Database Heterogeneous Connectivity User's Guide o Oracle Database 23ai Database Heterogeneous Connectivity User's Guide para obtener más información.

En función de la base de datos a la que desee conectarse, puede consultar la Guía de instalación y configuración correspondiente y la Guía del usuario de Gateway.

Por ejemplo, para Oracle Database Gateway for SQL Server, consulte:
- Instalación y configuración de Oracle Database Gateway for SQL Server en la Guía de instalación y configuración de Oracle Database 19c para Microsoft Windows o la Guía de instalación y configuración de Oracle Database 23ai para Microsoft Windows
- Introducción a Oracle Database Gateway for SQL Server en Oracle Database 19c User's Guide o Oracle Database 23ai User's Guide en Oracle Database Gateway for SQL Server User's Guide.
- Configure Oracle Net for the Gateway en Oracle Database 19c Installation and Configuration Guide for Microsoft Windows u Oracle Database 23ai Installation and Configuration Guide for Microsoft Windows
Configure Oracle Net Listener para manejar solicitudes entrantes en Oracle Database Gateway.
Cree una cartera autofirmada en Oracle Database Gateway.

De forma adicional:

A la base de datos de destino se debe poder acceder desde la VCN de Oracle Cloud Infrastructure de la base de datos de origen. Por ejemplo, se puede conectar a la base de datos de destino cuando:
- La base de datos de destino está en un punto final privado.
- Tanto la base de datos de origen como la base de datos de destino están en la misma VCN de Oracle Cloud Infrastructure.
- La base de datos origen y la base de datos destino están en diferentes redes virtuales en la nube de Oracle Cloud Infrastructure emparejadas.
- Para un destino en un punto final privado, DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK soporta la especificación de un único nombre de host con el parámetro hostname. 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 el destino está en un punto final público, CREATE_DATABASE_LINK soporta el uso de una dirección IP, una IP de SCAN o un nombre de host de SCAN).
Se deben definir las siguientes reglas de entrada y salida para el punto final privado:
- Defina una regla de salida en la lista de seguridad de subred o el grupo de seguridad de red de la base de datos de origen para que se permita el tráfico a través de TCP a la dirección IP y el número de puerto de la base de datos de destino.
- Defina una regla de entrada en la lista de seguridad de subred o el grupo de seguridad de red de la base de datos de destino para que se permita el tráfico a través de TCP desde la dirección IP de la base de datos de origen al puerto de destino.

Conectividad Heterogénea Gestionada por el Cliente a Bases de Datos No Oracle en un Punto Final Privado (sin cartera)

Puede crear enlaces de base de datos de una instancia de Autonomous Database a una instancia de Oracle Database Gateway para acceder a bases de datos que no sean de Oracle que estén en un punto final privado, ya sea con una cartera (TCPS) o sin una cartera (TLS). En esta sección se describe la creación de un enlace de base de datos sin una cartera.

Para crear enlaces de base de datos desde una instancia de Autonomous Database en un punto final privado a un gateway de destino, mediante enlaces de base de datos y una conexión TLS, realice lo siguiente:

En Autonomous Database, cree credenciales para acceder a la base de datos de destino. El nombre de usuario y la contraseña que especifique con DBMS_CLOUD.CREATE_CREDENTIAL son las credenciales de la base de datos de destino utilizadas en el enlace de base de datos (donde se accede a la base de datos de destino a través de Oracle Database Gateway).
Por ejemplo:
```
BEGIN
    DBMS_CLOUD.CREATE_CREDENTIAL(
        credential_name => 'DB_LINK_CRED',
        username => 'NICK',
        password => 'password'
    );
END;/
```
El suministro del parámetro credential_name es obligatorio.

Los caracteres del parámetro username deben estar todos 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.
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 una cartera).

Cuando directory_name es NULL, la conexión se crea como un enlace de base de datos basado en TCP (sin una 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, mediante una dirección IP, una IP de SCAN o un nombre de host de SCAN no está soportado).

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 requieren privilegios para ejecutar DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

Para obtener más información, consulte Procedimiento CREATE_DATABASE_LINK.
Utilice el enlace de base de datos creado para acceder a los datos del gateway de destino.
Por ejemplo:
```
SELECT * FROM employees@SALESLINK;
```

Para las credenciales creadas en el paso 1, las credenciales de Oracle Database Gateway, si la contraseña del usuario de destino cambia, puede actualizar la credencial que contiene las credenciales del usuario de destino de la siguiente forma:

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

Donde la contraseña es la nueva contraseña.

Después de esta operación, los enlaces de base de datos existentes que utilizan esta credencial siguen funcionando sin tener que borrar y volver a crear los enlaces de base de datos.

Consulte UPDATE_CREDENTIAL Procedimiento para obtener más información.

Conectividad Heterogénea Gestionada por el Cliente a Bases de Datos No Oracle en un Punto Final Privado (con una cartera)

Para crear enlaces de base de datos desde una instancia de Autonomous Database en un punto final privado a un gateway de destino, conectándose con una cartera, haga lo siguiente:

Copie la cartera autofirmada del gateway de destino, por ejemplo, cwallet.sso, que contenga los certificados de 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.
En Autonomous Database, cree credenciales para acceder al almacén de objetos en el que almacena cwallet.sso.
Consulte 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.
Cree un directorio en Autonomous Database para el archivo de cartera cwallet.sso.
Por ejemplo:
```
CREATE DIRECTORY dblink_wallet_dir AS 'directory_path_of_your_choice';
```
Consulte Creación de directorios en Autonomous Database para obtener información sobre la creación de directorios.
Utilice DBMS_CLOUD.GET_OBJECT para cargar la cartera autofirmada del gateway de destino en el directorio 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 de nombres de almacenamiento de objetos de Oracle Cloud Infrastructure, y bucketname es el nombre del cubo. Consulte Descripción de los espacios de nombres de Object Storage para obtener más información.

Note:
El valor credential_name que utiliza en este paso son las credenciales del almacén de objetos. En el siguiente paso, creará las credenciales para acceder al gateway de destino.
En Autonomous Database, cree credenciales para acceder a la base de datos de destino. El nombre de usuario y la contraseña que especifique con DBMS_CLOUD.CREATE_CREDENTIAL son las credenciales de la base de datos de destino utilizadas en el enlace de base de datos (donde se accede a la base de datos de destino a través de Oracle Database Gateway).
Por ejemplo:
```
BEGIN
    DBMS_CLOUD.CREATE_CREDENTIAL(
        credential_name =>'DB_LINK_CRED',
        username =>'NICK',
        password =>'password'
    );
END;
/
```
El suministro del parámetro credential_name es obligatorio.

Los caracteres del parámetro username deben estar todos 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.
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, mediante una dirección IP, una IP de SCAN o un nombre de host de SCAN no está soportado).

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 requieren privilegios para ejecutar DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

Para obtener más información, consulte Procedimiento CREATE_DATABASE_LINK.
Utilice el enlace de base de datos creado para acceder a los datos del gateway de destino.
Por ejemplo:
```
SELECT * FROM employees@SALESLINK;
```

Para las credenciales creadas en el paso 5, las credenciales de Oracle Database Gateway, si la contraseña del usuario de destino cambia, puede actualizar la credencial que contiene las credenciales del usuario de destino de la siguiente forma:

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

Donde la contraseña es la nueva contraseña.

Después de esta operación, los enlaces de base de datos existentes que utilizan esta credencial siguen funcionando sin tener que borrar y volver a crear los enlaces de base de datos.

Consulte UPDATE_CREDENTIAL Procedimiento para obtener más información.

Título e Información de Copyright

Oracle y/o sus filiales.