Datenbanklinks zu Nicht-Oracle AI-Datenbanken mit Oracle verwalteter heterogener Konnektivität erstellen

Die Unterstützung der autonomen KI-Datenbank für von Oracle verwaltete heterogene Konnektivität erleichtert das Erstellen von Datenbanklinks zu Nicht-Oracle-Datenbanken.

Wenn Sie Datenbanklinks mit von Oracle verwalteter heterogener Konnektivität verwenden, konfiguriert und richtet Autonomous AI Database die Verbindung zur Nicht-Oracle-Datenbank ein.

Hinweis

Hinweis: Bei von Oracle verwalteter heterogener Konnektivität werden nur abfrageschützte Verbindungen in der Remotedatenbank unterstützt. Das heißt, Updates werden nicht unterstützt, wenn von Oracle verwaltete heterogene Konnektivität verwendet wird.

Die folgenden Voraussetzungen sind für die Verwendung von von Oracle verwalteter heterogener Konnektivität mit Autonomous AI Database erforderlich:

Wenn sich die Zieldatenbank auf einem öffentlichen Endpunkt befindet, muss die Datenbank so konfiguriert werden, dass eingehende SSL/TLS-Verbindungen mit CA-signierten Zertifikaten zulässig sind.

Von Oracle verwaltete heterogene Konnektivität unterstützt Verbindungen zu Zieldatenbankservices auf privaten Endpunkten (Beispiel: Sie können eine Verbindung zu Oracle MySQL Database Service herstellen, wenn sich der Service auf einem privaten Endpunkt befindet). Wenn Sie eine Verbindung zu einer Nicht-oracle-Datenbank mit von Oracle verwalteter heterogener Konnektivität auf einem privaten Endpunkt herstellen, verwendet die Verbindung das TCP-Protokoll, und SSL/TLS muss nicht in der Zieldatenbank konfiguriert werden.

Weitere Informationen finden Sie unter Datenbanklinks zu Oracle MySQL an einem privaten Endpunkt mit von Oracle verwalteter heterogener Konnektivität erstellen.
Wenn sich die Zieldatenbank auf einem privaten Endpunkt befindet und so konfiguriert ist, dass SSL-basierte Verbindungen durchgesetzt werden, verwenden Sie den Parameter gateway_params mit dem Namen enable_ssl, und setzen Sie ihn auf TRUE. Beispiel:
```
gateway_params => JSON_OBJECT(
     'db_type' value 'snowflake',
     'enable_ssl' value true)
```
Weitere Informationen finden Sie unter Prozedur CREATE_DATABASE_LINK.
Wenn sich die Zieldatenbank auf einem privaten Endpunkt befindet und so konfiguriert ist, dass SSL-basierte Verbindungen durchgesetzt werden, verwenden Sie den Parameter gateway_params mit dem Namen enable_ssl, und setzen Sie ihn auf "true".

Weitere Informationen finden Sie unter Prozedur CREATE_DATABASE_LINK.

Um Datenbanklinks zu einer Nicht-Oracle-Datenbank mit von Oracle verwalteter heterogener Konnektivität zu erstellen, gehen Sie wie folgt vor:

Erstellen Sie in der autonomen KI-Datenbank 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 als Zugangsdatenname 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.

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
`box`	Feld
`cassandra`	Apache Cassandra
`databricks`	Databricks
`db2`	IBM Db2
`google_analytics`	Google Analytics
`google_bigquery`	Google BigQuery
`google_drive`	Google Drive
`hive`	Apache Hive
`mongodb`	MongoDB
`mysql`	MySQL Der Datentyp `VECTOR` wird für `db_type=mysql` nicht unterstützt. Weitere Informationen finden Sie unter VECTOR Type.
`mysql_community`	MySQL Community Edition
`postgres`	PostgreSQL
`salesforce`	Salesforce
`servicenow`	ServiceNow
`sharepoint`	Microsoft SharePoint
`snowflake`	Snowflake
`youtube`	YouTube

