El soporte de Autonomous Database para la conectividad heterogénea gestionada por Oracle facilita la creación de enlaces de base de datos a bases de datos que no sean de Oracle.

1. En Autonomous Database, cree credenciales para acceder a la base de datos de destino. Los valores username y password que especifique con DBMS_CLOUD.CREATE_CREDENTIAL son las credenciales de la base de datos de destino que se utilizan en el enlace de base de datos.

   Por ejemplo:

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

   Esta operación almacena las credenciales en la base de datos en un formato cifrado. Puede utilizar cualquier nombre para el nombre de credencial. Es necesario proporcionar el parámetro credential_name.

   Para acceder a Google Analytics, Google BigQuery, Google Drive, Youtube, ServiceNow o Microsoft SharePoint con OAuth2, la credencial debe incluir el parámetro params con el valor gcp_oauth2.

   Por ejemplo:

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'SERVICENOW_OAUTH',
       params => JSON_OBJECT(
                    'gcp_oauth2' value JSON_OBJECT(
                           'client_id' value 'CLIENT_ID', 
                           'client_secret' value 'CLIENT_SECRET', 
                           'refresh_token' value 'Refresh_Token')));
   END;
   /

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

2. Cree el enlace de base de datos a la base de datos de destino mediante DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

   Por ejemplo, para crear un enlace de base de datos a AWS Redshift:

   BEGIN
        DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
             db_link_name => 'AWSREDSHIFT_LINK', 
             hostname => 'example.com', 
             port => '5439',
             service_name => 'example_service_name',
             credential_name => 'AWS_REDSHIFT_LINK_CRED',
             gateway_params => JSON_OBJECT('db_type'  value 'awsredshift'),
             ssl_server_cert_dn => NULL);
   END;
   /

   service_name es el nombre de la base de datos no Oracle.

   El valor gateway_params db_type que proporcione debe ser uno de los valores soportados:

   Valor de db_type	Tipo de base de datos
   awsredshift	Amazon Redshift
   azure	Microsoft SQL Server Azure SQL Azure Synapse Analytics
   db2	IBM Db2
   google_analytics	Google Analytics
   google_bigquery	Google BigQuery
   google_drive	Google Drive
   hive	Apache Hive
   mongodb	MongoDB
   mysql	MySQL
   mysql_community	MySQL Community Edition
   postgres	PostgreSQL
   salesforce	Salesforce
   servicenow	ServiceNow
   sharepoint	Microsoft SharePoint
   snowflake	Copo de Nieve
   youtube	YouTube

   Autonomous Database configura y gestiona automáticamente la conexión segura a una base de datos de destino y sus conexiones están cifradas de extremo a extremo. La conectividad heterogénea gestionada por Oracle está preconfigurada con una cartera que contiene la mayoría de los certificados SSL intermedios y de raíz de confianza comunes. Por lo tanto, se debe proporcionar NULL como valor para el parámetro ssl_server_cert_dn.

   Para garantizar la seguridad al utilizar enlaces de base de datos con conectividad heterogénea gestionada por Oracle, el puerto de conexión está restringido y debe tener SSL/TLS activado. Especifique el puerto de la base de datos de destino con el parámetro port.

   Consulte Tipos y puertos de base de datos de conectividad heterogénea gestionados por Oracle para obtener la lista de tipos de bases de datos no Oracle soportados.

   La vista HETEROGENEOUS_CONNECTIVITY_INFO proporciona información sobre los tipos de conectividad heterogénea de Oracle soportados y muestra un ejemplo de código PL/SQL para cada tipo soportado. Consulte Acceso a información y muestras de conectividad heterogénea para obtener más información.

   Al especificar el parámetro gateway_params, para algunos valores db_type, se soportan parámetros gateway_params adicionales:

   Valor de db_type	Parámetros de gateway soportados con db_type especificado
   azure	Cuando el valor db_type es azure, hay dos parámetros opcionales, auth_method y domain para soportar la autenticación NTLM/AD. Cuando se configura NTLMv2, defina auth_method=10 y domain en el valor del dominio de Windows. Para utilizar una contraseña de Azure Active Directory, defina auth_method=13. No utilice auth_method=13 para acceder a una base de datos local de Oracle. Consulte Método de autenticación de Microsoft SQL Server para obtener más información.
   google_analytics	Cuando el valor db_type es google_analytics, hostname no se utiliza y puede proporcionar un valor como example.com. Para db_type google_analytics, la credencial debe ser de tipo OAuth mediante el parámetro params con los valores gcp_oauth2 especificados (client_id, client_secret y refresh_token). Consulte Procedimiento CREATE_CREDENTIAL para obtener más información.
   google_bigquery	Cuando db_type es google_bigquery, el parámetro project es válido. Este parámetro especifica el nombre del proyecto en google_bigquery y es necesario. Cuando el valor db_type es google_bigquery, hostname no se utiliza y puede proporcionar un valor como example.com. Para db_type google_bigquery, la credencial debe ser de tipo OAuth mediante el parámetro params con los valores gcp_oauth2 especificados (client_id, client_secret y refresh_token). Consulte Procedimiento CREATE_CREDENTIAL para obtener más información.
   google_drive	Para db_type google_drive, la credencial que proporcione con DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK debe ser una credencial de tipo OAuth con el parámetro params con los valores gcp_oauth2 especificados (client_id, client_secret y refresh_token). Para conectarse a Google Drive y obtener datos, debe proporcionar los parámetros de gateway directory_name y file_name. Estos parámetros especifican un archivo de modelo (archivo REST automático) que asigna la respuesta JSON al modelo relacional. El archivo de modelo especifica los puntos finales, la asignación de tablas y el código de respuesta HTTP para procesar la respuesta JSON. Consulte Sintaxis de archivo de modelo y Archivo de modelo de ejemplo para obtener más información. Al utilizar el parámetro gateway_params con db_type google_drive, debe proporcionar el parámetro gateway_params db_type con el valor 'google_drive' y los parámetros directory_name y file_name, junto con las credenciales de tipo OAuth: El parámetro directory_name especifica el directorio con el archivo de configuración REST. Puede crear este directorio de la siguiente manera: create or replace directory google_drive_dir as 'GOOGLE_DRIVE_DIR'; Obtenga y descargue el archivo REST automático en el directorio especificado. Por ejemplo: exec DBMS_CLOUD.get_object('google_drive_dir_cred', 'https://objectstorage.<...>/google_drive.rest','GOOGLE_DRIVE_DIR'); Defina el valor file_name en el nombre del archivo REST automático que descargó, "google_drive.rest". A continuación, puede utilizar el archivo de configuración de REST con OAuth 2.0.
   hive	Cuando db_type es hive, el parámetro http_path es válido. Este parámetro especifica el valor HttpPath, si es necesario, para conectarse a la instancia de Hive.
   salesforce	Al utilizar el parámetro gateway_params con db_type salesforce, debe proporcionar la opción security_token. El token de seguridad es un código alfanumérico sensible a mayúsculas/minúsculas. Consulte Restablecimiento del token de seguridad para obtener más información. Al utilizar el parámetro gateway_params con db_type salesforce, debe proporcionar el parámetro hostname correcto. Salesforce proporciona dos formas de URL para la cuenta de servicio de Salesforce: Forma xxxx.develop.lightning.force.com de URL Pantalla xxxxmy.salesforce.com de URL, como se muestra en el separador Ver perfil. La conectividad heterogénea gestionada por Oracle solo soporta la forma xxxxmy.salesforce.com de URL para el valor del parámetro hostname.
   servicenow	Para conectarse a ServiceNow y obtener datos, debe proporcionar los parámetros de gateway directory_name y file_name. Estos parámetros especifican un archivo de modelo (archivo de configuración REST) que asigna la respuesta JSON al modelo relacional. El archivo de modelo especifica los puntos finales, la asignación de tablas y el código de respuesta HTTP para procesar la respuesta JSON. Consulte Sintaxis de archivo de modelo y Archivo de modelo de ejemplo para obtener más información. Al utilizar el parámetro gateway_params con db_type servicenow, hay dos opciones soportadas: Autenticación básica: debe proporcionar el parámetro gateway_params db_type con el valor 'servicenow' y los parámetros directory_name y file_name junto con las credenciales de nombre de usuario/tipo de contraseña. OAuth 2.0 Autenticación: debe proporcionar el parámetro gateway_params db_type con el valor 'servicenow' y los parámetros directory_name, file_name y token_uri, junto con las credenciales de tipo OAuth. Para la autenticación OAuth 2.0 con db_type servicenow, la credencial debe ser de tipo OAuth mediante el parámetro params con los valores gcp_oauth2 especificados (client_id, client_secret y refresh_token). Consulte Procedimiento CREATE_CREDENTIAL para obtener más información. El parámetro directory_name especifica el directorio con el archivo de configuración REST ServiceNow. Puede crear este directorio de la siguiente manera: create or replace directory servicenow_dir as 'SERVICENOW_DIR'; Obtenga y descargue el archivo de configuración REST ServiceNow en el directorio especificado. Por ejemplo: exec DBMS_CLOUD.get_object('servicenow_dir_cred', 'https://objectstorage.<...>/servicenow.rest','SERVICENOW_DIR'); Defina el valor file_name en el nombre del archivo de configuración REST que ha descargado, "servicenow.rest". A continuación, puede utilizar el archivo de configuración REST ServiceNow con autenticación básica o OAuth2.0. Consulte HETEROGENEOUS_CONNECTIVITY_INFO View para obtener ejemplos.
   sharepoint	Al utilizar el parámetro gateway_params con db_type sharepoint, especifique también los valores para auth_uri, scope, service_url y token_uri. Para db_type sharepoint, la credencial que proporcione con DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK debe ser una credencial de tipo OAuth mediante el parámetro params con los valores gcp_oauth2 especificados (client_id, client_secret y refresh_token). Consulte Procedimiento CREATE_CREDENTIAL para obtener más información. Genere refresh_token para tenant_id.sharepoint.com/.default offline_access. Consulte lo siguiente para obtener más información: Determine the scope y OAuth 2.0 authentication. Defina valores para gateway_params para db_type sharepoint: auth_uri: defina auth_uri de Azure. Consulte Obtención de información de cliente de aplicación y puntos finales para obtener más información. scope: defina el ámbito. Consulte Descripciones de opciones de conexión para obtener más información. service_url: defina service_url. Consulte URL de servicio para obtener más información. token_uri: obtenga token_uri de Azure. Consulte Obtención de información de cliente de aplicación y puntos finales para obtener más información.
   snowflake	Al utilizar el parámetro gateway_params con db_type snowflake, utilice el identificador de cuenta de Snowflake como parámetro hostname. En este caso, el controlador agrega snowflakecomupting.com, por lo que no transfiere esta parte del nombre de host explícitamente. Para buscar el identificador de cuenta de Snowflake, consulte Formatos de identificador de cuenta por plataforma y región en la nube. Por ejemplo: para la cuenta de Snowflake: https://example-marketing_test_account.snowflakecomputing.com Defina el valor hostname en "example-marketing_test_account". Cuando db_type es SNOWFLAKE, los parámetros opcionales: role, schema y warehouse son válidos. Estos valores especifican un valor de esquema, rol o almacén diferente al valor por defecto. Por ejemplo: gateway_params => JSON_OBJECT( 'db_type' value 'snowflake', 'role' value 'ADMIN', 'schema' value 'PUBLIC', 'warehouse' value 'TEST' )
   youtube	Para conectarse a YouTube y obtener datos, debe proporcionar los parámetros directory_name y file_name. Estos parámetros especifican un archivo de modelo (archivo de configuración REST) que asigna la respuesta JSON al modelo relacional. El archivo de modelo especifica los puntos finales, la asignación de tablas y el código de respuesta HTTP para procesar la respuesta JSON. Consulte Sintaxis de archivo de modelo y Archivo de modelo de ejemplo para obtener más información. Para db_type youtube, la credencial debe ser de tipo OAuth mediante el parámetro params con los valores gcp_oauth2 especificados (client_id, client_secret y refresh_token). Consulte Procedimiento CREATE_CREDENTIAL para obtener más información. El parámetro directory_name especifica el directorio con el archivo de configuración REST de youtube. Por ejemplo, para crear este directorio y agregar el contenido necesario: Cree un directorio en la instancia de Autonomous Database: create or replace directory youtube_dir as 'YOUTUBE_DIR'; Obtenga y descargue el archivo de configuración REST de descanso automático en el directorio especificado. Por ejemplo: exec DBMS_CLOUD.get_object('youtube_dir_cred', 'https://objectstorage.<...>/youtube.rest','YOUTUBE_DIR'); Defina el valor file_name en el nombre del archivo de configuración REST que ha descargado, 'youtube.rest'. A continuación, puede utilizar el archivo de configuración de REST con OAuth2.0. Consulte HETEROGENEOUS_CONNECTIVITY_INFO View para obtener ejemplos.

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

