Autonomous Databaseは、次のように登録済データ・セットのアクセシビリティを決定します:

• ADMINユーザーは、指定されたスコープに基づいてデータ・セットを登録できるユーザーのスコープを指定します。

• データ・セットを登録する権限を付与されているユーザーは、データ・セットを登録するときにスコープを指定します。

• オプションで、データ・セットを登録するときに、認可権限を付与されたユーザーは、データ・セットへのアクセスに必要な認可ステップを指定できます。この認可ステップは、スコープ・レベルのアクセス認可の他にあります。

ORA-20001: Share privileges are not enabled for current user or it is enabled but not for scope MY$REGION

ADMINユーザーは、登録を取り消して、リモート・アクセス用のデータ・セットの登録を禁止できます。ADMINユーザーは、登録済データ・セットにアクセスする権限またはデータベース・ユーザーを取り消すこともできます。

1. ADMINユーザーとして、データ・セットを登録するユーザーの権限を取り消します。

   たとえば:

   EXEC DBMS_CLOUD_LINK_ADMIN.REVOKE_REGISTER('DB_USER1');

   これにより、ユーザーDB_USER1のデータ・セットを登録する権限が取り消されます。

   DBMS_CLOUD_LINK_ADMIN.REVOKE_REGISTERの実行は、すでに登録されているデータ・セットには影響しません。DBMS_CLOUD_LINK.UNREGISTERを使用して、登録済データ・セットのアクセス権を削除します。

   詳細は、REVOKE_REGISTERプロシージャおよびUNREGISTERプロシージャを参照してください。

2. ADMINユーザーとして、登録済のデータ・セットへのアクセスを取り消します。

   たとえば:

   EXEC DBMS_CLOUD_LINK_ADMIN.REVOKE_READ('LWARD');

   これにより、ユーザーLWARDのクラウド・リンク・データ・セットへのアクセスが取り消されます。

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

所有している表またはビューを登録済のデータ・セットとして登録できます。データ・セットを削除または置換する場合は、そのデータ・セットを登録解除する必要があります。データ・セットを登録した後は、データ・セットの属性の値を変更できます。

1. ADMINユーザーから権限付与登録を取得します。

   詳細は、データベース・ユーザーに対するクラウド・リンク・アクセス権の付与を参照してください。

2. 1つ以上のデータ・セットを登録します。

   たとえば、Autonomous DatabaseインスタンスにスキーマCLOUDLINKがある場合、SALES_VIEW_AGGとSALES_ALLの2つのオブジェクトを登録し、異なるscopeパラメータを指定して、オブジェクトへのアクセス方法を決定できます。

   BEGIN
      DBMS_CLOUD_LINK.REGISTER(
       schema_name    => 'CLOUDLINK',
       schema_object  => 'SALES_VIEW_AGG',
       namespace      => 'REGIONAL_SALES', 
       name           => 'SALES_AGG',
       description    => 'Aggregated regional sales information.',
       scope          => 'MY$TENANCY',
       auth_required  =>  FALSE,
       data_set_owner =>  'amit@example.com' );
   END;
   /

   BEGIN
      DBMS_CLOUD_LINK.REGISTER(
       schema_name    => 'CLOUDLINK',
       schema_object  => 'SALES_ALL',
       namespace      => 'TRUSTED_COMPARTMENT', 
       name           => 'SALES',
       description    => 'Trusted Compartment, only accessible within my compartment. Early sales data.',
       scope          => 'MY$COMPARTMENT',
       auth_required  =>  FALSE,
       data_set_owner =>  'amit@example.com' );
   END;
   /

   パラメータは次のとおりです。

   • schema_name: スキーマ名(オブジェクト所有者)です。

   • schema_object: オブジェクトの名前です。有効なオブジェクトは次のとおりです。

     • 表(ヒープ、外部またはハイブリッドを含む)
     • ビュー
     • マテリアライズド・ビュー
     • クラウド表(詳細は、クラウド表を使用したロギングおよび診断情報の格納を参照してください。)
     ノート
     
     分析ビューやシノニムなどの他のオブジェクトはサポートされていません。

   • namespace: クラウド・リンク(クラウド・リンクFQNの一部)でアクセスするための名前として指定したネームスペースです。

     NULL値は、Autonomous Databaseインスタンスに固有の、システム生成のnamespace値を指定します。

   • name: クラウド・リンク(クラウド・リンクFQNの一部)でアクセスするために指定する名前です。

   • description: データを説明するテキストを指定します。

   • scope: スコープを指定します。MY$REGION、MY$TENANCYまたはMY$COMPARTMENTのいずれかの変数を使用するか、1つ以上のOCIDsを指定できます。

     詳細は、「データ・セットのスコープ、アクセス制御および認可」を参照してください。

   • auth_required: スコープ・アクセス制御に加えて、データ・セットにデータベース・レベルの認可が必要かどうかを指定するブール値。これをTRUEに設定すると、データ・セットによって追加の認可ステップが強制されます。詳細は、「認可が必要なデータ・セットの登録」を参照してください。

   • data_set_owner: テキスト値は、データ・セットの責任者またはデータ・セットに関する質問の担当者に関する情報を指定します。たとえば、データ・セット所有者のEメール・アドレスを指定できます。

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

   この例では、登録が完了すると、DBMS_CLOUD_LINK.REGISTERで指定したスコープ・パラメータに基づいて、2つの登録済オブジェクトのスコープが異なります。

   • MY$TENANCY: REGIONAL_SALES.SALES_AGGのテナンシ・レベルのスコープを指定します。

   • MY$COMPARTMENT: TRUSTED_COMPARTMENT.SALESのテナンシ内のより制限の厳しいコンパートメント・レベルのスコープを指定します。