Die autonome KI-Datenbank 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-Typ sein, der den Parameter `params` mit den angegebenen `gcp_oauth2`-Werten (`client_id`, `client_secret` und `refresh_token`) verwendet. 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-Typ sein, der den Parameter `params` mit den angegebenen `gcp_oauth2`-Werten (`client_id`, `client_secret` und `refresh_token`) verwendet. 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 HttpPath-Wert 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` Form der URL, wie unter 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-Typ sein, der den Parameter `params` mit angegebenen `gcp_oauth2`-Werten (`client_id`, `client_secret` und `refresh_token`) verwendet. 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 ServiceNow-REST-Konfigurationsdatei entweder mit Basisauthentifizierung oder mit OAuth2.0 verwenden. Beispiele finden Sie unter 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, mit dem Parameter `params` und den angegebenen `gcp_oauth2`-Werten (`client_id`, `client_secret` und `refresh_token`) ein OAuth-Typ sein. Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL. Generieren Sie die Datei `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 `lakehouse` gültig. Diese Werte geben ein anderes Schema, eine andere Rolle oder einen anderen Lakehouse-Wert als den Standardwert an. Beispiel: `gateway_params => JSON_OBJECT( 'db_type' value 'snowflake', 'role' value 'ADMIN', 'schema' value 'PUBLIC', 'lakehouse' 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-Typ sein, der den Parameter `params` mit den angegebenen `gcp_oauth2`-Werten (`client_id`, `client_secret` und `refresh_token`) verwendet. 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 Instanz der autonomen KI-Datenbank: `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 unter Ansicht HETEROGENEOUS_CONNECTIVITY_INFO.
`box`	Um eine Verbindung zu Box 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` `box` müssen die Zugangsdaten ein OAuth-Typ sein, der den Parameter `params` mit den angegebenen `gcp_oauth2`-Werten (`client_id`, `client_secret` und `refresh_token`) verwendet. Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL. Der Parameter `directory_name` gibt das Verzeichnis mit der Feld-REST-Konfigurationsdatei an. Beispiel: So erstellen Sie dieses Verzeichnis und fügen den erforderlichen Inhalt hinzu: Erstellen Sie ein Verzeichnis in der Instanz der autonomen KI-Datenbank: `create or replace directory box_dir as 'BOX_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('box_dir_cred', 'https://objectstorage.<...>/box.rest','BOX_DIR');` Setzen Sie den Wert `file_name` auf den Namen der heruntergeladenen REST-Konfigurationsdatei `'box.rest'`. Anschließend können Sie die REST-Konfigurationsdatei mit OAuth2.0 verwenden. Beispiele finden Sie unter Ansicht HETEROGENEOUS_CONNECTIVITY_INFO.
`databricks`	Um eine Verbindung zu Databricks 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` `box` müssen die Zugangsdaten ein OAuth-Typ sein, der den Parameter `params` mit den angegebenen `gcp_oauth2`-Werten (`client_id`, `client_secret` und `refresh_token`) verwendet. Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL. Der Parameter `directory_name` gibt das Verzeichnis mit der Feld-REST-Konfigurationsdatei an. Beispiel: So erstellen Sie dieses Verzeichnis und fügen den erforderlichen Inhalt hinzu: Erstellen Sie ein Verzeichnis in der Instanz der autonomen KI-Datenbank: `create or replace directory databricks_dir as 'BOX_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('databricks_dir_cred', 'https://objectstorage.<...>/databricks.rest','DATABRICKS_DIR');` Setzen Sie den Wert `file_name` auf den Namen der heruntergeladenen REST-Konfigurationsdatei `'databricks.rest'`. Anschließend können Sie die REST-Konfigurationsdatei mit OAuth2.0 verwenden. Beispiele finden Sie unter Ansicht HETEROGENEOUS_CONNECTIVITY_INFO.

Weitere Informationen finden Sie unter Prozedur CREATE_DATABASE_LINK.

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

Beispiel:
```
SELECT count(*) FROM sales@AWSREDSHIFT_LINK
```
Der Tabellenname, den Sie in einer SELECT-Anweisung angeben, muss ordnungsgemäß als ID angegeben werden. Dies gilt für Google BigQuery, MySQL und PostgreSQL. Beispiel:
```
SELECT count(*) FROM "sales"@GOOGLE_BIGQUERY_LINK
```
Hinweis

Hinweis:

Für die Zugangsdaten, die Sie in Schritt 1 erstellen, die Zieldatenbankzugangsdaten. Wenn sich das Kennwort des Zielbenutzers ändert, können Sie die Zugangsdaten mit den Zugangsdaten des Zielbenutzers folgendermaßen aktualisieren:
```
BEGIN
  DBMS_CLOUD.UPDATE_CREDENTIAL (
    credential_name => 'AWS_REDSHIFT_LINK_CRED',
    attribute => 'PASSWORD',
    value => 'password');
END;
/
```
Dabei ist password das neue Kennwort.

