Crea database link a database non Oracle con connettività eterogenea gestita da Oracle

Il supporto di Autonomous Database per la connettività eterogenea gestita da Oracle semplifica la creazione di collegamenti al database a database non Oracle.

1. In Autonomous Database creare le credenziali per accedere al database di destinazione. Le credenziali username e password specificate con DBMS_CLOUD.CREATE_CREDENTIAL sono le credenziali per il database di destinazione utilizzato all'interno del database link.

   Ad esempio:

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

   Questa operazione memorizza le credenziali nel database in un formato cifrato. È possibile utilizzare qualsiasi nome per il nome della credenziale. Specificare il parametro credential_name.

   Per accedere a Google Analytics, Google BigQuery, Google Drive, Youtube, ServiceNow o Microsoft SharePoint con OAuth2, la credenziale deve includere il parametro params con il valore gcp_oauth2.

   Ad esempio:

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

   Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedure.

2. Creare il database link al database di destinazione utilizzando DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

   Ad esempio, per creare un database link ad 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 è il nome del database non Oracle.

   Il valore gateway_params db_type fornito deve essere uno dei valori supportati:

   Valore db_type	Tipo di database
   awsredshift	Amazon Redshift
   azure	Microsoft SQL Server SQL 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	Addetti alle vendite
   servicenow	ServiceNow
   sharepoint	Microsoft SharePoint
   snowflake	Snowflake
   youtube	YouTube

   Autonomous Database configura e gestisce automaticamente la connessione sicura a un database di destinazione e le connessioni vengono cifrate end-to-end. La connettività eterogenea gestita da Oracle è preconfigurata con un wallet che contiene la maggior parte dei comuni certificati SSL root e intermedi sicuri. Pertanto, è necessario fornire NULL come valore per il parametro ssl_server_cert_dn.

   Per garantire la sicurezza durante l'utilizzo dei database link con connettività eterogenea gestita da Oracle, la porta di connessione è limitata e deve avere SSL/TLS abilitato. Specificare la porta del database di destinazione con il parametro port.

   Per la lista dei tipi di database non Oracle supportati, vedere Oracle-Managed Heterogeneous Connectivity Database Types and Ports.

   La vista HETEROGENEOUS_CONNECTIVITY_INFO fornisce informazioni sui tipi di connettività eterogenea Oracle supportati e mostra un esempio di codice PL/SQL per ogni tipo supportato. Per ulteriori informazioni, vedere Accesso a esempi e informazioni sulla connettività eterogenea.

   Quando si specifica il parametro gateway_params, per alcuni valori db_type sono supportati parametri gateway_params aggiuntivi:

   Valore db_type	Parametri del gateway supportati con db_type specificato
   azure	Quando il valore db_type è azure, sono disponibili due parametri facoltativi, auth_method e domain per supportare l'autenticazione NTLM/AD. Quando NTLMv2 è configurato, impostare auth_method=10 e impostare domain sul valore del dominio Windows. Per utilizzare una password di Azure Active Directory, impostare auth_method=13. Non utilizzare auth_method=13 per accedere a un database Oracle on-premise. Per ulteriori informazioni, vedere Metodo di autenticazione di Microsoft SQL Server.
   google_analytics	Se il valore db_type è google_analytics, hostname non viene utilizzato ed è possibile fornire un valore come example.com. Per db_type google_analytics, la credenziale deve essere una credenziale di tipo OAuth che utilizza il parametro params con i valori gcp_oauth2 specificati (client_id, client_secret e refresh_token). Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedure.
   google_bigquery	Se db_type è google_bigquery, il parametro project è valido. Questo parametro specifica il nome del progetto in google_bigquery ed è obbligatorio. Se il valore db_type è google_bigquery, hostname non viene utilizzato ed è possibile fornire un valore come example.com. Per db_type google_bigquery, la credenziale deve essere una credenziale di tipo OAuth che utilizza il parametro params con i valori gcp_oauth2 specificati (client_id, client_secret e refresh_token). Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedure.
   google_drive	Per db_type google_drive, la credenziale fornita con DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK deve essere una credenziale di tipo OAuth che utilizza il parametro params con i valori gcp_oauth2 specificati (client_id, client_secret e refresh_token). Per connettersi a Google Drive e ottenere i dati è necessario fornire i parametri del gateway directory_name e file_name. Questi parametri specificano un file modello (file REST automatico) che mappa la risposta JSON al modello relazionale. Il file modello specifica gli endpoint, il mapping delle tabelle e il codice di risposta HTTP per l'elaborazione della risposta JSON. Per ulteriori informazioni, vedere Sintassi dei file modello e File modello di esempio. Quando si utilizza il parametro gateway_params con db_type google_drive, è necessario fornire il parametro gateway_params db_type con il valore 'google_drive' e i parametri directory_name e file_name, insieme alle credenziali di tipo OAuth: Il parametro directory_name specifica la directory con il file di configurazione REST. È possibile creare questa directory come indicato di seguito. create or replace directory google_drive_dir as 'GOOGLE_DRIVE_DIR'; Ottenere e scaricare il file REST automatico nella directory specificata. Ad esempio: exec DBMS_CLOUD.get_object('google_drive_dir_cred', 'https://objectstorage.<...>/google_drive.rest','GOOGLE_DRIVE_DIR'); Impostare il valore file_name sul nome del file REST automatico scaricato, "google_drive.rest". Quindi è possibile utilizzare il file di configurazione REST con OAuth 2.0.
   hive	Se db_type è hive, il parametro http_path è valido. Questo parametro specifica il valore HttpPath, se necessario, per connettersi all'istanza Hive.
   salesforce	Quando si utilizza il parametro gateway_params con db_type salesforce, è necessario fornire l'opzione security_token. Il token di sicurezza è un codice alfanumerico con distinzione tra maiuscole e minuscole. Per ulteriori informazioni, vedere Reimposta token di sicurezza. Quando si utilizza il parametro gateway_params con db_type salesforce, è necessario fornire il parametro hostname corretto. Salesforce fornisce due forme di URL per l'account del servizio Salesforce: Modulo xxxx.develop.lightning.force.com di URL Form xxxxmy.salesforce.com dell'URL come mostrato nella scheda Visualizza profilo. La connettività eterogenea gestita da Oracle supporta solo il form xxxxmy.salesforce.com dell'URL per il valore del parametro hostname.
   servicenow	Per connettersi a ServiceNow e ottenere i dati è necessario fornire i parametri del gateway directory_name e file_name. Questi parametri specificano un file modello (file di configurazione REST) che mappa la risposta JSON al modello relazionale. Il file modello specifica gli endpoint, il mapping delle tabelle e il codice di risposta HTTP per l'elaborazione della risposta JSON. Per ulteriori informazioni, vedere Sintassi dei file modello e File modello di esempio. Quando si utilizza il parametro gateway_params con db_type servicenow, sono supportate due opzioni: Autenticazione di base: è necessario fornire il parametro gateway_params db_type con il valore 'servicenow' e fornire i parametri directory_name e file_name insieme alle credenziali di tipo nome utente/password. Autenticazione OAuth 2.0: è necessario fornire il parametro gateway_params db_type con il valore 'servicenow' e i parametri directory_name, file_name e token_uri, insieme alle credenziali di tipo OAuth. Per l'autenticazione OAuth 2.0 con db_type servicenow, la credenziale deve essere una credenziale di tipo OAuth che utilizza il parametro params con i valori gcp_oauth2 specificati (client_id, client_secret e refresh_token). Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedure. Il parametro directory_name specifica la directory con il file di configurazione REST ServiceNow. È possibile creare questa directory come indicato di seguito. create or replace directory servicenow_dir as 'SERVICENOW_DIR'; Ottenere e scaricare il file di configurazione REST ServiceNow nella directory specificata. Ad esempio: exec DBMS_CLOUD.get_object('servicenow_dir_cred', 'https://objectstorage.<...>/servicenow.rest','SERVICENOW_DIR'); Impostare il valore file_name sul nome del file di configurazione REST scaricato, "servicenow.rest". Quindi è possibile utilizzare il file di configurazione REST ServiceNow con autenticazione di base o OAuth2.0. Per gli esempi, vedere HETEROGENEOUS_CONNECTIVITY_INFO View.
   sharepoint	Quando si utilizza il parametro gateway_params con db_type sharepoint, specificare anche i valori per auth_uri, scope, service_url e token_uri. Per db_type sharepoint, la credenziale fornita con DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK deve essere una credenziale di tipo OAuth che utilizza il parametro params con i valori gcp_oauth2 specificati (client_id, client_secret e refresh_token). Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedure. Generare il valore refresh_token per tenant_id.sharepoint.com/.default offline_access. Per ulteriori informazioni, vedere: Determinare l'ambito e OAuth 2.0 authentication. Impostare i valori per gateway_params per db_type sharepoint: auth_uri: impostare auth_uri da Azure. Per ulteriori informazioni, vedere Ottenere le informazioni e gli endpoint client dell'applicazione. scope: imposta l'ambito. Per ulteriori informazioni, vedere Descrizioni delle opzioni di connessione. service_url: impostare service_url. Per ulteriori informazioni, vedere URL servizio. token_uri: ottenere token_uri da Azure. Per ulteriori informazioni, vedere Ottenere le informazioni e gli endpoint client dell'applicazione.
   snowflake	Quando si utilizza il parametro gateway_params con db_type snowflake, utilizzare l'identificativo dell'account Snowflake come parametro hostname. In questo caso, il driver aggiunge snowflakecomupting.com, in modo da non passare esplicitamente questa parte del nome host. Per trovare l'identificativo dell'account Snowflake, vedere Formati identificativo account per piattaforma e area cloud. Ad esempio: per l'account Snowflake: https://example-marketing_test_account.snowflakecomputing.com Impostare il valore hostname su "example-marketing_test_account". Se db_type è SNOWFLAKE, sono validi i parametri facoltativi role, schema e warehouse. Questi valori specificano uno schema, un ruolo o un valore warehouse diverso da quello predefinito. Ad esempio: gateway_params => JSON_OBJECT( 'db_type' value 'snowflake', 'role' value 'ADMIN', 'schema' value 'PUBLIC', 'warehouse' value 'TEST' )
   youtube	Per connettersi a YouTube e ottenere i dati, è necessario fornire i parametri directory_name e file_name. Questi parametri specificano un file modello (file di configurazione REST) che mappa la risposta JSON al modello relazionale. Il file modello specifica gli endpoint, il mapping delle tabelle e il codice di risposta HTTP per l'elaborazione della risposta JSON. Per ulteriori informazioni, vedere Sintassi dei file modello e File modello di esempio. Per db_type youtube, la credenziale deve essere una credenziale di tipo OAuth che utilizza il parametro params con i valori gcp_oauth2 specificati (client_id, client_secret e refresh_token). Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedure. Il parametro directory_name specifica la directory con il file di configurazione REST di YouTube. Ad esempio, per creare questa directory e aggiungere i contenuti richiesti: Creare una directory nell'istanza di Autonomous Database: create or replace directory youtube_dir as 'YOUTUBE_DIR'; Ottenere e scaricare il file di configurazione REST di riposo automatico nella directory specificata. Ad esempio: exec DBMS_CLOUD.get_object('youtube_dir_cred', 'https://objectstorage.<...>/youtube.rest','YOUTUBE_DIR'); Impostare il valore file_name sul nome del file di configurazione REST scaricato, 'youtube.rest'. È quindi possibile utilizzare il file di configurazione REST con OAuth2.0. Per gli esempi, vedere HETEROGENEOUS_CONNECTIVITY_INFO View.

   Per ulteriori informazioni, vedere CREATE_DATABASE_LINK Procedure.