BEGIN
   DBMS_CLOUD_LINK.UNREGISTER(
    namespace      => 'TRUSTED_COMPARTMENT', 
    name           => 'SALES');
END;
/

• データ・セットの登録または登録解除のノート
  DBMS_CLOUD_LINK.REGISTERにデータ・セットを登録し、DBMS_CLOUD_LINK.UNREGISTERにデータ・セットを登録解除するためのノートを提供します。

複数のリージョンでクラウド・リンクを使用できます。このリージョンでは、ソース・リージョンにデータ・セットのソース・データベースが含まれ、1つ以上のリモート・リージョンにソース・データベースのリフレッシュ可能なクローンが含まれます。

図cloud-links-cross-region-refreshable-clone.pngの説明

異なるリージョンのデータ・セットでクラウド・リンクを使用するには:

1. リモート・リージョンにソース・データベースのクロスリージョン・リフレッシュ可能クローンを作成します。

   クロス・リージョン・リフレッシュ可能クローンの追加の詳細は、クロス・テナンシまたはクロス・リージョン・リフレッシュ可能クローンの作成を参照してください。

2. ソース・データベースで、データ・セットを登録します。

   詳細は、「データ・セットの登録または登録解除」を参照してください。

3. リフレッシュ可能なクローンをリフレッシュします

   詳細は、Autonomous Databaseでのリフレッシュ可能クローンのリフレッシュを参照してください。

4. リモートの「リフレッシュ可能クローン」で、データ・セットをソース・リージョンに登録するために使用したのと同じ引数を使用して、データ・セットを登録します。

   たとえば、Autonomous DatabaseインスタンスにスキーマCLOUDLINKがある場合、ソース・データベースにSALES_ALLを登録した後、リフレッシュ可能クローンにSALES_ALLを登録します:

   BEGIN
      DBMS_CLOUD_LINK.REGISTER(
       schema_name    => 'CLOUDLINK',
       schema_object  => 'SALES_ALL',
       namespace      => 'TRUSTED_COMPARTMENT', 
       name           => 'SALES',
       description    => 'Trusted Compartment, only accessible within my compartment. Early sales data.',
       scope          => 'MY$COMPARTMENT',
       auth_required  =>  FALSE,
       data_set_owner =>  'amit@example.com' );
   END;
   /

   パラメータは次のとおりです。

   • schema_name: スキーマ名(オブジェクト所有者)です。

   • schema_object: オブジェクトの名前です。有効なオブジェクトは次のとおりです。

     • 表(ヒープ、外部またはハイブリッドを含む)
     • ビュー
     • マテリアライズド・ビュー
     ノート
     
     分析ビューやシノニムなどの他のオブジェクトはサポートされていません。

   • namespace: クラウド・リンク(クラウド・リンクFQNの一部)でアクセスするための名前として指定したネームスペースです。

     NULL値は、Autonomous Databaseインスタンスに固有の、システム生成のnamespace値を指定します。

   • name: クラウド・リンク(クラウド・リンクFQNの一部)でアクセスするために指定する名前です。

   • description: データを説明するテキストを指定します。

   • scope: スコープを指定します。MY$REGION、MY$TENANCYまたはMY$COMPARTMENTのいずれかの変数を使用するか、1つ以上のOCIDsを指定できます。

     詳細は、「データ・セットのスコープ、アクセス制御および認可」を参照してください。

   • auth_required: スコープ・アクセス制御に加えて、データ・セットにデータベース・レベルの認可が必要かどうかを指定するブール値。これをTRUEに設定すると、データ・セットによって追加の認可ステップが強制されます。詳細は、「認可が必要なデータ・セットの登録」を参照してください。

   • data_set_owner: テキスト値は、データ・セットの責任者またはデータ・セットに関する質問の担当者に関する情報を指定します。たとえば、データ・セット所有者のEメール・アドレスを指定できます。

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

   リフレッシュ可能クローンで登録が完了すると、登録済オブジェクトのスコープはMY$COMPARTMENTです: TRUSTED_COMPARTMENT.SALESのテナンシ内のコンパートメントに対して、より制限の厳しいコンパートメント・レベルのスコープを指定します。