Nach diesem Vorgang funktionieren die vorhandenen Datenbanklinks, die diese Zugangsdaten verwenden, weiter, ohne die Datenbanklinks löschen und neu erstellen zu müssen.
Weitere Informationen finden Sie hier:
- Unterstützte SQL-Syntax und -Funktionen in der Oracle AI Database Gateway for ODBC-Benutzerdokumentation
- Prozedur CREATE_DATABASE_LINK
- Prozedur UPDATE_CREDENTIAL

Datenbanklinks zu Oracle MySQL auf einem privaten Endpunkt mit von Oracle verwalteter heterogener Konnektivität erstellen

Die Unterstützung der autonomen KI-Datenbank 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 AI Database die Verbindung zu Oracle MySQL Database Service ein.

Die folgenden Voraussetzungen sind erforderlich, um von Oracle verwaltete heterogene Konnektivität mit Oracle MySQL Database Service auf einem privaten Endpunkt zu verwenden:

Erstellen Sie einen DNS-Namen mit einer privaten DNS-Zone, die auf die private IP von Oracle MySQL Database Service in Ihrem VCN verweist. Siehe Privates DNS.
Erstellen Sie eine autonome KI-Datenbank mit einem privaten Endpunkt in demselben Subnetz.
Konfigurieren Sie das VCN für Oracle MySQL Database Service so, dass eingehende Verbindungen auf Port 3306 zulässig sind.

Um Datenbanklinks zu einem Oracle MySQL Database Service auf einem privaten Endpunkt mit von Oracle verwalteter heterogener Konnektivität zu erstellen, gehen Sie wie folgt vor:
1. Erstellen Sie in der autonomen KI-Datenbank Zugangsdaten für den Zugriff auf Oracle MySQL Database Service. Die username und password, die Sie mit DBMS_CLOUD.CREATE_CREDENTIAL angeben, sind die Zugangsdaten für den Oracle MySQL Database Service, der im Datenbanklink verwendet wird.
  
  Hinweis
  
  Hinweis: Die Angabe des Parameters credential_name ist erforderlich.
  
  Beispiel:
```
BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'MYSQL_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 als Zugangsdatenname verwenden.
2. Erstellen Sie den Datenbanklink zu Oracle MySQL Database Service mit DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.
  
  Beispiel: So erstellen Sie einen Datenbank-Link:
```
BEGIN
     DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
          db_link_name => 'MYSQL_LINK',
          hostname => '*mysql.example.com*',
          port => '3306',
          service_name => '*mysql.example_service_name*',
          ssl_server_cert_dn => NULL,
          credential_name => 'MYSQL_LINK_CRED',
          private_target => TRUE,
          gateway_params => JSON_OBJECT('db_type' value 'mysql'));
END;
/
```
3. Verwenden Sie den Datenbanklink, um auf Daten in der Zieldatenbank zuzugreifen.
  
  Beispiel:
```
SELECT count(*) FROM sales@MYSQL_LINK
```
  Hinweis
  
  Hinweis:
  
  Für die Zugangsdaten, die Sie in Schritt 1 erstellen, die Zieldatenbankzugangsdaten. Wenn sich das Kennwort des Zielbenutzers ändert, können Sie die Zugangsdaten mit den Zugangsdaten des Zielbenutzers folgendermaßen aktualisieren:
```
BEGIN
  DBMS_CLOUD.UPDATE_CREDENTIAL (
    credential_name => 'MYSQL_LINK_CRED',
    attribute => 'PASSWORD',
    value => 'password');
