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 no de Oracle.

1. En Autonomous Database, cree credenciales para acceder a la base de datos 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.

   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. Se necesita 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 CREATE_CREDENTIAL Procedure para obtener más información.

2. Cree el enlace de base de datos a la base de datos 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 que no es de 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 SQL de Azure 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 las 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 raíz de confianza comunes. Por lo tanto, NULL se debe proporcionar 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 destino con el parámetro port.

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

   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 ejemplos e información 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 admitir la autenticación NTLM/AD. Cuando se configura NTLMv2, defina auth_method=10 y domain en el valor de 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, no se utiliza hostname y puede proporcionar un valor como example.com. Para db_type google_analytics, la credencial 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). Consulte CREATE_CREDENTIAL Procedure 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, no se utiliza hostname y puede proporcionar un valor como example.com. Para db_type google_bigquery, la credencial 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). Consulte CREATE_CREDENTIAL Procedure 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 Restablecer el 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: xxxx.develop.lightning.force.com forma de URL Forma 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 de REST) que asigna la respuesta de 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 proporcionar los parámetros directory_name y file_name junto con las credenciales de tipo de nombre de usuario/contraseña. Autenticación OAuth 2.0: 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 una credencial de tipo OAuth mediante el parámetro params con los valores gcp_oauth2 especificados (client_id, client_secret y refresh_token). Consulte CREATE_CREDENTIAL Procedure 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 de 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 de REST que ha descargado, "servicenow.rest". A continuación, puede utilizar el archivo de configuración de 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 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 con el parámetro params con los valores gcp_oauth2 especificados (client_id, client_secret y refresh_token). Consulte CREATE_CREDENTIAL Procedure para obtener más información. Genere el valor 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 desde 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 las 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	Cuando utilice 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, de modo que no transfiera 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 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 esquema, rol o valor de almacén distinto del 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 de REST) que asigna la respuesta de 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 una credencial de tipo OAuth con el parámetro params con los valores gcp_oauth2 especificados (client_id, client_secret y refresh_token). Consulte CREATE_CREDENTIAL Procedure 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 de 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 usar el archivo de configuración de REST con OAuth2.0. Consulte HETEROGENEOUS_CONNECTIVITY_INFO View para obtener ejemplos.

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

3. Utilice el enlace de base de datos para acceder a los datos de la base de datos 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 y configura la conexión a Oracle MySQL Database Service.
• Tipos y puertos de bases de datos de conectividad heterogénea gestionados por Oracle
  Muestra las bases de datos no Oracle a las que puede conectarse desde Autonomous Database con conectividad heterogénea gestionada por Oracle y muestra 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.
• Accede 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.