スコープの定義による表ハイパーリンクを使用したフェデレーテッド表の作成

プロバイダ・データベースの作成スコープによって、プロバイダ・データベースに表ハイパーリンクをリモートで作成できるコンシューマAutonomous AI Databaseインスタンスが決まります。

スコープを登録、登録解除、更新および取得するプロシージャを提供するDBMS_DATA_ACCESS_SCOPEパッケージを使用して、作成スコープを管理できます。詳細は、DBMS_DATA_ACCESS_SCOPEを参照してください。

プロバイダAutonomous AI DatabaseのADMIN (またはPDB_DBA)は、DBMS_DATA_ACCESS_ADMIN.GRANT_REGISTERを使用して、作成スコープの管理を許可するローカル・ユーザーを決定します。

これらの特権ユーザーのみがスコープを登録、更新、または登録解除でき、プロバイダテーブルの制御不能な公開を防止できます。

例

BEGIN
DBMS_DATA_ACCESS_ADMIN.GRANT_REGISTER(
username => 'ANALYTICS_ADMIN',
scope => 'MY$COMPARTMENT'
);
END;
/

前述の例では、MY$COMPARTMENTスコープ内にデータ・セットを登録する権限をANALYTICS_ADMINユーザーに付与しています。

構文参照については、GRANT_REGISTERを参照してください。

プロバイダは、DBMS_DATA_ACCESS_SCOPE.REGISTER_CREATION_SCOPEをコールして、特定の表またはスキーマ全体に対して許可されるスコープを登録し、それらのオブジェクトへの表ハイパーリンクを作成します。

BEGIN
DBMS_DATA_ACCESS_SCOPE.REGISTER_CREATION_SCOPE(
schema_name => 'ANALYTICS',
schema_object_name => 'NULL',
scope => 'MY$COMPARTMENT'
);
END;
/

この例では、ANALYTICSスキーマのデータ・アクセス・スコープをスキーマ・レベルで登録し、それをコンパートメントMY$COMPARTMENTに関連付けます。

例: オブジェクト・レベルのスコープの登録

BEGIN
DBMS_DATA_ACCESS_SCOPE.REGISTER_CREATION_SCOPE(
schema_name => 'ANALYTICS',
schema_object_name => 'SALES_DATA',
scope => 'MY$TENANCY'
);
END;
/

この例では、ANALYTICSスキーマ内の特定のオブジェクトSALES_DATAに対してよりターゲットを絞ったデータ・アクセス・スコープを登録し、テナンシMY$TENANCYにリンクします。スキーマ・レベルのバージョンとは異なり、schema_object_nameでは、この表のみに強制が制限されるため、作成権限を詳細に制御できます。

BEGIN
DBMS_DATA_ACCESS_SCOPE.REGISTER_CREATION_SCOPE(
schema_name => 'ANALYTICS',
schema_object_list => '["SALES_DATA", "CUSTOMER_DATA", "PRODUCT_DATA"]',
scope => 'MY$COMPARTMENT'
);
END;
/

このプロシージャは、リストされたスキーマ・オブジェクト(SALES_DATA、CUSTOMER_DATAおよびPRODUCT_DATA)をスコープMY$COMPARTMENTに関連付け、そのコンパートメント内のエンティティに対する作成またはアクセスを制限します。

構文の参照は、「登録作成範囲」を参照してください。

プロバイダがアクセスを変更する必要がある場合、同じまたは別の認可ユーザーがUPDATE_CREATION_SCOPEを起動して、特定のスキーマ・オブジェクトのハイパーリンクを作成できるコンシューマAutonomous AIデータベースを拡張、絞り込む、または調整します。

BEGIN
DBMS_DATA_ACCESS_SCOPE.UPDATE_CREATION_SCOPE(
schema_name => 'ANALYTICS',
schema_object_name => 'SALES_DATA',
scope => 'MY$COMPARTMENT'
);
END;
/

この例では、ANALYTICSスキーマのSALES_DATA表の作成スコープをMY$COMPARTMENTに更新します。

構文の参照は、「作成範囲の更新」を参照してください。

プロバイダが(表、表のリストまたはスキーマに対して)リモート作成機能を完全に取り消す場合、プロバイダはUNREGISTER_CREATION_SCOPEをコールします。これにより、登録されたスコープが削除され、コンシューマ・データベースによってそれらのオブジェクトに対して新しい表ハイパーリンクが作成されなくなります。

BEGIN
DBMS_DATA_ACCESS_SCOPE.UNREGISTER_CREATION_SCOPE(
schema_name => 'ANALYTICS',
schema_object_name => 'SALES_DATA'
);
END;
/

このサンプル・ブロックは、ANALYTICSスキーマ内のSALES_DATAに対して以前に登録された作成スコープを削除するため、そのスコープの下に作成された新しいオブジェクトは、強制されるスコープをデータ・アクセスが制御しなくなります。