• リモート・リージョンへのデータ・セットの登録または登録解除に関するノート
  リモート・リージョンへのデータ・セットの登録に関するノートを提供します。

オプションで、データ・セットを登録するときに、スコープに加えて、データ・セットへのアクセスにデータベース・レベルの認可が必要であることを指定できます。

1. DBMS_CLOUD_LINK.REGISTERを使用して、必要な認可でデータを登録します。

   Autonomous DatabaseインスタンスにスキーマCLOUDLINKがあり、オブジェクトSALES_VIEW_AGGを登録し、auth_requiredをTRUEに設定した場合、スコープの定義に加えて、オブジェクトへのアクセス方法を決定する追加のステップを事前に実行する必要があります。

   BEGIN
      DBMS_CLOUD_LINK.REGISTER(
       schema_name    => 'CLOUDLINK',
       schema_object  => 'SALES_VIEW_AGG',
       namespace      => 'REGIONAL_SALES', 
       name           => 'SALES_AGG',
       description    => 'Aggregated regional sales information.',
       scope          => 'MY$TENANCY',
       auth_required  =>  TRUE,
       data_set_owner =>  'amit@example.com' );
   END;
   /

   パラメータは次のとおりです。

   • schema_name: スキーマ名(オブジェクト所有者)です。

   • schema_object: オブジェクトの名前です。有効なオブジェクトは次のとおりです。

     • 表(ヒープ、外部またはハイブリッドを含む)
     • ビュー
     • マテリアライズド・ビュー
     ノート
     
     分析ビューやシノニムなどの他のオブジェクトはサポートされていません。

   • namespace: クラウド・リンク(クラウド・リンクFQNの一部)でアクセスするための名前として指定したネームスペースです。

     NULL値は、Autonomous Databaseインスタンスに固有の、システム生成のnamespace値を指定します。

   • name: クラウド・リンク(クラウド・リンクFQNの一部)でアクセスするために指定する名前です。

   • scope: スコープを指定します。MY$REGION、MY$TENANCYまたはMY$COMPARTMENTのいずれかの変数を使用するか、1つ以上のOCIDsを指定できます。

     詳細は、「データ・セットのスコープ、アクセス制御および認可」を参照してください。

   • auth_required: スコープ・アクセス制御に加えて、データ・セットにデータベース・レベルの認可が必要かどうかを指定するブール値。これをTRUEに設定すると、データ・セットによって追加の認可ステップが強制されます。

   • data_set_owner: テキスト値は、データ・セットの責任者またはデータ・セットに関する質問の担当者に関する情報を指定します。たとえば、データ・セット所有者のEメール・アドレスを指定できます。

2. 認可を付与するデータベースのデータベースIDを取得します(データベースのデータ・セットへのアクセスを許可するため)。

   システムで、データ セットへのアクセスを許可します。

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

3. 取得したデータベースIDを使用して、指定したデータ・セットに認可を付与します。

   権限を付与するだけで、このステップに示すようにDBMS_CLOUD_LINK.GRANT_AUTHORIZATIONを実行できます(権限がある場合)。ADMINは、DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZEを使用して認可を付与します。

   BEGIN
      DBMS_CLOUD_LINK.GRANT_AUTHORIZATION(
       database_id    => '120xxxxxxx8506029999',
       namespace      => 'TRUSTED_COMPARTMENT', 
       name           => 'SALES');
   END;
   /

   追加のデータベースを認可する場合は、これらのステップを複数回実行します。

