DBMS_DATA_ACCESS_SCOPEパッケージ

DBMS_DATA_ACCESS_SCOPEパッケージは、作成スコープを登録、登録解除、更新および取得するためのルーチンを提供します。

DBMS_DATA_ACCESS_SCOPE概要

DBMS_DATA_ACCESS_SCOPEパッケージの使用について説明します。

DBMS_DATA_ACCESS_SCOPEは、次の操作をサポートします。

  • 登録作成範囲
  • 作成スコープの登録解除
  • 作成範囲の更新
  • リスト作成範囲

DBMS_DATA_ACCESS_SCOPEセキュリティ・モデル

DBMS_DATA_ACCESS_SCOPEパッケージは、実行者権限PL/SQLパッケージとして実装されます。このパッケージでは、実行時にコール元ユーザーの権限がチェックされます。

EXECUTE権限は、GRANTオプションを指定したADMIN、およびGRANTオプションを指定しないPDB_DBAにデフォルトで提供されます。

DBMS_DATA_ACCESS_SCOPEサブプログラムの要約

この項では、Autonomous AI Databaseで提供されるDBMS_DATA_ACCESS_SCOPEサブプログラムについて説明します。

REGISTER_CREATION_SCOPEプロシージャ

このプロシージャは、特定のスキーマ、表またはビューに対する表ハイパーリンク作成の許可された認可スコープを登録します。

構文

procedure register_creation_scope(
  schema_name         IN VARCHAR2 DEFAULT NULL,
  schema_object_name  IN VARCHAR2 DEFAULT NULL,
  scope               IN VARCHAR2
);

procedure register_creation_scope(
  schema_name         IN VARCHAR2 DEFAULT NULL,
  schema_object_list  IN CLOB DEFAULT NULL,
  scope               IN VARCHAR2
);

パラメータ

パラメータ 摘要

schema_name

指定されたスコープ内で表を作成できるスキーマを指定します。このフィールドはオプションです。

schema_object_name

指定されたスコープに対して表の作成が許可されるスキーマ・オブジェクトを指定します。このパラメータはオプションです。nullまたは未指定のままにすると、設定はスキーマ全体に適用されます。

schema_object_list

これは、スキーマ内のオブジェクトをリストするオプションのJSON配列です。フィールドがnullまたは省略されている場合は、スキーマ全体に適用されます。

scope

表ハイパーリンクの作成範囲を定義します。

UNREGISTER_CREATION_SCOPEプロシージャ

このプロシージャは、すでに登録されている作成スコープを登録解除します。

構文

procedure unregister_creation_scope(
  schema_name         IN VARCHAR2 DEFAULT NULL,
  schema_object_name  IN VARCHAR2 DEFAULT NULL
);

procedure unregister_creation_scope(
  schema_name         IN VARCHAR2 DEFAULT NULL,
  schema_object_list  IN CLOB DEFAULT NULL
);

パラメータ

パラメータ 摘要

schema_name

スコープを削除する必要があるスキーマを指定します。このフィールドはオプションです。指定しない場合、またはNULLに設定されている場合、dbms_data_access_adminプロシージャを実行するユーザーのスキーマが自動的に使用されます。

schema_object_name

スコープを削除する必要があるスキーマ・オブジェクトを指定します。このフィールドはオプションです。省略するかNULLを指定した場合、登録解除操作はスキーマ全体の作成スコープに適用されます。

schema_object_list

スコープを削除する必要があるスキーマ内のオブジェクトのリストを指定します。このフィールドはオプションです。指定しない場合、またはその値がnullとして指定されている場合、登録解除操作はスキーマ全体の作成スコープに適用されます。

UPDATE_CREATION_SCOPEプロシージャ

このプロシージャは、すでに登録されている作成スコープを更新します。

構文

procedure update_creation_scope(
  schema_name         IN VARCHAR2 DEFAULT NULL,
  schema_object_name  IN VARCHAR2 DEFAULT NULL,
  scope               IN VARCHAR2
);

procedure update_creation_scope(
  schema_name         IN VARCHAR2 DEFAULT NULL,
  schema_object_list  IN CLOB DEFAULT NULL,
  scope               IN VARCHAR2
);

パラメータ

パラメータ 摘要

schema_name

スコープを更新する必要があるスキーマを指定します。このフィールドはオプションです。省略するかNULLを渡すと、ルーチンを実行しているユーザーのスキーマが自動的に使用されます。

schema_object_name

スコープを更新する必要があるスキーマ・オブジェクトを指定します。このフィールドはオプションです。省略するかNULLを渡すと、更新はスキーマ全体の作成スコープに適用されます。

schema_object_list

スキーマ内のオブジェクトのJSON配列リストを指定します。このフィールドはオプションです。指定しない場合、または値がnullとして指定されている場合、更新操作はスキーマ全体の作成スコープに適用されます。

scope

表ハイパーリンクの変更済作成範囲を指定します。

LIST_CREATION_SCOPESプロシージャ

このプロシージャは、すでに登録されている作成スコープを取得します。

構文

procedure list_creation_scopes(
  schema_name         IN VARCHAR2 DEFAULT NULL,
  schema_object_name  IN VARCHAR2 DEFAULT NULL,
  result              OUT CLOB
);

パラメータ

パラメータ 摘要

schema_name

スコープを戻す必要があるスキーマを指定します。このフィールドはオプションです。指定しない場合、またはNULLに設定されている場合、dbms_data_access_adminプロシージャを実行するユーザーのスキーマが自動的に使用されます。

schema_object_name

スコープを戻す必要があるスキーマ・オブジェクトを指定します。このフィールドはオプションです。省略するかNULLを指定した場合、登録解除操作はスキーマ全体の作成スコープに適用されます。

result

登録されたスコープ情報を含む出力を一覧表示します。