Oracle管理の異種間接続に対するAutonomous Databaseのサポートにより、Oracle以外のデータベースへのデータベース・リンクの作成が容易になります。

1. Autonomous Databaseで、ターゲット・データベースにアクセスするための資格証明を作成します。DBMS_CLOUD.CREATE_CREDENTIALで指定するusernameおよびpasswordは、データベース・リンク内で使用されるターゲット・データベースの資格証明です。

   次に例を示します。

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

   この操作では、暗号化された形式で資格証明がデータベースに格納されます。資格証明名には任意の名前を使用できます。credential_nameパラメータの指定は必須です。

   OAuth2を使用してGoogle Analytics、Google BigQuery、Youtube、ServiceNowまたはMicrosoft SharePointにアクセスするには、資格証明にgcp_oauth2という値を持つparamsパラメータが含まれている必要があります。

   次に例を示します。

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

   詳細は、CREATE_CREDENTIALプロシージャを参照してください。

2. DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINKを使用して、ターゲット・データベースへのデータベース・リンクを作成します。

   たとえば、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は、Oracle以外のデータベースのデータベース名です。

   指定するgateway_paramsのdb_type値は、サポートされている値のいずれかである必要があります:

   db_type値	データベース・タイプ
   awsredshift	Amazon Redshift
   azure	Microsoft SQL Server Azure SQL Azure Synapse Analytics
   db2	IBM Db2
   google_analytics	Google Analytics
   google_bigquery	Google BigQuery
   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は、ターゲット・データベースへのセキュアな接続を自動的に構成して処理し、接続はエンドツーエンドで暗号化されます。Oracle管理の異種間接続は、一般的な信頼できるルート証明書と中間SSL証明書の大部分を含むウォレットで事前構成されています。したがって、ssl_server_cert_dnパラメータの値としてNULLを指定する必要があります。

   Oracle管理の異種間接続でデータベース・リンクを使用する場合のセキュリティを確保するために、接続ポートは制限されており、SSL/TLSが有効になっている必要があります。portパラメータでターゲット・データベース・ポートを指定します。

   サポートされるOracle以外のデータベース・タイプのリストは、Oracle管理の異種間接続のデータベース・タイプおよびポートを参照してください。

   HETEROGENEOUS_CONNECTIVITY_INFOビューは、サポートされているOracle異機種間接続タイプに関する情報を提供し、サポートされている各タイプのPL/SQLコード・サンプルを示します。詳細は、「異機種間接続情報およびサンプルへのアクセス」を参照してください。

   gateway_paramsパラメータを指定すると、一部のdb_type値に対して、追加のgateway_paramsパラメータがサポートされます。

   db_type値	指定されたdb_typeでサポートされるゲートウェイ・パラメータ
   azure	db_type値がazureの場合、NTLM/AD認証をサポートするためのauth_methodおよびdomainの2つのオプション・パラメータがあります。 NTLMv2が構成されている場合は、auth_method=10を設定し、domainをWindowsドメイン値に設定します。
   google_analytics	db_type値がgoogle_analyticsの場合、hostnameは使用されず、example.comなどの値を指定できます。 db_type google_analyticsの場合、資格証明は、gcp_oauth2値(client_id、client_secretおよびrefresh_token)を指定してparamsパラメータを使用するOAuthタイプの資格証明である必要があります。詳細は、CREATE_CREDENTIALプロシージャを参照してください。
   google_bigquery	db_typeがgoogle_bigqueryの場合、パラメータprojectは有効です。このパラメータは、google_bigqueryのプロジェクト名を指定します。これは必須です。 db_type値がgoogle_bigqueryの場合、hostnameは使用されず、example.comなどの値を指定できます。 db_type google_bigqueryの場合、資格証明は、gcp_oauth2値(client_id、client_secretおよびrefresh_token)を指定してparamsパラメータを使用するOAuthタイプの資格証明である必要があります。詳細は、CREATE_CREDENTIALプロシージャを参照してください。
   hive	db_typeがhiveの場合、パラメータhttp_pathは有効です。このパラメータは、必要に応じて、Hiveインスタンスに接続するためのHttpPath値を指定します。
   salesforce	db_type salesforceでgateway_paramsパラメータを使用する場合は、security_tokenオプションを指定する必要があります。セキュリティ・トークンは、大文字と小文字が区別される英数字コードです。 詳細は、セキュリティ・トークンのリセットを参照してください。 db_type salesforceでgateway_paramsパラメータを使用する場合は、正しいhostnameパラメータを指定する必要があります。 Salesforceには、Salesforceサービス・アカウント用の2つの形式のURLが用意されています。 xxxx.develop.lightning.force.com形式のURL 「プロファイルの表示」タブに表示されるxxxxmy.salesforce.com形式のURL。 Oracle管理の異機種間接続では、hostnameパラメータ値のxxxxmy.salesforce.com形式のURLのみがサポートされます。
   servicenow	ServiceNowに接続してデータを取得するには、ゲートウェイ・パラメータdirectory_nameおよびfile_nameを指定する必要があります。これらのパラメータは、JSONレスポンスをリレーショナル・モデルにマップするモデル・ファイル(REST構成ファイル)を指定します。モデル・ファイルは、JSONレスポンスを処理するためのエンドポイント、表マッピングおよびHTTPレスポンス・コードを指定します。詳細は、モデル・ファイルの構文およびモデル・ファイルの例を参照してください。 db_type servicenowでgateway_paramsパラメータを使用する場合、次の2つのオプションがサポートされています。 基本認証: gateway_paramsパラメータdb_typeに値'servicenow'を指定し、ユーザー名/パスワード・タイプの資格証明とともにdirectory_nameおよびfile_nameパラメータを指定する必要があります。 OAuth 2.0認証: gateway_paramsパラメータdb_typeに値'servicenow'を指定し、directory_name、file_nameおよびtoken_uriパラメータをOAuth型の資格証明とともに指定する必要があります。 db_type servicenowを使用したOAuth 2.0認証の場合、資格証明は、gcp_oauth2値が指定されたparamsパラメータ(client_id、client_secretおよびrefresh_token)を使用したOAuth型の資格証明である必要があります。詳細は、CREATE_CREDENTIALプロシージャを参照してください。 directory_nameパラメータは、ServiceNow REST構成ファイルでディレクトリを指定します。このディレクトリは、次のように作成できます。 create or replace directory servicenow_dir as 'SERVICENOW_DIR'; ServiceNow REST構成ファイルを取得し、指定したディレクトリにダウンロードします。たとえば、次のとおりです。 exec DBMS_CLOUD.get_object('servicenow_dir_cred', 'https://objectstorage.<...>/servicenow.rest','SERVICENOW_DIR'); file_name値を、ダウンロードしたREST構成ファイルの名前"servicenow.rest"に設定します。 その後、基本認証またはOAuth2.0でServiceNow REST構成ファイルを使用できます。サンプルについては、HETEROGENEOUS_CONNECTIVITY_INFOビューを参照してください。
   sharepoint	gateway_paramsパラメータをdb_type sharepointとともに使用する場合は、auth_uri、scope、service_urlおよびtoken_uriの値も指定します。 db_type sharepointの場合、DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINKで指定する資格証明は、gcp_oauth2値(client_id、client_secretおよびrefresh_token)を指定したparamsパラメータを使用するOAuth型の資格証明である必要があります。詳細は、CREATE_CREDENTIALプロシージャに関する項を参照してください。tenant_id.sharepoint.com/.default offline_accessのrefresh_tokenを生成します。詳細は、「スコープの決定」およびOAuth 2.0認証を参照してください。 db_type sharepointのgateway_paramsの値を設定します。 auth_uri: Azureからauth_uriを設定します。詳細は、「アプリケーション・クライアント情報およびエンドポイントの取得」を参照してください。 scope: スコープを設定します。詳細は、接続オプションの説明を参照してください。 service_url: service_urlを設定します。詳細は、Service URLを参照してください。 token_uri: Azureからtoken_uriを取得します。詳細は、「アプリケーション・クライアント情報およびエンドポイントの取得」を参照してください。
   snowflake	db_type snowflakeでgateway_paramsパラメータを使用する場合は、hostnameパラメータとしてSnowflakeアカウント識別子を使用します。この場合、ドライバはsnowflakecomupting.comを追加するため、ホスト名のこの部分を明示的に渡しません。Snowflakeアカウント識別子を検索するには、クラウド・プラットフォームおよびリージョン別のアカウント識別子フォーマットを参照してください。 たとえば: Snowflakeアカウントの場合: https://example-marketing_test_account.snowflakecomputing.com hostname値を"example-marketing_test_account"に設定します。 db_typeがSNOWFLAKEの場合、オプションのパラメータrole、schemaおよびwarehouseが有効です。これらの値は、デフォルト以外の別のスキーマ、ロールまたはウェアハウス値を指定します。たとえば: gateway_params => JSON_OBJECT( 'db_type' value 'snowflake', 'role' value 'ADMIN', 'schema' value 'PUBLIC', 'warehouse' value 'TEST' )
   youtube	YouTubeに接続してデータを取得するには、パラメータdirectory_nameおよびfile_nameを指定する必要があります。これらのパラメータは、JSONレスポンスをリレーショナル・モデルにマップするモデル・ファイル(REST構成ファイル)を指定します。モデル・ファイルは、JSONレスポンスを処理するためのエンドポイント、表マッピングおよびHTTPレスポンス・コードを指定します。詳細は、モデル・ファイルの構文およびモデル・ファイルの例を参照してください。 db_type youtubeの場合、資格証明は、gcp_oauth2値(client_id、client_secretおよびrefresh_token)を指定してparamsパラメータを使用するOAuthタイプの資格証明である必要があります。詳細は、CREATE_CREDENTIALプロシージャを参照してください。 directory_nameパラメータは、YouTube REST構成ファイルを含むディレクトリを指定します。 たとえば、このディレクトリを作成して必要なコンテンツを追加するには: Autonomous Databaseインスタンスにディレクトリを作成します: create or replace directory youtube_dir as 'YOUTUBE_DIR'; 自動停止REST構成ファイルを取得し、指定したディレクトリにダウンロードします。たとえば: exec DBMS_CLOUD.get_object('youtube_dir_cred', 'https://objectstorage.<...>/youtube.rest','YOUTUBE_DIR'); file_name値を、ダウンロードしたREST構成ファイルの名前'youtube.rest'に設定します。 その後、OAuth2.0でREST構成ファイルを使用できます。サンプルについては、HETEROGENEOUS_CONNECTIVITY_INFOビューを参照してください。

   詳細は、CREATE_DATABASE_LINKプロシージャを参照してください。