END;
/
```
  wobei password das neue Passwort ist.
  
  Nach diesem Vorgang funktionieren die vorhandenen Datenbanklinks, die diese Zugangsdaten verwenden, weiter, ohne die Datenbanklinks löschen und neu erstellen zu müssen.
  Weitere Informationen finden Sie hier:
  - Unterstützte SQL-Syntax und -Funktionen in der Oracle AI Database Gateway for ODBC-Benutzerdokumentation
  - Prozedur CREATE_DATABASE_LINK
  - Prozedur UPDATE_CREDENTIAL

Von Oracle verwaltete heterogene Konnektivitätsdatenbanktypen und -ports

Zeigt die Nicht-Oracle-Datenbanken an, zu denen Sie über eine autonome KI-Datenbank 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.

Hinweis

Hinweis: Oracle verwendet Progress DataDirect-Connectors. Die Spalte "Datenbankunterstützung" enthält Links zur Progress-Website, auf der Sie die unterstützten Datenbankversionen für jeden Datenbanktyp finden.

Datenbanktyp	db_type Wert	Erforderlicher Port	Datenbankunterstützung
Amazon Redshift	`awsredshift`	5.439	Von Amazon Redshift unterstützte Versionen
Azure-SQL Microsoft-SQL-Server Azure Synapse Analytics	`azure`	1.433	Unterstützte Azure SQL-Versionen Unterstützte Versionen von Azure Synapse Analytics
Apache Cassandra	`cassandra`	9.042	Cassandra Unterstützte Versionen
Apache Hive	`hive`	443	Von Hive unterstützte Versionen
Google Analytics	`google_analytics`	443	Unterstützte Versionen von Google Analytics
Google BigQuery	`google_bigquery`	443	Von Google BigQuery unterstützte Versionen
Google Drive	`google_drive`	443	Von Google Drive unterstützte Versionen
Apache Hive	`hive`	443	Von Hive unterstützte Versionen
IBM Db2 11.5.6 oder höher IBM Db2 11.5.5 oder weniger	`db2`	25.000 50.000	Von IBM Db2 unterstützte Versionen
Microsoft SharePoint	`sharepoint`	443	Von Microsoft SharePoint unterstützte Versionen
MongoDB	`mongodb`	27.017	MongoDB-unterstützte Versionen
MySQL	`mysql`	3.306	Von MySQL unterstützte Versionen
MySQL Community Edition	`mysql_community`	3.306
PostgreSQL	`postgres`	5.432	Von PostgreSQL unterstützte Versionen
Salesforce	`salesforce`	19.937	Von Salesforce unterstützte Versionen
ServiceNow	`servicenow`	443	Unterstützte ServiceNow-Versionen
Snowflake	`snowflake`	443	Von Snowflake unterstützte Versionen
Youtube	`youtube`	443	Von YouTube unterstützte Versionen
Feld	`box`	443	VirtualBox - Unterstützte Versionen
Databricks	`databricks`	443	Versionen und Kompatibilität der Databricks Runtime-Versionen

Auf heterogene Konnektivitätsinformationen und -beispiele zugreifen

Oracle Autonomous AI Database bietet heterogene Konnektivitätsinformationen für Datenbanklinks zu Nicht-Oracle-Datenbanken.

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.

Beispiel:

SELECT * FROM HETEROGENEOUS_CONNECTIVITY_INFO WHERE DATABASE_TYPE = 'hive';

HETEROGENEOUS_CONNECTIVITY_INFO Ansicht

In der Ansicht HETEROGENEOUS_CONNECTIVITY_INFO werden Konnektivitätsinformationen und Beispiele für die Verbindung mit PL/SQL über Datenbanklinks und von Oracle verwaltete heterogene Konnektivität aufgeführt.

Spalte	Datentyp	Beschreibung
`DATABASE_TYPE`	`VARCHAR2(32)`	Wert des Datenbanktyps, der mit dem Parameter `gateway_params` verwendet wird.
`REQUIRED_PORT`	`NUMBER`	Unterstützte Portwerte für den Datenbanktyp.
`DESCRIPTION`	`CLOB`	Gibt eine Beschreibung für die `DATABASE_TYPE` an.
`OPTIONAL_PARAMETERS`	`VARCHAR2(1024)`	Gibt die gültigen optionalen Parameter für die `DATABASE_TYPE` an.
`SAMPLE_USAGE`	`CLOB`	Zeigt Beispiel-PL/SQL-Verwendung für die `DATABASE_TYPE` an.

Oracle Cloud Infrastructure-Dokumentation

Datenbanklinks zu Nicht-Oracle AI-Datenbanken mit Oracle verwalteter heterogener Konnektivität erstellen

Datenbanklinks zu Oracle MySQL auf einem privaten Endpunkt mit von Oracle verwalteter heterogener Konnektivität erstellen

Von Oracle verwaltete heterogene Konnektivitätsdatenbanktypen und -ports

Auf heterogene Konnektivitätsinformationen und -beispiele zugreifen

HETEROGENEOUS_CONNECTIVITY_INFO Ansicht