BEGIN
   DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION(
    database_id    => '120xxxxxxx8506029999',
    namespace      => 'TRUSTED_COMPARTMENT', 
    name           => 'SALES');
END;
/

オプションで、データ・セットを登録するときに、データ・セットへのアクセスを、リフレッシュ可能なクローンである1つ以上のAutonomous Databaseインスタンスにオフロードできます。

オプションのoffload_targetsパラメータをDBMS_CLOUD_LINK.REGISTERとともに使用して、アクセスがリフレッシュ可能なクローンにオフロードされるように指定します。各リフレッシュ可能クローンのソース・データベースは、データ・セット(データ・パブリッシャ)を登録するAutonomous Databaseインスタンスです。

offload_targets値は、1つ以上のCLOUD_LINK_DATABASE_IDおよびOFFLOAD_TARGETキー値のペアを定義するJSONドキュメントです。

• CLOUD_LINK_DATABASE_IDは、次のいずれかです。

  • データベースID: これは、OFFLOAD_TARGET値で指定された対応するリフレッシュ可能クローンにリクエストがオフロードされるデータ・セット・コンシューマのデータベースIDを指定します。

    DBMS_CLOUD_LINK.GET_DATABASE_IDを実行してデータベースIDを取得します。詳細は、GET_DATABASE_IDファンクションを参照してください。

  • ANY: これは、データ・セット・コンシューマのリクエストが対応するオフロード・ターゲットにオフロードされることを指定します。コンシューマのデータ・セット・リクエストは、対応するオフロード・ターゲットにルーティングされます。

    データベースIDを指定せずにANYを指定すると、コンシューマからのすべてのデータ・セット・リクエストは、OFFLOAD_TARGET値で指定されたリフレッシュ可能クローンにオフロードされます。

    データベースIDとANYの両方を指定すると、データベースIDと一致しないコンシューマからのデータ・セット・リクエストは、OFFLOAD_TARGET値で指定されたリフレッシュ可能クローンにオフロードされます。

• OFFLOAD_TARGETは、リフレッシュ可能なクローンであるAutonomous DatabaseインスタンスのOCIDです。

次の図は、オフロード・ターゲットの使用方法を示しています。

図cloud-links-offload-targets-any-keyword.epsの説明

データ・セット・コンシューマが、offload_targetsに登録したデータ・セットへのアクセスをリクエストし、Autonomous DatabaseインスタンスのデータベースIDがCLOUD_LINK_DATABASE_IDで指定された値と一致する場合、アクセスは、指定されたJSONのOFFLOAD_TARGETで識別されたリフレッシュ可能クローンにオフロードされます。

たとえば、3つのOFFLOAD_TARGET/CLOUD_LINK_DATABASE_ID値ペアを持つJSONサンプルを次に示します。

{
  "OFFLOAD_TARGETS": [
    {
      "CLOUD_LINK_DATABASE_ID": "34xxxxx69708978",
      "OFFLOAD_TARGET":
"ocid1.autonomousdatabase.oc1..xxxxx3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfabc"
    },
    {
      "CLOUD_LINK_DATABASE_ID": "34xxxxx89898978",
      "OFFLOAD_TARGET":
"ocid1.autonomousdatabase.oc1..xxxxx3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfdef"
    },
    {
      "CLOUD_LINK_DATABASE_ID": "34xxxxx4755680",
      "OFFLOAD_TARGET":
"ocid1.autonomousdatabase.oc1..xxxxx3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfghi"
    }
  ]
}

データ・セット・コンシューマが、ANYキーワードを含むoffload_targetsに登録したデータ・セットへのアクセスを要求すると、アクセスは、指定されたJSONのOFFLOAD_TARGETで識別されたリフレッシュ可能クローン(指定されたJSONに一致するデータベースIDエントリを持つコンシューマからのリクエストを除く)にオフロードされます。

たとえば、1つの明示的なOFFLOAD_TARGET/CLOUD_LINK_DATABASE_ID値ペア、および1つのANY値に対応する OFFLOAD_TARGETを持つJSONサンプルを次に示します。

