Die Unterstützung von Autonomous Database für von Oracle verwaltete heterogene Konnektivität erleichtert das Erstellen von Datenbanklinks zu Nicht-Oracle-Datenbanken.

1. Erstellen Sie in Autonomous Database Zugangsdaten für den Zugriff auf die Zieldatenbank. Die Werte username und password, die Sie mit DBMS_CLOUD.CREATE_CREDENTIAL angeben, sind die Zugangsdaten für die Zieldatenbank, die im Datenbanklink verwendet werden.

   Beispiele:

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

   Dieser Vorgang speichert die Zugangsdaten in verschlüsseltem Format in der Datenbank. Sie können einen beliebigen Namen als Zugangsdatenname verwenden. Sie müssen den Parameter credential_name angeben.

   Um auf Google Analytics, Google BigQuery, Google Drive, Youtube, ServiceNow oder Microsoft SharePoint mit OAuth2 zuzugreifen, müssen die Zugangsdaten den Parameter params mit dem Wert gcp_oauth2 enthalten.

   Beispiele:

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

   Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL.

2. Erstellen Sie den Datenbanklink zur Zieldatenbank mit DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

   So erstellen Sie z.B. einen Datenbanklink zu 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 ist der Name der Datenbank, die nicht von Oracle stammt.

   Der von Ihnen angegebene db_type-Wert gateway_params muss einer der unterstützten Werte sein:

   db_type-Wert	Datenbankart
   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	Schneeflocke
   youtube	YouTube

   Autonomous Database konfiguriert und verarbeitet automatisch die sichere Verbindung zu einer Zieldatenbank, und Ihre Verbindungen sind durchgängig verschlüsselt. Oracle-verwaltete heterogene Konnektivität ist mit einem Wallet vorkonfiguriert, das die meisten allgemeinen vertrauenswürdigen Root- und Zwischen-SSL-Zertifikate enthält. Daher muss NULL als Wert für den Parameter ssl_server_cert_dn angegeben werden.

   Um die Sicherheit bei der Verwendung von Datenbanklinks mit der von Oracle verwalteten heterogenen Verbindung sicherzustellen, ist der Verbindungsport eingeschränkt, und SSL/TLS muss aktiviert sein. Sie geben den Zieldatenbankport mit dem Parameter port an.

   Eine Liste der unterstützten Nicht-Oracle-Datenbanktypen finden Sie unter Von Oracle verwaltete heterogene Konnektivität - Datenbanktypen.

   Die Ansicht HETEROGENEOUS_CONNECTIVITY_INFO enthält Informationen zu unterstützten Oracle Heterogeneous Connectivity-Typen und zeigt ein PL/SQL-Codebeispiel für jeden unterstützten Typ an. Weitere Informationen finden Sie unter Auf Informationen und Beispiele für heterogene Konnektivität zugreifen.

   Wenn Sie den Parameter gateway_params angeben, werden für einige db_type-Werte zusätzliche gateway_params-Parameter unterstützt:

   db_type-Wert	Unterstützte Gatewayparameter mit angegebener db_type
   azure	Wenn der db_type-Wert azure lautet, gibt es zwei optionale Parameter: auth_method und domain zur Unterstützung der NTLM/AD-Authentifizierung. Wenn NTLMv2 konfiguriert ist, legen Sie auth_method=10 fest, und setzen Sie domain auf den Windows-Domainwert. Um ein Azure Active Directory-Kennwort zu verwenden, legen Sie auth_method=13 fest. Verwenden Sie auth_method=13 nicht, um auf eine Oracle-On-Premise-Datenbank zuzugreifen. Weitere Informationen finden Sie unter Microsoft SQL Server-Authentifizierungsmethode.
   google_analytics	Wenn der Wert für db_type google_analytics lautet, wird hostname nicht verwendet, und Sie können einen Wert wie example.com angeben. Für db_type google_analytics müssen die Zugangsdaten eine Zugangsdaten vom Typ OAuth sein, die den Parameter params mit den angegebenen gcp_oauth2-Werten (client_id, client_secret und refresh_token) verwenden. Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL.
   google_bigquery	Wenn db_type den Wert google_bigquery hat, ist der Parameter project gültig. Dieser Parameter gibt den Projektnamen auf google_bigquery an und ist erforderlich. Wenn der Wert für db_type google_bigquery lautet, wird hostname nicht verwendet, und Sie können einen Wert wie example.com angeben. Für db_type google_bigquery müssen die Zugangsdaten eine Zugangsdaten vom Typ OAuth sein, die den Parameter params mit den angegebenen gcp_oauth2-Werten (client_id, client_secret und refresh_token) verwenden. Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL.
   google_drive	Bei db_type google_drive müssen die Zugangsdaten, die Sie mit DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK angeben, Zugangsdaten vom Typ OAuth sein, die den Parameter params mit angegebenen gcp_oauth2-Werten (client_id, client_secret und refresh_token) verwenden. Um eine Verbindung zu Google Drive herzustellen und Daten abzurufen, müssen Sie die Gatewayparameter directory_name und file_name angeben. Diese Parameter geben eine Modelldatei (automatische REST-Datei) an, mit der die JSON-Antwort dem relationalen Modell zugeordnet wird. Die Modelldatei gibt die Endpunkte, die Tabellenzuordnung und den HTTP-Antwortcode für die Verarbeitung der JSON-Antwort an. Weitere Informationen finden Sie unter Syntax der Modelldatei und Beispielmodelldatei. Wenn Sie den Parameter gateway_params mit db_type google_drive verwenden, müssen Sie den Parameter gateway_params db_type mit den Parametern 'google_drive' und directory_name und file_name sowie den Zugangsdaten des Typs OAuth angeben: Der Parameter directory_name gibt das Verzeichnis mit der REST-Konfigurationsdatei an. Sie können dieses Verzeichnis wie folgt erstellen: create or replace directory google_drive_dir as 'GOOGLE_DRIVE_DIR'; Rufen Sie die automatische REST-Datei ab, und laden Sie sie in das angegebene Verzeichnis herunter. Beispiel: exec DBMS_CLOUD.get_object('google_drive_dir_cred', 'https://objectstorage.<...>/google_drive.rest','GOOGLE_DRIVE_DIR'); Setzen Sie den Wert file_name auf den Namen der automatisch heruntergeladenen REST-Datei, "google_drive.rest". Anschließend können Sie die REST-Konfigurationsdatei mit OAuth 2.0 verwenden.
   hive	Wenn db_type den Wert hive hat, ist der Parameter http_path gültig. Dieser Parameter gibt den Wert HttpPath an, falls erforderlich, um eine Verbindung zur Hive-Instanz herzustellen.
   salesforce	Wenn Sie den Parameter gateway_params mit db_type salesforce verwenden, müssen Sie die Option security_token angeben. Das Sicherheitstoken ist ein alphanumerischer Code, bei dem die Groß-/Kleinschreibung beachtet wird. Weitere Informationen finden Sie unter Sicherheitstoken zurücksetzen. Wenn Sie den Parameter gateway_params mit db_type salesforce verwenden, müssen Sie den richtigen Parameter hostname angeben. Salesforce stellt zwei Formen von URLs für den Salesforce-Serviceaccount bereit: xxxx.develop.lightning.force.com-Formular der URL URL-Form xxxxmy.salesforce.com, wie auf der Registerkarte Profil anzeigen dargestellt. Von Oracle verwaltete heterogene Konnektivität unterstützt nur die URL-Form xxxxmy.salesforce.com für den Parameterwert hostname.
   servicenow	Um eine Verbindung zu ServiceNow herzustellen und Daten abzurufen, müssen Sie die Gatewayparameter directory_name und file_name angeben. Diese Parameter geben eine Modelldatei (REST-Konfigurationsdatei) an, mit der die JSON-Antwort dem relationalen Modell zugeordnet wird. Die Modelldatei gibt die Endpunkte, die Tabellenzuordnung und den HTTP-Antwortcode für die Verarbeitung der JSON-Antwort an. Weitere Informationen finden Sie unter Modelldateisyntax und Beispielmodelldatei. Wenn Sie den Parameter gateway_params mit db_type servicenow verwenden, werden zwei Optionen unterstützt: Basisauthentifizierung: Sie müssen den Parameter gateway_params db_type mit dem Wert 'servicenow' angeben und die Parameter directory_name und file_name zusammen mit Zugangsdaten vom Typ "Benutzername/Kennwort" angeben. OAuth 2.0-Authentifizierung: Sie müssen den Parameter gateway_params db_type mit dem Wert 'servicenow' und den Parametern directory_name, file_name und token_uri sowie Zugangsdaten vom Typ OAuth angeben. Bei der OAuth 2.0-Authentifizierung mit db_type servicenow müssen die Zugangsdaten mit dem Parameter params und den angegebenen gcp_oauth2-Werten (client_id, client_secret und refresh_token) den Typ OAuth aufweisen. Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL. Der Parameter directory_name gibt das Verzeichnis mit der REST-Konfigurationsdatei ServiceNow an. Sie können dieses Verzeichnis wie folgt erstellen: create or replace directory servicenow_dir as 'SERVICENOW_DIR'; Rufen Sie die REST-Konfigurationsdatei ServiceNow ab, und laden Sie sie in das angegebene Verzeichnis herunter. Beispiele: exec DBMS_CLOUD.get_object('servicenow_dir_cred', 'https://objectstorage.<...>/servicenow.rest','SERVICENOW_DIR'); Setzen Sie den Wert file_name auf den Namen der heruntergeladenen REST-Konfigurationsdatei, "servicenow.rest". Anschließend können Sie die REST-Konfigurationsdatei ServiceNow mit Basisauthentifizierung oder OAuth2.0 verwenden. Beispiele finden Sie in der HETEROGENEOUS_CONNECTIVITY_INFO-Ansicht.
   sharepoint	Wenn Sie den Parameter gateway_params mit db_type sharepoint verwenden, geben Sie auch Werte für auth_uri, scope, service_url und token_uri an. Für db_type sharepoint müssen die Zugangsdaten, die Sie mit DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK angeben, Zugangsdaten vom Typ OAuth sein, wobei der Parameter params mit den angegebenen gcp_oauth2-Werten (client_id, client_secret und refresh_token) verwendet wird. Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL. Generieren Sie refresh_token für tenant_id.sharepoint.com/.default offline_access. Weitere Informationen finden Sie unter Geltungsbereich bestimmen und OAuth 2.0-Authentifizierung. Legen Sie Werte für gateway_params für db_type sharepoint fest: auth_uri: Legen Sie auth_uri in Azure fest. Weitere Informationen finden Sie unter Anwendungsclientinformationen und -endpunkte abrufen. scope: Legen Sie den Geltungsbereich fest. Weitere Informationen finden Sie unter Beschreibungen zu Verbindungsoptionen. service_url: Legen Sie service_url fest. Weitere Informationen finden Sie unter Service-URL. token_uri: Rufen Sie token_uri von Azure ab. Weitere Informationen finden Sie unter Anwendungsclientinformationen und -endpunkte abrufen.
   snowflake	Wenn Sie den Parameter gateway_params mit db_type snowflake verwenden, verwenden Sie die Snowflake-Account-ID als Parameter hostname. In diesem Fall fügt der Treiber snowflakecomupting.com hinzu, sodass Sie diesen Teil des Hostnamens nicht explizit übergeben. Informationen zum Suchen Ihrer Snowflake-Account-ID finden Sie unter Account Identifier Formats by Cloud Platform and Region. Beispiel: Für den Snowflake-Account: https://example-marketing_test_account.snowflakecomputing.com Setzen Sie den Wert hostname auf "example-marketing_test_account". Wenn db_type den Wert SNOWFLAKE hat, sind die optionalen Parameter role, schema und warehouse gültig. Diese Werte geben einen anderen Schema-, Rollen- oder Warehouse-Wert als den Standardwert an. Beispiele: gateway_params => JSON_OBJECT( 'db_type' value 'snowflake', 'role' value 'ADMIN', 'schema' value 'PUBLIC', 'warehouse' value 'TEST' )
   youtube	Um eine Verbindung zu YouTube herzustellen und Daten abzurufen, müssen Sie die Parameter directory_name und file_name angeben. Diese Parameter geben eine Modelldatei (REST-Konfigurationsdatei) an, mit der die JSON-Antwort dem relationalen Modell zugeordnet wird. Die Modelldatei gibt die Endpunkte, die Tabellenzuordnung und den HTTP-Antwortcode für die Verarbeitung der JSON-Antwort an. Weitere Informationen finden Sie unter Modelldateisyntax und Beispielmodelldatei. Für db_type youtube müssen die Zugangsdaten eine Zugangsdaten vom Typ OAuth sein, die den Parameter params mit den angegebenen gcp_oauth2-Werten (client_id, client_secret und refresh_token) verwenden. Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL. Der Parameter directory_name gibt das Verzeichnis mit der Youtube-REST-Konfigurationsdatei an. Beispiel: So erstellen Sie dieses Verzeichnis und fügen den erforderlichen Inhalt hinzu: Erstellen Sie ein Verzeichnis auf der Autonomous Database-Instanz: create or replace directory youtube_dir as 'YOUTUBE_DIR'; Rufen Sie die automatische Rest-REST-Konfigurationsdatei ab, und laden Sie sie in das angegebene Verzeichnis herunter. Beispiele: exec DBMS_CLOUD.get_object('youtube_dir_cred', 'https://objectstorage.<...>/youtube.rest','YOUTUBE_DIR'); Setzen Sie den Wert file_name auf den Namen der heruntergeladenen REST-Konfigurationsdatei, 'youtube.rest'. Anschließend können Sie die REST-Konfigurationsdatei mit OAuth2.0 verwenden. Beispiele finden Sie in der HETEROGENEOUS_CONNECTIVITY_INFO-Ansicht.

   Weitere Informationen finden Sie unter Prozedur CREATE_DATABASE_LINK.