3. Utilice el enlace de base de datos para acceder a los datos de la base de datos de destino.

   Por ejemplo:

   SELECT count(*) FROM sales@AWSREDSHIFT_LINK

   El nombre de tabla que especifique al utilizar SELECT con Google BigQuery debe estar entre comillas. Por ejemplo:

   SELECT count(*) FROM "sales"@GOOGLE_BIGQUERY_LINK

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

• Creación de enlaces de base de datos a Oracle MySQL en un punto final privado con conectividad heterogénea gestionada por Oracle
  El soporte de Autonomous Database para la conectividad heterogénea gestionada por Oracle facilita la creación de enlaces de base de datos a Oracle MySQL Database Service en un punto final privado. Al utilizar enlaces de base de datos con conectividad heterogénea gestionada por Oracle, Autonomous Database configura la conexión a Oracle MySQL Database Service.
• Tipos y puertos de base de datos de conectividad heterogénea gestionados por Oracle
  Muestra las bases de datos no Oracle a las que se puede conectar desde Autonomous Database con conectividad heterogénea gestionada por Oracle, además de mostrar el valor de puerto soportado para cada tipo de base de datos. También proporciona un enlace donde puede ver las versiones de base de datos soportadas para cada tipo de base de datos.
• Acceso a ejemplos e información de conectividad heterogénea
  Oracle Autonomous Database proporciona información de conectividad heterogénea para enlaces de base de datos a bases de datos que no son de Oracle.