3. データベース・リンクを使用して、ターゲット・データベースのデータにアクセスします。

   たとえば:

   SELECT count(*) FROM sales@AWSREDSHIFT_LINK

   Google BigQueryでSELECTを使用するときに指定する表名は引用符で囲む必要があります。次に例を示します。

   SELECT count(*) FROM "sales"@GOOGLE_BIGQUERY_LINK

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

• Oracle管理の異種間接続を使用したプライベート・エンドポイントにあるOracle MySQLへのデータベース・リンクの作成
  Oracle管理の異種間接続に対するAutonomous Databaseのサポートにより、プライベート・エンドポイントにあるOracle MySQL Database Serviceへのデータベース・リンクを簡単に作成できます。Oracle管理の異種間接続でデータベース・リンクを使用する場合、Autonomous DatabaseはOracle MySQL Database Serviceへの接続を構成および設定します。
• Oracle管理の異種間接続のデータベース・タイプおよびポート
  Oracle管理の異種間接続を使用してAutonomous Databaseから接続できるOracle以外のデータベースを表示し、各データベース・タイプでサポートされているポート値をリストします。また、各データベース・タイプでサポートされているデータベース・バージョンを参照できるリンクも提供します。
• 異機種間接続情報およびサンプルへのアクセス
  Oracle Autonomous Databaseは、Oracle以外のデータベースへのデータベース・リンクに異機種間接続情報を提供します。