プライベート・エンドポイントにある非Oracle Databasesへの顧客管理異機種間接続があるAutonomous Databaseからデータベース・リンクを作成するための前提条件をリストします。

Autonomous DatabaseインスタンスからOracle Database Gatewayへのデータベース・リンクを作成して、プライベート・エンドポイントにある非Oracleデータベースにアクセスし、ウォレット(TCPS)またはウォレット(TLS)なしで接続できます。

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

   credential_nameパラメータの指定は必須です。

   たとえば:

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

   usernameパラメータの文字はすべて大文字である必要があります。

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

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

   たとえば:

   BEGIN
        DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
             db_link_name =>       'SALESLINK', 
             hostname =>           'example.com', 
             port =>               '1522',
             service_name =>       'example_service_name',
             ssl_server_cert_dn => 'ssl_server_cert_dn',
             credential_name =>    'DB_LINK_CRED',
             directory_name =>      NULL,
             gateway_link =>        TRUE,
             private_target =>      TRUE,
             gateway_params =>      NULL);
   END;
   /

   接続がTCPベースのデータベース・リンク(ウォレットなし)として作成される場合は、ssl_server_cert_dnパラメータはオプションです。

   directory_nameがNULLの場合、接続はTCPベースのデータベース・リンク(ウォレットなし)として作成されます。

   Oracle Database以外のターゲットがプライベート・エンドポイントにある場合(つまり、データベース・リンクがVCN DNSサーバーで解決する必要があるホスト名にアクセスする場合)、private_targetパラメータをTRUEに設定する必要があります。private_targetがTRUEの場合、hostnameパラメータは単一のホスト名である必要があります(プライベート・エンドポイントでは、IPアドレス、SCAN IPまたはSCANホスト名の使用はサポートされていません)。

   gateway_linkがTRUEで、gateway_paramsがNULLの場合、データベース・リンクが顧客管理Oracleゲートウェイへのものであることを指定します。

   ADMIN以外のユーザーがDBMS_CLOUD_ADMIN.CREATE_DATABASE_LINKを実行するには、権限が必要です。

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

   たとえば:

   SELECT * FROM employees@SALESLINK;
   

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

Autonomous DatabaseインスタンスからOracle Database Gatewayへのデータベース・リンクを作成して、プライベート・エンドポイントにある非Oracleデータベースにアクセスし、ウォレット(TCPS)またはウォレット(TLS)なしで接続できます。

1. ターゲットのOracle Database Gateway自己署名ウォレットをオブジェクト・ストアにコピーします。たとえば、Oracle Database Gatewayの証明書を含むcwallet.ssoをオブジェクト・ストアにコピーします。

   ウォレット・ファイルは、データベースのユーザーIDおよびパスワードと組み合せて、ターゲット・ゲートウェイを介して使用可能なデータへのアクセスを可能にします。ウォレット・ファイルは安全な場所に保存してください。ウォレット・ファイルは、権限のあるユーザーとのみ共有してください。

2. cwallet.ssoを格納するオブジェクト・ストアにアクセスするための資格証明を作成します。様々なオブジェクト・ストレージ・サービスのusernameおよびpasswordパラメータの詳細は、「CREATE_CREDENTIALプロシージャ」を参照してください。
3. ウォレット・ファイルcwallet.ssoのディレクトリをAutonomous Databaseに作成します。

   たとえば:

   CREATE DIRECTORY dblink_wallet_dir AS 'directory_path_of_your_choice';
   

   ディレクトリの作成の詳細は、「Autonomous Databaseでのディレクトリの作成」を参照してください。

4. DBMS_CLOUD.GET_OBJECTを使用して、前のステップで作成したディレクトリDBLINK_WALLET_DIRにターゲット・ゲートウェイ自己署名付きウォレットをアップロードします。

   たとえば:

   BEGIN 
        DBMS_CLOUD.GET_OBJECT(
           credential_name => 'DEF_CRED_NAME',
           object_uri => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/cwallet.sso',
           directory_name => 'DBLINK_WALLET_DIR'); 
   END;
   /

   この例では、namespace-stringはOracle Cloud Infrastructureオブジェクト・ストレージ・ネームスペースで、bucketnameはバケット名です。詳細は、オブジェクト・ストレージ・ネームスペースの理解を参照してください。

   ノート
   
   このステップで使用するcredential_nameは、オブジェクト・ストアの資格証明です。次のステップでは、ターゲット・ゲートウェイにアクセスするための資格証明を作成します。
5. Autonomous Databaseで、ターゲット・データベースにアクセスするための資格証明を作成します。DBMS_CLOUD.CREATE_CREDENTIALで指定するusernameおよびpasswordは、データベース・リンク内で使用されるターゲット・データベースの資格証明です(ターゲット・データベースはOracle Database Gatewayを介してアクセスされます)。

   credential_nameパラメータの指定は必須です。

   たとえば:

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

   usernameパラメータの文字はすべて大文字である必要があります。

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

6. DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINKを使用して、ターゲット・ゲートウェイへのデータ・リンクを作成します。

   たとえば:

   BEGIN
        DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
             db_link_name =>       'SALESLINK', 
             hostname =>           'example.com', 
             port =>               '1522',
             service_name =>       'example_service_name',
             ssl_server_cert_dn => 'ssl_server_cert_dn',
             credential_name =>    'DB_LINK_CRED',
             directory_name =>     'DBLINK_WALLET_DIR',
             gateway_link =>        TRUE,
             private_target =>      TRUE,
             gateway_params =>      NULL);
   END;
   /

   directory_nameがNULLでない場合は、TCPSベースのデータベース・リンクが作成されます。

   Oracle Database以外のターゲットがプライベート・エンドポイントにある場合(つまり、データベース・リンクがVCN DNSサーバーで解決する必要があるホスト名にアクセスする場合)、private_targetパラメータをTRUEに設定する必要があります。private_targetがTRUEの場合、hostnameパラメータは単一のホスト名である必要があります(プライベート・エンドポイントでは、IPアドレス、SCAN IPまたはSCANホスト名の使用はサポートされていません)。

   gateway_linkがTRUEで、gateway_paramsがNULLの場合、データベース・リンクが顧客管理Oracleゲートウェイへのものであることを指定します。

   ADMIN以外のユーザーがDBMS_CLOUD_ADMIN.CREATE_DATABASE_LINKを実行するには、権限が必要です。

7. 作成したデータベース・リンクを使用して、ターゲット・ゲートウェイのデータにアクセスします。

   たとえば:

   SELECT * FROM employees@SALESLINK;
   

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