Autonomous Databaseから、ウォレット(TLS)なしでパブリックにアクセス可能なAutonomous Databaseへのデータベース・リンクを作成できます。

1. まだ実行していない場合は、Autonomous DatabaseインスタンスでTLS接続を有効にします。

   詳細は、TLS認証とmTLS認証の両方を許可するためのAutonomous Databaseインスタンスの更新に関する項を参照してください。

2. データベース・リンクを作成するAutonomous Databaseインスタンスで、ターゲットのAutonomous Databaseにアクセスするための資格証明を作成します。DBMS_CLOUD.CREATE_CREDENTIALで指定するusernameおよびpasswordは、ターゲット・データベースの資格証明です(これらの資格証明を使用してデータベース・リンクを作成します)。
   ノート
   
   credential_nameパラメータの指定は必須です。

   たとえば:

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

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

   ノート
   
   データベース・リンクのターゲット・データベース資格証明には、ボールト・シークレット資格証明を使用できます。詳細は、Vaultシークレット資格証明の使用を参照してください。

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

3. Autonomous Databaseインスタンスへのデータベース・リンクは、DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINKを使用して作成します。

   たとえば:

   BEGIN
       DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
           db_link_name => 'SALESLINK', 
           hostname => 'adb.eu-frankfurt-1.oraclecloud.com', 
           port => '1521',
           service_name => 'example_medium.adb.example.oraclecloud.com',
           credential_name => 'DB_LINK_CRED',
           directory_name => NULL);
   END;
   /

   ウォレットを使用しないセキュアなTCP接続を使用して、パブリック・エンドポイント上のターゲットAutonomous DatabaseへのDBMS_CLOUD_ADMIN.CREATE_DATABASE_LINKを含むデータベース・リンクを作成するには、directory_nameパラメータをNULLにする必要があります。

   ssl_server_cert_dnパラメータは省略することも、含める場合はNULL値を指定することもできます。

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

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

   たとえば:

   SELECT * FROM employees@SALESLINK;
               

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

ウォレット(mTLS)を使用して、Autonomous Databaseからパブリックにアクセス可能なAutonomous Databaseへのデータベース・リンクを作成できます。

1. ターゲット・データベースの証明書を含むターゲット・データベース・ウォレットcwallet.ssoをオブジェクト・ストアにコピーします。

   ウォレット・ファイルについては、次の点に注意してください。

   • ウォレット・ファイルは、データベース・ユーザーIDとパスワードとともに、ターゲットOracle Databaseのデータへのアクセスを提供します。ウォレット・ファイルは安全な場所に保存してください。ウォレット・ファイルは、権限のあるユーザーとのみ共有してください。

   • ウォレット・ファイルの名前を変更しないでください。オブジェクト・ストレージのウォレット・ファイルには、cwallet.ssoという名前を付ける必要があります。

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

   リソース・プリンシパル資格証明を有効にする場合、Oracle Cloud Infrastructureオブジェクト・ストアにアクセスするための資格証明の作成は必要ありません。詳細は、リソース・プリンシパルを使用したOracle Cloud Infrastructureリソースへのアクセスを参照してください。

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は、オブジェクト・ストアの資格証明です。次のステップでは、ターゲット・データベースにアクセスするための資格証明を作成します。

   リソース・プリンシパル資格証明を有効にする場合、Oracle Cloud Infrastructureオブジェクト・ストアにアクセスするための資格証明の作成は必要ありません。詳細は、リソース・プリンシパルを使用したOracle Cloud Infrastructureリソースへのアクセスを参照してください。

5. Autonomous Databaseインスタンスで、ターゲット・データベースにアクセスするための資格証明を作成します。DBMS_CLOUD.CREATE_CREDENTIALで指定するusernameおよびpasswordは、データベース・リンクの作成に使用するターゲット・データベースの資格証明です。
   ノート
   
   credential_nameパラメータの指定は必須です。

   次に例を示します。

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

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

   ノート
   
   データベース・リンクのターゲット・データベース資格証明には、ボールト・シークレット資格証明を使用できます。詳細は、Vaultシークレット資格証明の使用を参照してください。

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

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

   次に例を示します。

   BEGIN
       DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
           db_link_name => 'SALESLINK',
           hostname => 'adb.eu-frankfurt-1.oraclecloud.com', 
           port => '1522',
           service_name => 'example_medium.adb.example.oraclecloud.com',
           ssl_server_cert_dn => 'CN=adb.example.oraclecloud.com,OU=Oracle BMCS FRANKFURT,O=Oracle Corporation,L=Redwood City,ST=California,C=US',
           credential_name => 'DB_LINK_CRED',
           directory_name => 'DBLINK_WALLET_DIR');
   END;
   /

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

   directory_nameで指定されたディレクトリ内のウォレット・ファイルがcwallet.ssoでない場合、プロシージャはORA-28759: failure to open fileなどのエラーを報告します。

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

   たとえば:

   SELECT * FROM employees@SALESLINK;
               

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