3. Verwenden Sie den Datenbanklink, um auf Daten in der Zieldatenbank zuzugreifen.

   Beispiele:

   SELECT count(*) FROM sales@AWSREDSHIFT_LINK

   Der Tabellenname, den Sie bei der Verwendung von SELECT mit Google BigQuery angeben, muss in Anführungszeichen stehen. Beispiele:

   SELECT count(*) FROM "sales"@GOOGLE_BIGQUERY_LINK

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

• Datenbanklinks zu Oracle MySQL auf einem privaten Endpunkt mit von Oracle verwalteter heterogener Konnektivität erstellen
  Die Unterstützung von Autonomous Database für von Oracle verwaltete heterogene Konnektivität erleichtert das Erstellen von Datenbanklinks zu Oracle MySQL Database Service auf einem privaten Endpunkt. Wenn Sie Datenbanklinks mit von Oracle verwalteter heterogener Konnektivität verwenden, konfiguriert Autonomous Database die Verbindung zu Oracle MySQL Database Service und richtet sie ein.
• Von Oracle verwaltete heterogene Konnektivität - Datenbanktypen und Ports
  Zeigt die nicht von Oracle stammenden Datenbanken an, zu denen Sie von Autonomous Database eine Verbindung mit von Oracle verwalteter heterogener Konnektivität herstellen können, und listet den unterstützten Portwert für jede Datenbankart auf. Stellt außerdem einen Link bereit, über den die unterstützten Datenbankversionen für jeden Datenbanktyp angezeigt werden.
• Auf heterogene Konnektivitätsinformationen und Beispiele zugreifen
  Oracle Autonomous Database bietet heterogene Konnektivitätsinformationen für Datenbanklinks zu Nicht-Oracle-Datenbanken.