3. Utilizzare il database link per accedere ai dati nel database di destinazione.

   Ad esempio:

   SELECT count(*) FROM sales@AWSREDSHIFT_LINK

   Il nome della tabella specificato quando si utilizza SELECT con Google BigQuery deve essere tra virgolette. Ad esempio:

   SELECT count(*) FROM "sales"@GOOGLE_BIGQUERY_LINK

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

• Creare database link a Oracle MySQL su un endpoint privato con connettività eterogenea gestita da Oracle
  Il supporto di Autonomous Database per la connettività eterogenea gestita da Oracle semplifica la creazione di database link a Oracle MySQL Database Service su un endpoint privato. Quando si utilizzano i database link con connettività eterogenea gestita da Oracle, Autonomous Database configura e imposta la connessione a Oracle MySQL Database Service.
• Tipi e porte di database di connettività eterogenea gestiti da Oracle
  Mostra i database non Oracle a cui è possibile connettersi da Autonomous Database con connettività eterogenea gestita da Oracle ed elenca il valore della porta supportato per ciascun tipo di database. Fornisce inoltre un collegamento in cui è possibile visualizzare le versioni di database supportate per ciascun tipo di database.
• Accedi a informazioni ed esempi sulla connettività eterogenea
  Oracle Autonomous Database fornisce informazioni di connettività eterogenee per i database link a database non Oracle.