{
  "OFFLOAD_TARGETS": [
    {
      "CLOUD_LINK_DATABASE_ID": "ANY",
      "OFFLOAD_TARGET":
"ocid1.autonomousdatabase.oc1..xxxxx3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfdef"
    },
    {
      "CLOUD_LINK_DATABASE_ID": "34xxxxx4755680",
      "OFFLOAD_TARGET":
"ocid1.autonomousdatabase.oc1..xxxxx3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfghi"
    }
  ]
}

データ・セットを登録し、オフロード・ターゲットを指定するには、次の手順を実行します。

1. データ・セット・アクセスをオフロードする1つ以上のリフレッシュ可能クローンのOCIDを取得します。リフレッシュ可能クローンOCIDsは、リフレッシュ可能クローンのOracle Cloud Infrastructure Consoleで使用できます。
   ノート
   
   オフロード・ターゲットとして表示されるリフレッシュ可能クローンのリフレッシュ可能クローンを作成した後、最大10分かかる場合があります。つまり、リフレッシュ可能クローンをクラウド・リンク・オフロード登録で使用できるようにするには、リフレッシュ可能クローンを作成してから最大10分待機する必要がある場合があります。
2. リフレッシュ可能クローンによって提供されるデータを使用して、データ・セットにアクセスする1つ以上のAutonomous DatabaseインスタンスのデータベースIDを取得します。

   リフレッシュ可能クローンからデータ・セットにアクセスするシステムで、次のコマンドを実行します:

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

3. データ・セットを登録し、offload_targetsパラメータを指定します。

   たとえば、Autonomous DatabaseインスタンスにスキーマCLOUDLINKがある場合、SALES_VIEW_AGGを登録し、データ・セットへのアクセス権を提供するリフレッシュ可能クローンを指定できます:

   BEGIN
      DBMS_CLOUD_LINK.REGISTER(
       schema_name     => 'CLOUDLINK',
       schema_object   => 'SALES_VIEW_AGG',
       namespace       => 'REGIONAL_SALES', 
       name            => 'SALES_AGG',
       description     => 'Aggregated regional sales information.',
       scope           => 'MY$TENANCY',
       auth_required   =>  FALSE,
       data_set_owner  =>  'amit@example.com',
       offload_targets => '{
     "OFFLOAD_TARGETS": [
       {
         "CLOUD_LINK_DATABASE_ID": "34xxxx754755680",
         "OFFLOAD_TARGET":
   "ocid1.autonomousdatabase.oc1..xxxxxaaba3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfghi"
       }
     ]
   }');
   END;
   /

   パラメータは次のとおりです。

   • schema_name: スキーマ名(オブジェクト所有者)です。

   • schema_object: オブジェクトの名前です。有効なオブジェクトは次のとおりです。

     • 表(ヒープ、外部またはハイブリッドを含む)
     • ビュー
     • マテリアライズド・ビュー
     ノート
     
     分析ビューやシノニムなどの他のオブジェクトはサポートされていません。

   • namespace: クラウド・リンク(クラウド・リンクFQNの一部)でアクセスするための名前として指定したネームスペースです。

     NULL値は、Autonomous Databaseインスタンスに固有の、システム生成のnamespace値を指定します。

   • name: クラウド・リンク(クラウド・リンクFQNの一部)でアクセスするために指定する名前です。

   • scope: スコープを指定します。MY$REGION、MY$TENANCYまたはMY$COMPARTMENTのいずれかの変数を使用するか、1つ以上のOCIDsを指定できます。

     詳細は、「データ・セットのスコープ、アクセス制御および認可」を参照してください。

   • auth_required: スコープ・アクセス制御に加えて、データ・セットにデータベース・レベルの認可が必要かどうかを指定するブール値。これをTRUEに設定すると、データ・セットによって追加の認可ステップが強制されます。詳細は、「認可が必要なデータ・セットの登録」を参照してください。

   • data_set_owner: テキスト値は、データ・セットの責任者またはデータ・セットに関する質問の担当者に関する情報を指定します。たとえば、データ・セット所有者のEメール・アドレスを指定できます。

   • offload_targets: データ・セットへのアクセスがオフロードされるリフレッシュ可能クローンのAutonomous Database OCIDsを、データ・セットが登録されているAutonomous Databaseから1つ以上指定します。

     データ・セット・コンシューマごとに、次のいずれかが一致して、リクエストをリフレッシュ可能クローンにオフロードできます。

     • 指定されたcloud_link_database_idの値、つまり値がコンシューマのデータベースIDと一致する場合、アクセスは、offload_targetで指定されたOCIDで識別されるリフレッシュ可能クローンにオフロードされます。

     • ANYキーワードが指定されている場合、指定されたcloud_link_database_idの値と一致しない場合、アクセスは、対応するoffload_targetで指定されたOCIDによって、ANYエントリで識別されるリフレッシュ可能クローンにオフロードされます。

   ノート
   
   データ・パブリッシャがエラスティック・プール・リーダーまたはエラスティック・プール・メンバーである場合、offload_targetsを使用してオフロード・ターゲットの詳細を構成するかわりに、統合問合せオフロード機能を使用できます。この場合、パブリッシャは、ProxySQL問合せオフロードによって、ターゲットを構成しなくても、任意の数のリフレッシュ可能クローンに問合せ(読取り)をオフロードできます。詳細は、クラウド・リンクでの統合問合せオフロードの使用を参照してください。

   詳細は、次を参照してください:

   • REGISTERプロシージャ

   • UPDATE_REGISTRATIONプロシージャ

   • Autonomous Databaseでのリフレッシュ可能クローンの使用方法

   • クラウド・リンクでの統合問合せオフロードの使用