構文の参照は、「作成スコープの登録解除」を参照してください。

認可されたユーザーは、いつでもLIST_CREATION_SCOPESをコールして現在のスコープ定義を取得できます。

DECLARE
l_result CLOB;
BEGIN
DBMS_DATA_ACCESS_SCOPE.LIST_CREATION_SCOPES(
schema_name => 'ANALYTICS',
result => l_result
);
DBMS_OUTPUT.PUT_LINE(l_result);
END;
/

構文参照については、「作成範囲の取得」を参照してください。

コンシューマAutonomous AI Databaseでは、ADMIN (またはPDB_DBA)はDBMS_DATA_ACCESS_ADMIN.GRANT_READを使用して、リモート・プロバイダのスキーマまたはオブジェクトに対してフェデレーテッド表を作成する権限を特定のユーザーに付与します。

例: 特定のリモート・オブジェクトへのアクセス権の付与

BEGIN
DBMS_DATA_ACCESS_ADMIN.GRANT_READ(
username => 'BI_ANALYST',
remote_schema_name => 'ANALYTICS',
remote_schema_object_name => 'SALES_DATA'
);
END;
/

この例では、BI_ANALYSTユーザーに、外部データ・プロバイダのANALYTICSスキーマ内の特定のリモートSALES_DATAオブジェクトへの読取りアクセス権を付与します。

構文参照については、Grant Readを参照してください。

REVOKE_READプロシージャは、プロバイダ・データベース内の指定されたリモート・スキーマまたはスキーマ・オブジェクトに対してフェデレーテッド表を作成するユーザーの権限を削除します。

リモート・オブジェクト名を省略すると、指定されたリモート・スキーマ内のすべてのオブジェクトに対するそのユーザーのフェデレーテッド表アクセスが取り消されます。

例

BEGIN
DBMS_DATA_ACCESS_ADMIN.REVOKE_READ(
username => 'BI_ANALYST',
remote_schema_name => 'ANALYTICS',
remote_schema_object_name => 'SALES_DATA'
);
END;
/

構文参照については、「読取りの取消し」を参照してください。

読取り権限を付与されたコンシューマ・ユーザーは、DBMS_DATA_ACCESS.CREATE_FEDERATED_TABLEを起動して、プロバイダのスコープ内表またはビューにフェデレーテッド表を作成します。

このプロシージャでは、データベースOCIDsおよびリージョン情報を使用して表ハイパーリンクを確立し、コンシューマがリモート・データをローカル外部表であるかのように問い合せることができます。

前提条件

• ユーザーには、GRANT_READプロシージャを介して読取り権限を付与する必要があります。
• ユーザーは、必要な権限を持つコンシューマ・データベースとプロバイダ・データベースの両方に存在する必要があります。
• コンシューマ・データベースは、プロバイダの作成スコープに属している必要があります。
• プロバイダには、ターゲット・オブジェクトの作成スコープが登録されている必要があります。
• コンシューマ・データベースとプロバイダ・データベース間で確立されたネットワーク接続。

例: 単一プロバイダ

BEGIN
DBMS_DATA_ACCESS.CREATE_FEDERATED_TABLE(
table_name => 'SALES_FED',
remote_schema_name => 'ANALYTICS',
remote_schema_object_name => 'SALES_DATA',
db_ocids => '[{"region": "IAD", "db_ocid": "OCID1.AUTONOMOUSDATABASE.OC1.IAD.EXAMPLE123"}]'
);
END;
/

前述の例では、コンシューマがDBMS_DATA_ACCESS.CREATE_FEDERATED_TABLEをコールして、リモート・プロバイダの表またはビューにリンクするローカル・フェデレーテッド表(ANALYTICSスキーマのSALES_DATAなど)を作成します。JSON db_ocidsを使用して、プロバイダ・データベースのOCIDsおよびリージョンを指定し、ローカルと同様にシームレスに問合せを行います。

SELECT
REGION,
PRODUCT_ID,
SUM(SALES_AMOUNT) as total_sales,
COUNT(*) as transaction_count
FROM SALES_FED
GROUP BY REGION, PRODUCT_ID
ORDER BY total_sales DESC;

構文参照は、「フェデレーテッド表の作成」を参照してください。

フェデレーテッド・アクセスが不要になった場合、コンシューマ・ユーザーはDBMS_DATA_ACCESS.DROP_FEDERATED_TABLEをコールしてフェデレーテッド表を削除します。

このプロシージャは、コンシューマ側のオブジェクトをクリーン・アップし、その特定のフェデレーテッド・アクセス・パスを効果的に終了しますが、基礎となるプロバイダ・スコープおよび権限はプロバイダ制御のままです。

BEGIN
DBMS_DATA_ACCESS.DROP_FEDERATED_TABLE(
table_name => 'SALES_FED'
);
END;
/

前述の例では、SALES_FED表を削除します。

構文の参照は、フェデレーテッド表の削除を参照してください。