Die Autonomous Database-Unterstützung 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 username und password, die Sie mit DBMS_CLOUD.CREATE_CREDENTIAL angeben, sind die Zugangsdaten für die Zieldatenbank, die im Datenbanklink verwendet wird.

   Beispiel:

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

   Dieser Vorgang speichert die Zugangsdaten in einem verschlüsselten Format in der Datenbank. Sie können einen beliebigen Namen für den Zugangsdatennamen verwenden. Geben Sie den Parameter credential_name an.

   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.

   Beispiel:

   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.

   Beispiel: So erstellen Sie 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 Datenbankname der Nicht-Oracle-Datenbank.

   Der Wert gateway_params db_type, den Sie angeben, muss einer der unterstützten Werte sein:

   db_type Wert	Datenbanktyp
   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	Snowflake
   youtube	YouTube

   Autonomous Database konfiguriert und verarbeitet automatisch die sichere Verbindung zu einer Zieldatenbank, und Ihre Verbindungen werden durchgängig verschlüsselt. Die von Oracle verwaltete heterogene Konnektivität ist mit einem Wallet vorkonfiguriert, das die meisten gängigen 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 von Oracle verwalteter heterogener Konnektivität 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ätsdatenbanktypen und -ports.

   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 Heterogene Connectivity-Informationen und -Beispiele 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 angegebenem db_type
   azure	Wenn der db_type-Wert azure ist, gibt es zwei optionale Parameter, auth_method und domain zur Unterstützung der NTLM/AD-Authentifizierung. Wenn NTLMv2 konfiguriert ist, setzen Sie auth_method=10 und 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 für den Zugriff auf eine Oracle-On-Premise-Datenbank. Weitere Informationen finden Sie unter Microsoft SQL Server-Authentifizierungsmethode.
   google_analytics	Wenn der db_type-Wert google_analytics lautet, wird hostname nicht verwendet, und Sie können einen Wert wie example.com angeben. Bei db_type google_analytics müssen die Zugangsdaten ein OAuth-Typzugangsdaten mit dem Parameter params sein, wobei gcp_oauth2-Werte angegeben werden (client_id, client_secret und refresh_token). Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL.
   google_bigquery	Wenn db_type google_bigquery ist, ist der Parameter project gültig. Dieser Parameter gibt den Projektnamen in google_bigquery an und ist erforderlich. Wenn der db_type-Wert google_bigquery lautet, wird hostname nicht verwendet, und Sie können einen Wert wie example.com angeben. Bei db_type google_bigquery müssen die Zugangsdaten ein OAuth-Typzugangsdaten mit dem Parameter params sein, wobei gcp_oauth2-Werte angegeben werden (client_id, client_secret und refresh_token). 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 hive ist, 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. Beim Sicherheitstoken wird die Groß-/Kleinschreibung beachtet. 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: URL-Formular xxxx.develop.lightning.force.com xxxxmy.salesforce.com-URL-Form, wie auf der Registerkarte Profil anzeigen angezeigt. Die von Oracle verwaltete heterogene Konnektivität unterstützt nur das URL-Formular 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 Syntax der Modelldatei 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 des Typs 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 ein OAuth-Typzugangsdaten mit dem Parameter params sein, wobei gcp_oauth2-Werte angegeben werden (client_id, client_secret und refresh_token). 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. Beispiel: 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 entweder mit der Basisauthentifizierung oder mit OAuth2.0 verwenden. Beispiele finden Sie in der Ansicht HETEROGENEOUS_CONNECTIVITY_INFO.
   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. Bei db_type sharepoint 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. Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL. Generieren Sie die 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 aus Azure fest. Weitere Informationen finden Sie unter Anwendungsclientinformationen und -endpunkte abrufen. scope: Legen Sie den Geltungsbereich fest. Weitere Informationen finden Sie unter Beschreibungen der 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-ID-Formate nach Cloud-Plattform und -Region. Beispiel: für das Snowflake-Konto: https://example-marketing_test_account.snowflakecomputing.com Setzen Sie den Wert hostname auf "example-marketing_test_account". Wenn db_type SNOWFLAKE ist, sind die optionalen Parameter role, schema und warehouse gültig. Diese Werte geben einen anderen Schema-, Rollen- oder Warehouse-Wert als den Standardwert an. Beispiel: 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 Syntax der Modelldatei und Beispielmodelldatei. Bei db_type youtube müssen die Zugangsdaten ein OAuth-Typzugangsdaten mit dem Parameter params sein, wobei gcp_oauth2-Werte angegeben werden (client_id, client_secret und refresh_token). 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 in der Autonomous Database-Instanz: create or replace directory youtube_dir as 'YOUTUBE_DIR'; Rufen Sie die REST-Konfigurationsdatei für den automatischen Rest ab, und laden Sie sie in das angegebene Verzeichnis herunter. Beispiel: 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 Ansicht HETEROGENEOUS_CONNECTIVITY_INFO.

   Weitere Informationen finden Sie unter Prozedur CREATE_DATABASE_LINK.

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

   Beispiel:

   SELECT count(*) FROM sales@AWSREDSHIFT_LINK

   Der Tabellenname, den Sie angeben, wenn Sie SELECT mit Google BigQuery verwenden, muss in Anführungszeichen stehen. Beispiel:

   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 und richtet Autonomous Database die Verbindung zu Oracle MySQL Database Service ein.
• Von Oracle verwaltete heterogene Konnektivitätsdatenbanktypen und -ports
  Zeigt die Nicht-Oracle-Datenbanken an, zu denen Sie über Autonomous Database mit von Oracle verwalteter heterogener Konnektivität eine Verbindung herstellen können, und listet den unterstützten Portwert für jeden Datenbanktyp auf. Stellt außerdem einen Link bereit, über den Sie die unterstützten Datenbankversionen für jeden Datenbanktyp anzeigen können.
• Auf heterogene Konnektivitätsinformationen und -beispiele zugreifen
  Oracle Autonomous Database bietet heterogene Konnektivitätsinformationen für Datenbanklinks zu Nicht-Oracle-Datenbanken.