データ・セットを登録した後、一部のデータ・セット属性を更新できます。スキーマ名、スキーマ・オブジェクト、ネームスペースまたは名前の属性は更新できません。

1. データ・セットを登録したユーザーは、その属性をDBMS_CLOUD_LINK.UPDATE_REGISTRATIONで更新できます。

   データ・セット属性を更新する権限がない場合は、ADMINユーザーから権限付与登録権限を取得する必要があります。

   詳細は、データベース・ユーザーに対するクラウド・リンク・アクセス権の付与を参照してください。

2. データ・セットの1つ以上の属性を更新します。

   たとえば、DBMS_CLOUD_LINK.UPDATE_REGISTRATIONを使用して、ネームスペースREGIONAL_SALESのデータ・セットのdescription、scopeおよびauth_required属性をSALES_AGGという名前で更新します。

   BEGIN
      DBMS_CLOUD_LINK.UPDATE_REGISTRATION(
       namespace      => 'REGIONAL_SALES', 
       name           => 'SALES_AGG',
       description    => 'Updated description for aggregated regional sales information.',
       scope          => 'MY$COMPARTMENT',
       auth_required  =>  TRUE );
   END;
   /

   必須パラメータは次のとおりです。

   • namespace: データ・セットの登録時に指定したデータ・セットのネームスペースです。

   • name: データ・セットの登録時に指定したデータ・セットの名前です。

   オプションのパラメータのリストを次に示します。オプションのパラメータ値に対してNULLが渡された場合、属性は変更されません。

   • description: データを説明するために更新されたテキストを指定します。

   • scope: スコープを指定します。MY$REGION、MY$TENANCYまたはMY$COMPARTMENTのいずれかの変数を使用するか、1つ以上のOCIDsを指定できます。

     詳細は、「データ・セットのスコープ、アクセス制御および認可」を参照してください。

   • auth_required: スコープ・アクセス制御に加えて、データ・セットにデータベース・レベルの認可が必要かどうかを指定するブール値。これをTRUEに設定すると、データ・セットによって追加の認可ステップが強制されます。詳細は、「認可が必要なデータ・セットの登録」を参照してください。

   • data_set_owner: テキスト値は、データ・セットの責任者またはデータ・セットに関する質問の担当者に関する情報を指定します。たとえば、データ・セット所有者のEメール・アドレスを指定できます。

   • offload_targets: データ・セットへのアクセスがオフロードされるリフレッシュ可能クローンのAutonomous Database OCIDsを、データ・セットが登録されているAutonomous Databaseから1つ以上指定します。詳細は、「データ・セット・アクセス用のオフロード・ターゲットへのデータ・セットの登録」を参照してください。

   schema_name属性またはschema_object属性は更新できません。

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

クラウド・リンク・コンシューマがデータ・セット所有者のデータにアクセスするときに使用するサービス名マッピングを設定できます。

クラウド・リンクは、データ・セット・プロデューサであるAutonomous Databaseインスタンスのデータベース・リソース、またはリフレッシュ可能クローンのリソースを使用して、共有データにアクセスします。デフォルトでは、コンシューマがクラウド・リンク・データにアクセスするためのリモート接続は、MEDIUMデータベース・サービスを使用します。

DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPINGを使用して、コンシューマ用のデータベース・サービス・マッピングを設定します。このプロシージャでは、コンシューマ・サービス・マッピングを指定するには、データベースIDまたはキーワードANYを指定します。たとえば、次の図は、コンシューマAとHIGHサービスのマッピング、コンシューマBとMEDIUMサービスのマッピング、コンシューマCとLOWサービスのマッピング、およびANYとTPサービスのマッピングを示しています。これは、他のすべてのコンシューマがTPサービスを使用してクラウド・リンクにアクセスすることを意味します。

図autonomous-cloud-links-service-mapping.pngの説明

データベース・サービスの特性の詳細は、Autonomous Databaseのデータベース・サービス名を参照してください。

次のステップを実行して、クラウド・リンク・コンシューマに使用するデータベース・サービスを設定します。

1. サービス・マッピングを設定するデータベースのデータベースIDを取得します。

   コンシューマ・データベースでGET_DATABASE_IDを実行して、コンシューマのデータベースIDを取得します。たとえば:

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

   詳細は、GET_DATABASE_IDファンクションを参照してください。

2. データ・セット所有者のAutonomous Databaseインスタンスで、サービス・マッピングを指定します。

   このステップは、データ・セット所有者のAutonomous Databaseインスタンス(つまり、プロデューサ・データベース)で実行します。

   BEGIN
      DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING(
       database_id      => 'database_id', 
       service_name     => 'HIGH');
   END;
   /

   ここで、database_idパラメータ値は、ステップ1で取得したデータベースIDです。

   database_idの値ANYを指定すると、service_nameがdatabase_idに関連付けられていないすべてのコンシューマ・データベースで、指定したservice_nameが使用されます。つまり、service_nameがDBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPINGで設定されていないdatabase_idです。

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

   DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPINGを実行できるのは、ADMINユーザーおよびPDB_DBAロールを持つスキーマのみです。

3. クラウド・リンク・サービス・マッピングをリストして、データベースIDおよびサービス・マッピングを確認します。

   たとえば:

   SELECT * FROM  DBA_CLOUD_LINK_SERVICE_MAPPINGS;

   詳細は、DBA_CLOUD_LINK_SERVICE_MAPPINGSビューを参照してください。

• リモート・リージョンのクラウド・リンク・コンシューマ用のデータベース・サービス名マッピングの設定
  リモート・リージョンでクロスリージョン・リフレッシュ可能クローンを作成するときに、ソース・リージョンに登録されているデータ・セットにリモート・リージョンのクラウド・リンクを使用してアクセスできます。

問合せの結果またはクラウド・リンク・データにアクセスする問合せフラグメントに対して、データ・セット・コンシューマに対するキャッシュを有効にできます。

1. 問合せで、RESULT_CACHEヒントをSHELFLIFEオプションとともに指定します。

   たとえば:

   SELECT /*+ RESULT_CACHE (SHELFLIFE=120) */ * FROM FOREST.TREE_DATA@cloud$link;

   このRESULT_CACHEは、SHELFLIFE値120を指定します。これは、結果が120秒間メモリーにキャッシュされることを示します。120秒後に、キャッシュされた結果は無効としてマークされます。

   SHELFLIFE値は正の整数である必要があります。最大SHELFLIFEの値は4294967295です。

2. 問合せ結果が大きく、メモリーに収まらない場合は、SHELFLIFEオプションとTEMPオプションを両方使用して、結果をディスクの一時表領域に書き込む必要があることを示します。

   SELECT /*+ RESULT_CACHE (TEMP=true SHELFLIFE=360) */ * FROM FOREST.TREE_DATA@cloud$link;

データ・セットが読取り専用Autonomous Databaseインスタンスに存在する場合、クラウド・リンクを共有できます。

1. データベース・モードを「読取り/書込み」モードに変更します。
   詳細は、「Autonomous Database操作モードを読取り/書込み、読取り専用または制限付きに変更」を参照してください。
2. 読取り/書込みモードのデータベースで、データ・セットを登録するステップを実行します。
   1. データベース・ユーザーのクラウド・リンク・アクセス権の付与
   2. データ・セットの登録または登録解除
3. 1つ以上のデータ・セットを登録した後、データベースを読取り専用モードに変更します。
   詳細は、「Autonomous Database操作モードを読取り/書込み、読取り専用または制限付きに変更」を参照してください。