機械翻訳について

共有プロデューサ・サブプログラムのサマリー

この表は、受信者の共有を生成するために使用されるDBMS_SHAREパッケージのプロシージャおよびファンクションを示しています。

サブプログラム 説明
ADD_TO_SHAREプロシージャ 表またはビューを共有に追加します。
ASSERT_SHAREABLE_OBJECTプロシージャ オブジェクトが存在し、共有できる場合は、エラーなしで返します。
ASSERT_SHARING_IDプロシージャ 共有IDに対して基本検証チェックを実行し、標準形式で返します。
CAN_CREATE_SHAREファンクション この関数は、現在のスキーマが共有受信者を作成できるかどうかを確認します。
CAN_CREATE_SHARE_RECIPIENTファンクション この関数は、現在のスキーマが共有受信者を作成できるかどうかを確認します。
CLEAR_RECIPIENT_EVENTSプロシージャ 共有受信者イベント・ログからイベントを消去します。
CLEAR_SHARE_EVENTSプロシージャ 共有イベント・ログからイベントをクリアします。
CREATE_BEARER_TOKEN_CREDENTIALプロシージャ デルタ共有プロバイダでの使用に適した資格証明を作成します。
CREATE_CLOUD_STORAGE_LINKプロシージャ 名前付きクラウド・ストレージURIリンクを作成します。
CREATE_OR_REPLACE_CLOUD_STORAGE_LINKプロシージャ 名前付きクラウド・ストレージURIを作成または置き換えます。
CREATE_OR_REPLACE_SHARE_RECIPIENTプロシージャ 共有受信者を作成または置換します。
CREATE_SHAREプロシージャ 名前付き共有オブジェクトを作成します。
CREATE_SHARE_RECIPIENTプロシージャ 新しい共有受信者を作成します。
DROP_CLOUD_STORAGE_LINKプロシージャ クラウド・ストレージ・リンクを削除します。
DROP_RECIPIENTプロシージャ 受信者を削除します。
DROP_SHAREプロシージャ 共有およびそのすべてのコンテンツを削除します。
DROP_SHARE_LINK_VIEWプロシージャ CREATE_SHARE_LINK_VIEWプロシージャによって作成されたビューを削除します。
DROP_SHARE_VERSIONプロシージャ 単一の共有バージョンを削除します。
DROP_SHARE_VERSIONSプロシージャ 共有バージョンの範囲を削除します。
DROP_UNUSED_SHARE_VERSIONSプロシージャ 現在使用されていない共有バージョンを削除します。
ENABLE_SCHEMAプロシージャ 共有するスキーマを有効または無効にします。
GET_ACTIVATION_LINKファンクション 承認された受信者にEメールを送信するリンクを生成します。
GET_PUBLISHED_IDENTITYファンクション SET_PUBLISHED_IDENTITYによって設定された現在のユーザーに関するデータを取得します。
GET_RECIPIENT_PROPERTYファンクション 受信者のプロパティの値を返します。
GET_SHARE_PROPERTYファンクション 既存のシェアのプロパティ値を取得します。
GET_SHARE_TABLE_PROPERTYファンクション 既存の共有表のプロパティ値を取得します。
GRANT_TO_RECIPIENTプロシージャ 共有に対するアクセス権を特定の受信者に付与します。
POPULATE_SHARE_PROFILEプロシージャ 受信者のデルタ・プロファイルを生成します。
PUBLISH_SHAREプロシージャ 共有を公開し、すぐに返します。
PUBLISH_SHARE_WAITプロシージャ 共有を公開し、バックグラウンド・ジョブが完了するまで待機します。
PURGE_DETACHED_FILESプロシージャ 共有から切り離されたparquetファイルを削除するか、破棄します。
REMOVE_FROM_SHAREプロシージャ 共有から表またはビューを削除します。
RENAME_RECIPIENTプロシージャ 受信者の名前を変更します。
RENAME_SHAREプロシージャ シェアの名前を変更します。
RENAME_SHARE_LINKプロシージャ 登録済みの共有リンクの名前を変更します。
RENAME_SHARE_SCHEMAプロシージャ 共有スキーマの名前を変更します。
RENAME_SHARE_TABLEプロシージャ 共有表の名前を変更します。
REVOKE_FROM_RECIPIENTプロシージャ 特定の受信者からの共有に対するアクセス権を取り消します。
SET_CURRENT_SHARE_VERSIONプロシージャ 共有の現在のバージョンを変更します。
SET_PUBLISHED_IDENTITYプロシージャ 公開されているORACLE共有の受信者に提供される現在のユーザーに関するデータを設定します。
SET_RECIPIENT_LOG_LEVELプロシージャ 既存の共有受信者のログ・レベルを変更します。
SET_SHARE_LOG_LEVELプロシージャ 既存のシェアのログ・レベルを変更します。
SET_STORAGE_CREDENTIALプロシージャ 指定されたストレージのアクセス資格証明名を設定します。
STOP_JOBプロシージャ 実行中の共有ジョブを停止します。
UNPUBLISH_SHAREプロシージャ 共有を非公開にします。
UPDATE_DEFAULT_RECIPIENT_PROPERTYプロシージャ デフォルトの受信者プロパティ値を更新します。
UPDATE_DEFAULT_SHARE_PROPERTYプロシージャ デフォルトの共有プロパティ値を更新します。
UPDATE_RECIPIENT_PROPERTYプロシージャ 既存の受信者のプロパティを更新します。
UPDATE_SHARE_JOB_PROPERTYプロシージャ 実行中の共有ジョブのプロパティを変更します。
UPDATE_SHARE_PROPERTYプロシージャ 既存のシェアのプロパティを更新します。
UPDATE_SHARE_TABLE_PROPERTYプロシージャ 既存の共有表のプロパティ値を更新します。
VALIDATE_CREDENTIALファンクション 資格証明名を検証し、必要に応じてまず標準形式に変換します。
VALIDATE_SHARE_STORAGEプロシージャ 指定されたストレージがバージョン管理されたシェアに適しているかどうかを確認します。
WAIT_FOR_JOBプロシージャ このプロシージャは、指定された共有ジョブが完了するまで待機します。

親トピック: DBMS_SHAREパッケージ

ADD_TO_SHAREプロシージャ

表またはビューを共有に追加します。 オブジェクトは、共有へのアクセス権を付与された外部ユーザーが参照できるようになります。

構文

PROCEDURE ADD_TO_SHARE  
(
    share_name           IN VARCHAR2,
    table_name           IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    share_table_name     IN VARCHAR2 := NULL,
    share_schema_name    IN VARCHAR2 := NULL,
    object_metadata      IN SYS.JSON_OBJECT_T := NULL,
    replace_existing     IN BOOLEAN := FALSE,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

パラメータ

パラメータ 説明
share_name オブジェクトが付与されている既存の共有の名前。
table_name 共有するエンティティの名前(表名やビュー名など)。
owner 共有するエンティティの所有者。 デフォルトは現在のスキーマです。
share_table_name 表の外部に表示される名前。 デフォルトでは、これは大文字のtable_nameです。
share_schema_name 表が配置される外部に表示されるスキーマ。 デフォルトでは、これは大文字の表所有者です。 スキーマが存在しない場合は自動的に作成されます。
object_metadata 共有エンティティに関連付けるオプションのメタデータ。
replace_existing TRUEで、このshare_table_nameがすでに存在する場合、既存のtable_nameは共有から削除され、このtable_nameに置き換えられます。

FALSEで、このshare_table_nameがすでに存在する場合は、共有表がすでに使用されていることを示す例外が発生します。

share_owner 共有の所有者。
auto_commit TRUEの場合、このプロシージャ・コールは、コミットが実行されるまで外部から表示されない変更をコミットします。 デフォルト値はFALSEです。つまり、変更を表示するには、このコールの実行後にユーザーがCOMMITを実行する必要があります。

親トピック: 共有プロデューサ・サブプログラムのサマリー

ASSERT_SHAREABLE_OBJECTプロシージャ

オブジェクトが存在し、共有できる場合は、エラーなしで返します。

構文

PROCEDURE ASSERT_SHAREABLE_OBJECT
(
  object_name          IN VARCHAR2,
  object_owner         IN VARCHAR2 := NULL
);

パラメータ

パラメータ 説明
object_name オブジェクトの名前。
object_owner オブジェクトの所有者。 デフォルトは現行のスキーマです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

ASSERT_SHARING_IDプロシージャ

共有IDに対して基本検証チェックを実行し、標準形式で返します。 IDが無効な場合は例外が発生します。

構文

PROCEDURE ASSERT_SHARING_ID  
(
    sharing_id              IN OUT NOCOPY VARCHAR2,
    out_sharing_id_type     IN OUT NOCOPY VARCHAR2  
);

パラメータ

パラメータ 説明
sharing_id チェックするID。
out_sharing_id_type IDのタイプ(有効な場合)。 たとえば、TENANCYまたはDATABASEです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

CAN_CREATE_SHAREファンクション

この関数は、現在のスキーマが共有受信者を作成できるかどうかを確認します。 共有を作成できる場合は、1が返され、それ以外の場合は0が返されます。

構文

FUNCTION CAN_CREATE_SHARE
RETURN NUMBER;

例: 管理スキーマの有効化前および有効化後

SQL> select dbms_share.can_create_share from dual;
 CAN_CREATE_SHARE
----------------
               0 
SQL> exec dbms_share.enable_schema('admin') 
PL/SQL procedure successfully completed. 
SQL> select dbms_share.can_create_share from dual; 
CAN_CREATE_SHARE
----------------
               1

親トピック: 共有プロデューサ・サブプログラムのサマリー

CAN_CREATE_SHARE_RECIPIENTファンクション

この関数は、現在のスキーマが共有受信者を作成できるかどうかを確認します。 シェアを作成できる場合は1が返され、それ以外の場合は0が返されます。

構文

FUNCTION CAN_CREATE_SHARE_RECIPIENT
RETURN NUMBER;

親トピック: 共有プロデューサ・サブプログラムのサマリー

CLEAR_RECIPIENT_EVENTSプロシージャ

共有受信者イベント・ログからイベントを消去します。

構文

PROCEDURE CLEAR_RECIPIENT_EVENTS 
(
   recipient_name       IN VARCHAR2,
   from_time            IN TIMESTAMP WITH TIME ZONE := NULL,
   to_time              IN TIMESTAMP WITH TIME ZONE := NULL,
   recipient_owner      IN VARCHAR2 := NULL 
);

パラメータ

パラメータ 説明
recipient_name 共有受信者のローカル名。
from_time クリアまたはNULLにするイベントの最早時間。
to_time クリアまたはNULLのイベントの最遅時間。
recipient_owner 受信者を所有するスキーマ。

親トピック: 共有プロデューサ・サブプログラムのサマリー

CLEAR_SHARE_EVENTSプロシージャ

共有イベント・ログからイベントをクリアします。

構文

PROCEDURE CLEAR_SHARE_EVENTS 
(
    share_name           IN VARCHAR2,
    from_time            IN TIMESTAMP WITH TIME ZONE := NULL,
    to_time              IN TIMESTAMP WITH TIME ZONE := NULL,
    share_owner          IN VARCHAR2 := NULL 
);

パラメータ

パラメータ 説明
share_name 共有の名前。
from_time クリアまたはNULLにするイベントの最早時間。
to_time クリアまたはNULLのイベントの最遅時間。
share_owner 共有を所有するスキーマ。

親トピック: 共有プロデューサ・サブプログラムのサマリー

CREATE_BEARER_TOKEN_CREDENTIALプロシージャ

デルタ共有プロバイダでの使用に適した資格証明を作成します。

これはCREATE_CREDENTIALSコールと似ていますが、デルタ共有プロファイルではなく明示的な値を使用します。 詳細は、「CREATE_CREDENTIALSプロシージャおよびファンクション」を参照してください。

構文

PROCEDURE CREATE_BEARER_TOKEN_CREDENTIAL 
(
   credential_name      IN VARCHAR2,
   bearer_token         IN VARCHAR2 := NULL,
   token_endpoint       IN VARCHAR2 := NULL,
   client_id            IN VARCHAR2 := NULL,
   client_secret        IN VARCHAR2 := NULL,
   token_refresh_rate   IN PLS_INTEGER := 3600 
);

パラメータ

パラメータ 説明
credential_name 新規資格証明の名前。
bearer_token Bearerトークン(わかっている場合)。
token_endpoint 新しいトークンを取得するためにコールするエンドポイント。
client_id token_endpointに送信するユーザー名。
client_secret token_endpointに送信するパスワード。
token_refresh_rate オプションのリフレッシュ時間(秒)。

例: 固定ベアラー・トークンを使用した資格証明

最も単純な形式では、このプロシージャはユーザー名が'BEARER_TOKEN'でDBMS_CREDENTIALをコールし、Bearerトークン自体をパスワードとしてコールすることと同じです。 

SQL> exec dbms_share.create_bearer_token_credential('MY_FIXED_CREDENTIAL', 'FF42322D27D4C2DEE05392644664351E')
PL/SQL procedure successfully completed. 
SQL> select username from user_credentials where credential_name = 'MY_FIXED_CREDENTIAL';
USERNAME
------------------------------------------------------------------------------------------------------------------------
BEARER_TOKEN

例: 更新可能なベアラー・トークンを使用した資格証明

トークン・エンドポイントから取得した短期間のベアラー・トークンを含む資格証明を作成します。 Bearerトークンは、クライアントIDおよびシークレットから移入される2番目の資格証明を使用して1時間ごとにリフレッシュされます。 

SQL> BEGIN
  2    dbms_share.create_bearer_token_credential(
  3      credential_name=>'MY_RENEWABLE_CREDENTIAL',
  4      token_endpoint=>'https://myserver/ords/share_provider/oauth/token',
  5      client_id=>'VXGQ_44s6qJ-K4WHUNM2yQ..',
  6      client_secret=>'y9ddppgwEmZl7adDHFQndw..');
  7  END;
  8  /
 PL/SQL procedure successfully completed.
 SQL> select credential_name, username from user_credentials where credential_name LIKE 'MY_RENEWABLE_CREDENTIAL%';
 CREDENTIAL_NAME                              USERNAME
------------------------------------------    -------------------------------------
MY_RENEWABLE_CREDENTIAL                       BEARER_TOKEN
MY_RENEWABLE_CREDENTIAL$TOKEN_REFRESH_CRED    VXGQ_44s6qJ-K4WHUNM2yQ..

親トピック: 共有プロデューサ・サブプログラムのサマリー

CREATE_CLOUD_STORAGE_LINKプロシージャ

名前付きクラウド・ストレージURIリンクを作成します。 クラウド・ストレージ・リンクは、OCIバケットURIとローカル資格証明名の間の名前付き関連付けです。

ノート:

「SET_STORAGE_CREDENTIALプロシージャ」を使用して、ストレージ・リンクに資格証明を追加します。

構文

PROCEDURE CREATE_CLOUD_STORAGE_LINK
(
  storage_link_name    IN VARCHAR2,
  uri                  IN VARCHAR2,
  owner                IN VARCHAR2 := NULL,
  metadata             IN SYS.JSON_OBJECT_T := NULL,
  auto_commit          IN BOOLEAN := TRUE
);

パラメータ

パラメータ 説明
storage_link_name クラウド・ストレージ・リンクの名前。 リンクの名前は、標準のOracleネーミング規則に従う必要があります。
uri ストレージ・バケットのURI。 URIはhttps://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucket/oの形式にする必要があります
owner ストレージ・リンクの所有者。 現在のユーザーに対してはNULLのままにします。
metadata (オプション)追加情報を含むJSONメタデータ・ドキュメント。
auto_commit デフォルトはTRUEです。 TRUEの場合、このトランザクションはコミットされます。 FALSEの場合、ユーザーはトランザクションをコミットする必要があります。 コミットが実行されるまで、変更は表示されません。

例

この例では、指定されたURLにMY_SHARE_STORAGEという名前のクラウド・ストレージ・リンクが作成されます。 

SQL> BEGIN
  2    dbms_share.create_cloud_storage_link(
  3      'MY_SHARE_STORAGE',
  4      'https://objectstorage.../n/abcdef/b/my_bucket/o' );
  5  END;
  6  /

PL/SQL procedure successfully completed.

SQL> select storage_link_name from user_lineage_cloud_storage_links;

STORAGE_LINK_NAME
----------------------------------------------------------------------------------------
MY_SHARE_STORAGE

親トピック: 共有プロデューサ・サブプログラムのサマリー

CREATE_OR_REPLACE_CLOUD_STORAGE_LINKプロシージャ

名前付きクラウド・ストレージURIを作成または置き換えます。 クラウド・ストレージ・リンクは、OCIバケットURIとローカル資格証明名の間の名前付き関連付けです。

ノート:

「SET_STORAGE_CREDENTIALプロシージャ」を使用して、ストレージ・リンクに資格証明を追加します。

構文

PROCEDURE CREATE_OR_REPLACE_CLOUD_STORAGE_LINK  
(
    storage_link_name    IN VARCHAR2,
    uri                  IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    metadata             IN SYS.JSON_OBJECT_T := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

パラメータ

パラメータ 説明
storage_link_name クラウド・ストレージ・リンクの名前。 リンクの名前は、標準のOracleネーミング規則に従う必要があります。 「データベース・オブジェクト名および修飾子」を参照してください
uri ストレージ・バケットのURI。 URIはhttps://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucket/oの形式にする必要があります
owner ストレージ・リンクの所有者。 デフォルトは現在のスキーマです。
metadata 追加情報を含むオプションのJSONメタデータ・ドキュメント。
auto_commit TRUEの場合、変更はリンクの作成後に自動的にコミットされます。 デフォルトはTRUEです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

CREATE_OR_REPLACE_SHARE_RECIPIENTプロシージャ

共有受信者を作成または置換します。 少なくとも1つのEメール・アドレスまたは共有IDを指定する必要があります。

構文

PROCEDURE CREATE_OR_REPLACE_SHARE_RECIPIENT  
(
    recipient_name       IN VARCHAR2,
    description          IN VARCHAR2 := NULL,
    recipient_owner      IN VARCHAR2 := NULL,
    email                IN VARCHAR2 := NULL,
    sharing_id           IN VARCHAR2 := NULL  
);

パラメータ

パラメータ 説明
recipient_name 共有受信者のローカル名。 許可されていない名前もあります(例: MY_TENANCY)。
description 受信者の説明。
recipient_owner 受信者を所有するスキーマ。
email OAUTHユーザーに対して登録されるEメール。
sharing_id 「GET_SHARING_IDファンクション」からの受信者の共有ID。

親トピック: 共有プロデューサ・サブプログラムのサマリー

CREATE_SHAREプロシージャ

名前付き共有オブジェクトを作成します。

構文

PROCEDURE CREATE_SHARE
(
  share_name           IN VARCHAR2,
  share_type           IN VARCHAR2 := SHARE_TYPE_VERSIONED,
  storage_link_name    IN VARCHAR2 := NULL,
  storage_link_owner   IN VARCHAR2 := NULL,
  description          IN VARCHAR2 := NULL,
  public_description   IN VARCHAR2 := NULL,
  configuration        IN SYS.JSON_OBJECT_T := NULL,
  force_create         IN BOOLEAN  := FALSE,
  share_owner          IN VARCHAR2 := NULL,
  auto_commit          IN BOOLEAN := FALSE,
  log_level            IN PLS_INTEGER := LOG_LEVEL_BASIC,
  run_storage_tests    IN BOOLEAN := TRUE
);

パラメータ

パラメータ 説明
share_name 共有の名前。 デルタ共有では大文字と小文字が区別されないため、この名前は大文字になります。 名前は標準のOracleの表記規則に従っているため、128文字以下で、単純な識別子でない場合は二重引用符で囲む必要があります。 唯一の違いは、二重引用符で囲まれていても大文字になることです。
share_type 共有のタイプ。 このパラメータに使用される定数の詳細は、「DBMS_SHARE定数」の「共有タイプ」の説明を参照してください。
storage_link_name オブジェクトが作成されるクラウド・ストレージ・リンクの名前。 ユーザーは、このストレージへの読取り/書込みアクセス権を持ち、ストレージで事前認証済リクエストを作成する権限を持っている必要があります。 このパラメータは、バージョン管理された共有の場合は必須で、現在の共有の場合はオプションです。
storage_link_owner オブジェクトが作成されるクラウド・ストレージ・リンクの所有者。
description 共有のローカルな説明。
public_description 共有の公開説明。
configuration オブジェクトの作成方法を定義する構成ドキュメント。
force_create force_createをTRUEに設定して、共有が存在する場合に再定義します。
share_owner 共有の所有者。
auto_commit TRUEの場合、このプロシージャ・コールは、コミットが実行されるまで外部から表示されない変更をコミットします。 デフォルト値はFALSEです。つまり、変更を表示するには、このコールの実行後にユーザーがCOMMITを実行する必要があります。
log_level イベント・ロギング・レベル。 「ALL_SHARE_EVENTSビュー」に記録される詳細の量を制御します。 このパラメータに使用される定数の詳細は、「DBMS_SHARE定数」の「ログ・レベル」の説明を参照してください。
run_storage_tests このパラメータがTRUEの場合、DBMS_SHAREは、指定された共有ストレージ・リンクに正しい権限があることを検証するためのテストを実行します。

このパラメータがFALSEの場合、プロシージャは作成時にチェックを実行しません。 これは、公開中または共有の消費中に、あとでエラーが発生する可能性があります。

Oracleでは、このパラメータにTRUEを指定することをお薦めします。

親トピック: 共有プロデューサ・サブプログラムのサマリー

CREATE_SHARE_RECIPIENTプロシージャ

新しい共有受信者を作成します。

構文

PROCEDURE CREATE_SHARE_RECIPIENT  
(
    recipient_name       IN VARCHAR2,
    description          IN VARCHAR2 := NULL,
    recipient_owner      IN VARCHAR2 := NULL,
    email                IN VARCHAR2 := NULL,
    sharing_id           IN VARCHAR2 := NULL  
);

パラメータ

パラメータ 説明
recipient_name 共有受信者のローカル名。 たとえば、一部の名前は許可されていません: MY_TENANCY。
description 受信者の説明。
recipient_owner 受信者を所有するスキーマ。
email OAUTHユーザーに対して登録されるEメール。 少なくともひとつのメール・アドレスか共有IDが必要です。
sharing_id 「GET_SHARING_IDファンクション」からの受信者の共有ID。 少なくともひとつのメール・アドレスか共有IDが必要です。

親トピック: 共有プロデューサ・サブプログラムのサマリー

DROP_CLOUD_STORAGE_LINKプロシージャ

クラウド・ストレージ・リンクを削除します。

構文

PROCEDURE DROP_CLOUD_STORAGE_LINK  
(
    storage_link_name    IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

パラメータ

パラメータ 説明
storage_link_name 削除するクラウド・ストレージ・リンクの名前。
owner クラウド・ストレージ・リンクの所有者。 現在のユーザーに対してはNULLのままにします。
auto_commit TRUEの場合、コードはリンクの削除後に自動的にコミットされます。 デフォルトはTRUEです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

DROP_RECIPIENTプロシージャ

受信者を削除します。 受信者へのすべてのアクセスが取り消されます。

構文

PROCEDURE DROP_RECIPIENT  
(
    recipient_name       IN VARCHAR2,
    owner                IN VARCHAR2 := NULL  
);

パラメータ

パラメータ 説明
recipient_name 共有受信者の名前。
owner 受信者を定義するスキーマ。

親トピック: 共有プロデューサ・サブプログラムのサマリー

DROP_SHAREプロシージャ

共有およびそのすべてのコンテンツを削除します。 コンシューマによるシェアへの将来のアクセスは終了します。

構文

PROCEDURE DROP_SHARE
(
  share_name           IN VARCHAR2,
  share_owner          IN VARCHAR2 := NULL,
  destroy_objects      IN BOOLEAN := TRUE
);

パラメータ

パラメータ 説明
share_name 削除するシェアの名前。
share_owner 削除するシェアの所有者。
destroy_objects TRUEの場合、共有のかわりに作成されたすべてのオブジェクトを削除します。 デフォルトはTRUEです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

DROP_SHARE_LINK_VIEWプロシージャ

CREATE_SHARE_LINK_VIEWプロシージャによって作成されたビューを削除します。

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

構文

PROCEDURE DROP_SHARE_LINK_VIEW  
(
    view_name            IN VARCHAR2,
    view_owner           IN VARCHAR2 := NULL  
);

パラメータ

パラメータ 説明
view_name 新しいビューの名前。
view_owner ビューの所有者。 デフォルトは現在のスキーマです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

DROP_SHARE_VERSIONプロシージャ

単一の共有バージョンを削除します。 現在のバージョンは削除できないことに注意してください。

構文

PROCEDURE DROP_SHARE_VERSION  
(
    share_name           IN VARCHAR2,
    share_version        IN NUMBER,
    destroy_objects      IN BOOLEAN := TRUE,
    force_drop           IN BOOLEAN := FALSE,
    share_owner          IN VARCHAR2 := NULL  
);

パラメータ

パラメータ 説明
share_name 共有の名前。
share_version 削除するバージョン。 現在のバージョンは削除できません。
destroy_objects 該当する場合は、クラウド・ストレージ内の関連付けられたオブジェクトをすべて破棄します。
force_drop バージョンに未処理のPARファイルがある場合でも、共有バージョンを削除します。
share_owner 共有の所有者。

親トピック: 共有プロデューサ・サブプログラムのサマリー

DROP_SHARE_VERSIONSプロシージャ

共有バージョンの範囲を削除します。 この手順を使用して現在のバージョンを削除することはできません。

構文

PROCEDURE DROP_SHARE_VERSIONS  
(
    share_name           IN VARCHAR2,
    from_share_version   IN NUMBER,
    to_share_version     IN NUMBER,
    destroy_objects      IN BOOLEAN := TRUE,
    force_drop           IN BOOLEAN := FALSE,
    share_owner          IN VARCHAR2 := NULL  
);

パラメータ

パラメータ 説明
share_name 共有の名前。
from_share_version 削除する最低バージョン。
to_share_version ドロップする最上位のバージョン。
destroy_objects 該当する場合は、クラウド・ストレージ内の関連付けられたオブジェクトをすべて破棄します。
force_drop バージョンに未処理のPARファイルがある場合でも、共有バージョンを削除します。
share_owner 共有の所有者。

親トピック: 共有プロデューサ・サブプログラムのサマリー

DROP_UNUSED_SHARE_VERSIONSプロシージャ

現在使用されていない共有バージョンを削除します。

構文

PROCEDURE DROP_UNUSED_SHARE_VERSIONS  
(
    share_name           IN VARCHAR2,
    destroy_objects      IN BOOLEAN := TRUE,
    share_owner          IN VARCHAR2 := NULL  
);

パラメータ

パラメータ 説明
share_name 共有の名前。
destroy_objects 該当する場合は、クラウド・ストレージ内の関連付けられたオブジェクトをすべて破棄します。
share_owner 共有の所有者。

親トピック: 共有プロデューサ・サブプログラムのサマリー

ENABLE_SCHEMAプロシージャ

共有するスキーマを有効または無効にします。 このプロシージャは、ADMINユーザーが実行する必要があります。

構文

ユーザーは、この手順で有効にしなくてもデルタ共有を使用できますが、共有を作成または公開することはできません。 ADMINを含むすべてのスキーマでは、共有はデフォルトで無効になっています。 

PROCEDURE ENABLE_SCHEMA  
(
    schema_name          IN VARCHAR2,
    enabled              IN BOOLEAN := TRUE,
    privileges           IN PLS_INTEGER := NULL
);

パラメータ

パラメータ 説明
schema_name 有効化または無効化するスキーマ。
enable 有効にする場合はTRUE、無効にする場合はFALSE。
privileges 権限引数にはビットマップ値があります。 引数をNULLのままにすると、デフォルトでPRIV_CREATE_SHARE + PRIV_CREATE_RECIPIENT + PRIV_CONSUME_ORACLE_SHAREになります。

ビットマップの値は次のとおりです:
  • PRIV_CREATE_SHARE
    ユーザーが自分のスキーマに公開共有を作成できるようにします。
    PRIV_CREATE_SHARE         CONSTANT PLS_INTEGER := 1;
  • PRIV_CREATE_RECIPIENT

    ユーザーが自分のスキーマに共有受信者を作成できます。

    PRIV_CREATE_RECIPIENT     CONSTANT PLS_INTEGER := 2;
  • PRIV_CONSUME_ORACLE_SHARE

    ユーザーがOracleとOracleのライブ・シェアを使用できるようにします。

    PRIV_CONSUME_ORACLE_SHARE CONSTANT PLS_INTEGER := 4;
  • PRIV_ORDS_ACL

    ローカルORDSエンドポイントでACLをユーザーに付与します。 これは、ユーザーがローカルに作成されたシェアでトークンを生成するために必要です。 

    PRIV_ORDS_ACL             CONSTANT PLS_INTEGER := 8;

親トピック: 共有プロデューサ・サブプログラムのサマリー

GET_ACTIVATION_LINKファンクション

承認された受信者にEメールを送信するリンクを生成します。 このアクティブ化リンクをクリックすると、ダウンロード・ページが表示され、受信者はボタンをクリックしてデルタ・プロファイルを取得します。

構文

FUNCTION GET_ACTIVATION_LINK
(
  recipient_name       IN VARCHAR2,
  recipient_owner      IN VARCHAR2 := NULL,
  expiration           IN PLS_INTEGER := 259200,
  invalidate_previous  IN BOOLEAN := TRUE
)
RETURN VARCHAR2;

パラメータ

パラメータ 説明
recipient_name 受信者のローカル名。
recipient_owner 受信者を所有するスキーマ。
expiration アクティブ化リンクが期限切れになるまでの秒数。
invalidate_previous TRUE(デフォルト)の場合、以前に生成されたアクティブ化リンクは無効になります。 FALSEの場合、以前に生成されたアクティブ化リンクは有効なままです。

例: 画面へのアクティブ化リンクの印刷

SQL> exec dbms_share.create_share_recipient('new_recipient', email=>'anyone@example.com')

PL/SQL procedure successfully completed.

SQL> column PROFILE format A200
SQL> variable sprof varchar2(32767)
SQL> declare
  2    profile sys.json_object_t;
  3  begin
  4    dbms_share.populate_share_profile('NEW_RECIPIENT', profile);
  5    :sprof := profile.to_string;
  6  end;
  7  /
PL/SQL procedure successfully completed.

SQL> exec dbms_output.put_line(dbms_share.get_activation_link('NEW_RECIPIENT'))
http://.../ords/_adpshr/delta-sharing/download?key=43BA....YXJlX3Rlc3Q= 

PL/SQL procedure successfully completed.

親トピック: 共有プロデューサ・サブプログラムのサマリー

GET_PUBLISHED_IDENTITYファンクション

SET_PUBLISHED_IDENTITYによって設定された現在のユーザーに関するデータを取得します。

構文

FUNCTION GET_PUBLISHED_IDENTITY
  RETURN CLOB;

例

SQL> declare
  2    id_json json_object_t := json_object_t();
  3  begin
  4    id_json.put('name', 'Demo Publisher');
  5    id_json.put('description', 'Documentation Share Provider');
  6    id_json.put('contact', 'null@example.com');
  7    dbms_share.set_published_identity(id_json);
  8  end;
  9  /

PL/SQL procedure successfully completed.

SQL> select json_query(dbms_share.get_published_identity, '$' pretty) "Published Identity"
  2  from dual;

Published Identity-
-------------------------------------------------------------------------------
{
  "name" : "Demo Publisher",
  "description" : "Documentation Share Provider",
  "contact" : "null@example.com"
}

親トピック: 共有プロデューサ・サブプログラムのサマリー

GET_RECIPIENT_PROPERTYファンクション

受信者のプロパティの値を返します。

構文

FUNCTION GET_RECIPIENT_PROPERTY
(
  recipient_name       IN VARCHAR2,
  recipient_property   IN VARCHAR2,
  recipient_owner      IN VARCHAR2 := NULL
)RETURN VARCHAR2;

パラメータ

パラメータ 説明
recipient_name 受信者の名前。
recipient_property 取得するプロパティ。 次のようなプロパティがあります。
  • PROP_SHARE_DESC
  • PROP_SHARE_PUBLIC_DESC
  • PROP_SHARE_VERSION_ACCESS
  • PROP_SHARE_JOB_NAME
  • PROP_SHARE_SPLIT_SIZE
  • PROP_SHARE_LOG_LEVEL
  • PROP_SHARE_JOB_DOP
  • PROP_SHARE_JOB_CLASS
  • PROP_SHARE_JOB_PRIORITY
  • PROP_SHARE_VERSION_ACCESS

このパラメータに使用される定数の詳細は、「DBMS_SHARE定数」の「共有プロパティ」の説明を参照してください。

recipient_owner 受信者の所有者。 デフォルトは現在のユーザーです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

GET_SHARE_PROPERTYファンクション

既存のシェアのプロパティ値を取得します。

構文

FUNCTION GET_SHARE_PROPERTY
(
  share_name       IN VARCHAR2,
  share_property   IN VARCHAR2,
  share_owner      IN VARCHAR2 := NULL
)
RETURN VARCHAR2

パラメータ

パラメータ 説明
share_name 共有の名前。
share_property 取得するプロパティ値。 このパラメータに使用される定数の詳細は、「DBMS_SHARE定数」の「共有プロパティ」の説明を参照してください。
share_owner 共有の所有者。 デフォルトは現在のユーザーです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

GET_SHARE_TABLE_PROPERTYファンクション

既存の共有表のプロパティ値を取得します。

構文

FUNCTION GET_SHARE_TABLE_PROPERTY
(
  share_name           IN VARCHAR2,
  share_table_name     IN VARCHAR2,
  share_table_property IN VARCHAR2,
  share_schema_name    IN VARCHAR2 := NULL,
  share_owner          IN VARCHAR2 := NULL
)RETURN VARCHAR2;

パラメータ

パラメータ 説明
share_name 共有の名前。
share_table_name 共有表の名前。
share_table_property 更新する共有表のプロパティ。 このパラメータに使用される定数の詳細は、「DBMS_SHARE定数」の「表プロパティの共有」の説明を参照してください。
share_schema_name 共有スキーマの名前。 デフォルトは現在のユーザーの大文字です。
share_owner 共有の所有者。

親トピック: 共有プロデューサ・サブプログラムのサマリー

GRANT_TO_RECIPIENTプロシージャ

共有に対するアクセス権を特定の受信者に付与します。 共有と受信者の両方が同じスキーマに属している必要があります。

構文

PROCEDURE GRANT_TO_RECIPIENT  
(
    share_name           IN VARCHAR2,
    recipient_name       IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

パラメータ

パラメータ 説明
share_name 付与する共有の名前。
recipient_name 受信者の名前。
owner 共有と受信者の両方の所有者。
auto_commit auto_commitパラメータは無視されます。 この手順は、常にコミットされます。

親トピック: 共有プロデューサ・サブプログラムのサマリー

POPULATE_SHARE_PROFILEプロシージャ

受信者のデルタ・プロファイルを生成します。 これを画面に印刷するか、どこかでアップロードできます。 たとえば、DBMS_CLOUD.EXPORT_DATAを使用したオブジェクト・バケットの場合です。

構文

PROCEDURE POPULATE_SHARE_PROFILE  
(
    recipient_name       IN VARCHAR2,
    share_profile        IN OUT NOCOPY SYS.JSON_OBJECT_T,
    recipient_owner      IN VARCHAR2 := NULL  
);

パラメータ

パラメータ 説明
recipient_name 受信者のローカル名。
share_profile Bearerトークンなしの共有プロファイル。
recipient_owner 受信者を所有するスキーマ。

例: プロファイルを画面に印刷します。

SQL> EXEC DBMS_SHARE.CREATE_SHARE_RECIPIENT('new_recipient', email=>'anyone@example.com')
 
PL/SQL procedure successfully completed. 
SQL> column PROFILE format A200
SQL> variable sprof varchar2(32767)
SQL> declare
  2    profile sys.json_object_t;
  3  begin
  4    dbms_share.populate_share_profile('NEW_RECIPIENT', profile);
  5    :sprof := profile.to_string;
  6  end;
  7  /

PL/SQL procedure successfully completed. 

SQL> select json_query(:sprof, '$' pretty) "PROFILE" from dual;
PROFILE------------------------------------------------------------------------------------------------------------------------
{
  "shareCredentialsVersion" : 1,
  "endpoint" : "https://.../ords/share_test/_delta_sharing/",
  "bearerToken" : "mc7puvhqCpU6xjTOjRdl_w",
  "tokenEndpoint" : "https://.../ords/share_test/oauth/token",
  "clientID" : "VXGQ_44s6qJ-K4WHUNM2yQ..",
  "clientSecret" : "y9ddppgwEmZl7adDHFQndw.."
}

親トピック: 共有プロデューサ・サブプログラムのサマリー

PUBLISH_SHAREプロシージャ

共有を公開し、すぐに返します。

発行はバックグラウンドで続行されます。 USER_SHARE_JOBSビューを問い合せると、ジョブのステータスを確認できます。 詳細は、「USER_SHARE_JOBSビュー」を参照してください。

構文

PROCEDURE PUBLISH_SHARE  
(
    share_name           IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    drop_prior_versions  IN BOOLEAN := FALSE,
    share_job_dop        IN NUMBER := NULL,
    share_job_priority   IN NUMBER := NULL,
    job_class            IN VARCHAR2 := 'DEFAULT_JOB_CLASS',
    force_job_class      IN BOOLEAN := FALSE  
);

パラメータ

パラメータ 説明
share_name 公開する共有の名前。
share_owner 共有所有者。現在のユーザーまたはNULLである必要があります。
drop_prior_versions 共有の以前のバージョンをすべて削除する場合は、TRUEに設定します。 未処理の事前認証済リクエスト(PAR)がない場合のみ、バージョンは削除されます。
share_job_dop 共有の公開に使用されるdbms_schedulerジョブの最大数を指定します。 システムのデフォルト番号を使用する場合は、NULLのままにします。
share_job_priority 他のユーザーと比較して、この共有公開の相対的な優先度を指定します。 2つの共有が同時に公開されている場合は、あとで開始された場合でも、もっとも高い優先度を持つ共有が最初に処理されます。
job_class all_scheduler_job_classesのスケジューラ・ジョブ・クラスで、共有の公開に使用されます。
force_job_class 管理者が別のデフォルト・ジョブ・クラスを定義している場合でも、指定されたjob_classを使用します。

親トピック: 共有プロデューサ・サブプログラムのサマリー

PUBLISH_SHARE_WAITプロシージャ

共有を公開し、バックグラウンド・ジョブが完了するまで待機します。 コールが中断された場合でも、パブリケーションは続行されます。

構文

PROCEDURE PUBLISH_SHARE_WAIT  
(
       share_name           IN VARCHAR2,
       share_owner          IN VARCHAR2 := NULL,
       drop_prior_versions  IN BOOLEAN := FALSE,
       share_job_dop        IN NUMBER := NULL,
       share_job_priority   IN NUMBER := NULL,
       job_class            IN VARCHAR2 := 'DEFAULT_JOB_CLASS',
       force_job_class      IN BOOLEAN := FALSE  
);

パラメータ

パラメータ 説明
share_name 公開する共有の名前。
share_owner 共有所有者。現在のユーザーまたはNULLである必要があります。
drop_prior_versions 共有の以前のバージョンをすべて削除する場合は、TRUEに設定します。 未処理の事前認証済リクエスト(PAR)がない場合のみ、バージョンは削除されます。
share_job_dop 共有の公開に使用されるdbms_schedulerジョブの最大数を指定します。 システムのデフォルト番号を使用する場合は、NULLのままにします。
share_job_priority 他のユーザーと比較して、この共有公開の相対的な優先度を指定します。 2つの共有が同時に公開されている場合は、あとで開始された場合でも、もっとも高い優先度を持つ共有が最初に処理されます。
job_class all_scheduler_job_classesのスケジューラ・ジョブ・クラスで、共有の公開に使用されます。
force_job_class 管理者が別のデフォルト・ジョブ・クラスを定義している場合でも、指定されたjob_classを使用します。

親トピック: 共有プロデューサ・サブプログラムのサマリー

PURGE_DETACHED_FILESプロシージャ

共有から切り離されたparquetファイルを削除するか、破棄します。

構文

PROCEDURE PURGE_DETACHED_FILES  
(
    file_pattern         IN VARCHAR2 := '%',
    credential_name      IN VARCHAR2 := NULL,
    purge_mode           IN PLS_INTEGER := PURGE_DROP,
    owner_id             IN NUMBER := SYS_CONTEXT('USERENV', 'CURRENT_USERID')  
);

パージ・ジョブのIDを返すPURGE_DETACHED_FILESのバージョン(存在する場合)。 

PROCEDURE PURGE_DETACHED_FILES  
(
    purge_job_id         IN OUT NOCOPY NUMBER,
    file_pattern         IN VARCHAR2 := '%',
    credential_name      IN VARCHAR2 := NULL,
    purge_mode           IN PLS_INTEGER := PURGE_DROP,
    owner_id             IN NUMBER := SYS_CONTEXT('USERENV', 'CURRENT_USERID')  
);

パラメータ

パラメータ 説明
purge_job_id パージ・ジョブID。
file_pattern パージされるファイルのLIKEパターン(オプション)。
credential_name ファイルの削除に使用されるオプションの資格証明。
purge_mode ファイルのパージ方法を指定します。 パージ・モードの値は次のとおりです:
  • PURGE_DROP
    指定された資格証明を使用して、ファイルを削除してみます。 ファイルを削除できない場合、ファイルは*_SHARE_DETACHED_FILESビューに引き続きリストされます。 
    PURGE_DROP             CONSTANT PLS_INTEGER := 1;
  • PURGE_DROP_FORCE
    指定された資格証明を使用して、ファイルを削除してみます。 ファイルの削除が再度失敗した場合でも、ファイルは*_SHARE_DETACHED_FILESビューから削除されます。 
    PURGE_DROP_FORCE       CONSTANT PLS_INTEGER := 2;
  • PURGE_FORGET
    *_SHARE_DETACHED_FILESファイル・ビューを削除せずに削除します。
    PURGE_FORGET           CONSTANT PLS_INTEGER := 3;
owner_id パージするファイルの所有者ID。

親トピック: 共有プロデューサ・サブプログラムのサマリー

REMOVE_FROM_SHAREプロシージャ

共有から表またはビューを削除します。

構文

PROCEDURE REMOVE_FROM_SHARE  
(
    share_name           IN VARCHAR2,
    share_table_name     IN VARCHAR2,
    share_schema_name    IN VARCHAR2 := NULL,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

パラメータ

パラメータ 説明
share_name オブジェクトが取り消される既存の共有の名前。
share_table_name 取り消す共有表の名前。 これは、外部に表示される名前と一致する必要があるため、入力は大文字になります。
share_schema_name 共有スキーマの名前。 デフォルトは現在のユーザーの大文字です。
share_owner 共有の所有者。
auto_commit TRUEの場合、このプロシージャ・コールは、コミットが実行されるまで外部から表示されない変更をコミットします。 デフォルト値はFALSEです。つまり、変更を表示するには、このコールの実行後にユーザーがCOMMITを実行する必要があります。

親トピック: 共有プロデューサ・サブプログラムのサマリー

RENAME_RECIPIENTプロシージャ

受信者の名前を変更します。 この手順では、受信者のローカル名のみを変更します。 OAUTHユーザーや共有IDなど、受信者の外部定義は変更されません。

構文

PROCEDURE RENAME_RECIPIENT  
(
    old_recipient_name   IN VARCHAR2,
    new_recipient_name   IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

パラメータ

パラメータ 説明
old_recipient_name 共有受信者の現在の名前。
new_recipient_name 共有受信者の新しい名前。
owner 受信者を定義するスキーマ。
auto_commit TRUEの場合、変更は自動的にコミットされます。 変更は、コミットが実行されるまで外部には表示されません。 デフォルトはTRUEです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

RENAME_SHAREプロシージャ

シェアの名前を変更します。 変更は、アクセスが以前の名前に基づく既存のコンシューマに影響するため、この手順に注意してください。 コンシューマには、直接通知も更新もされません。

構文

PROCEDURE RENAME_SHARE  
(
    old_share_name       IN VARCHAR2,
    new_share_name       IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

パラメータ

パラメータ 説明
old_share_name 共有の現在の名前。
new_share_name 共有の新しい名前。
share_owner 共有の所有者。
auto_commit TRUEの場合、変更は自動的にコミットされます。 変更は、コミットが実行されるまで外部には表示されません。 デフォルトはTRUEです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

RENAME_SHARE_LINKプロシージャ

登録済みの共有リンクの名前を変更します。

構文

PROCEDURE RENAME_SHARE_LINK  
(
    old_name             IN VARCHAR2,
    new_name             IN VARCHAR2,
    link_owner           IN VARCHAR2 := NULL  
);

パラメータ

パラメータ 説明
old_name 共有リンクの現在の名前。
new_name リンクの新しい名前。
link_owner 共有リンクの所有者。 デフォルトは現行のスキーマです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

RENAME_SHARE_SCHEMAプロシージャ

共有スキーマの名前を変更します。

構文

PROCEDURE RENAME_SHARE_SCHEMA  
(
    share_name           IN VARCHAR2,
    old_schema_name      IN VARCHAR2,
    new_schema_name      IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

パラメータ

パラメータ 説明
share_name 共有の名前。
old_schema_name スキーマの古い名前。
new_schema_name スキーマの新しい名前。
share_owner 共有の所有者。 デフォルトは現在のスキーマです。
auto_commit TRUEの場合、変更は自動的にコミットされます。 変更は、コミットが実行されるまで外部には表示されません。 デフォルトの設定はFALSEです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

RENAME_SHARE_TABLEプロシージャ

共有表の名前を変更します。

構文

PROCEDURE RENAME_SHARE_TABLE  
(
    share_name           IN VARCHAR2,
    share_schema_name    IN VARCHAR2,
    old_share_table_name IN VARCHAR2,
    new_share_table_name IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

パラメータ

パラメータ 説明
share_name 共有の名前。
share_schema_name 共有スキーマの名前。
old_share_table_name 共有表の古い名前。
new_share_table_name 共有表の新しい名前。
share_owner 共有の所有者。
auto_commit TRUEの場合、変更は自動的にコミットされます。 変更は、コミットが実行されるまで外部には表示されません。 デフォルトの設定はFALSEです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

REVOKE_FROM_RECIPIENTプロシージャ

特定の受信者からの共有に対するアクセス権を取り消します。

構文

PROCEDURE REVOKE_FROM_RECIPIENT  
(
    share_name           IN VARCHAR2,
    recipient_name       IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

パラメータ

パラメータ 説明
share_name 取り消す共有の名前。
recipient_name 受信者の名前。
owner 共有および受信者の所有者。
auto_commit TRUEの場合、変更は自動的にコミットされます。 変更は、コミットが実行されるまで外部には表示されません。 デフォルトの設定はFALSEです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

SET_CURRENT_SHARE_VERSIONプロシージャ

共有の現在のバージョンを変更します。

構文

PROCEDURE SET_CURRENT_SHARE_VERSION  
(
    share_name         IN VARCHAR2,
    share_version      IN NUMBER,
    share_owner        IN VARCHAR2 := NULL  
);

パラメータ

パラメータ 説明
share_name 共有の名前。
share_version 新しいバージョンまたはNULL。 バージョンが存在し、有効である必要があります。 share_versionがNULLの場合、バージョンはCURRENTとマークされず、共有は未公開になります。
share_owner 共有の所有者。 デフォルトは現在のスキーマです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

SET_PUBLISHED_IDENTITYプロシージャ

公開されているORACLE共有の受信者に提供される現在のユーザーに関するデータを設定します。

構文

PROCEDURE SET_PUBLISHED_IDENTITY  
(
    metadata             IN SYS.JSON_OBJECT_T := NULL  
);

パラメータ

パラメータ 説明
metadata プロバイダ・アイデンティティがすでに設定されている場合、コール元が更新するアイテムのみをJSONに含める必要があります。 アイテムにNULL値を指定すると、そのアイテムは格納されているアイデンティティから削除されます。 ただし、"name"、"description"および"contact"はこの方法で削除できません。

メタデータ引数がNULLの場合、既存のプロバイダ・アイデンティティが削除されます。 これは、現在のユーザーに公開済みのシェアがない場合にのみ発生する可能性があります。

プロバイダ・アイデンティティがまだ設定されていない場合、JSONには少なくとも次のものが含まれている必要があります:
  • 名前(<=128バイト)
  • 説明(<=4000バイト)
  • contact (4000バイト以下)の値

追加のアイテムは、発信者の判断に含めることができます。

例: JSONメタデータに追加のアイテムを含める

必要な"name"、"description"および"contact"に加えて、この例には追加のアイテム"schedule"が含まれます。
{
  "name" : "A sample share provider",
  "description" : "Test of share provider metadata",
  "contact" : "provider1@example.com".
  "schedule" : "New data provided on alternate rainy Fridays"
}

例: "description"を更新して"schedule"を削除

「説明」を更新して「スケジュール」を削除するには、次のJSONを使用できます:
{
  "description" : "The Share Provider You Can Trust!(tm)",
  "schedule" : null
}

親トピック: 共有プロデューサ・サブプログラムのサマリー

SET_RECIPIENT_LOG_LEVELプロシージャ

既存の共有受信者のログ・レベルを変更します。

構文

PROCEDURE SET_RECIPIENT_LOG_LEVEL
(
  recipient_name       IN VARCHAR2,
  log_level            IN PLS_INTEGER,
  recipient_owner      IN VARCHAR2 := NULL
);

パラメータ

パラメータ 説明
recipient_name 共有受信者のローカル名。
log_level イベント・ロギング・レベル。 このパラメータに使用される定数の詳細は、「DBMS_SHARE定数」の「ログ・レベル」の説明を参照してください。
recipient_owner 受信者を所有するスキーマ。

親トピック: 共有プロデューサ・サブプログラムのサマリー

SET_SHARE_LOG_LEVELプロシージャ

既存のシェアのログ・レベルを変更します。

構文

PROCEDURE SET_SHARE_LOG_LEVEL
(
  share_name           IN VARCHAR2,
  log_level            IN PLS_INTEGER,
  share_owner          IN VARCHAR2 := NULL
);

パラメータ

パラメータ 説明
share_name 共有の名前。
log_level イベント・ロギング・レベル。 このパラメータに使用される定数の詳細は、「DBMS_SHARE定数」の「ログ・レベル」の説明を参照してください。
share_owner 共有の所有者。

親トピック: 共有プロデューサ・サブプログラムのサマリー

SET_STORAGE_CREDENTIALプロシージャ

指定されたストレージにアクセスしようとしたときに現在のユーザーが使用する資格証明名を設定します。

構文

PROCEDURE SET_STORAGE_CREDENTIAL  
(
    storage_link_name    IN VARCHAR2,
    credential_name      IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    check_if_exists      IN BOOLEAN := TRUE,
    auto_commit          IN BOOLEAN := TRUE  
);

パラメータ

パラメータ 説明
storage_link_name 「CREATE_CLOUD_STORAGE_LINKプロシージャ」を使用して以前に作成したクラウド・ストレージ・リンクの名前。
credential_name ストレージへのアクセス権を付与するローカル資格証明の名前。

共有ストレージに使用される資格証明は、事前認証済リクエストの読取り、書込み、削除および管理が可能である必要があります。 事前認証済リクエストの使用を参照してください

owner クラウド・ストレージ・リンクの所有者。 現在のユーザーに対してはNULLのままにします。
check_if_exists check_if_existsがTRUEの場合、ファンクションは現在のユーザーの資格証明が存在することも確認します。
auto_commit デフォルトはTRUEです。 TRUEの場合、このトランザクションはコミットされます。 FALSEの場合、ユーザーはトランザクションをコミットする必要があります。 コミットが実行されるまで、変更は表示されません。

親トピック: 共有プロデューサ・サブプログラムのサマリー

STOP_JOBプロシージャ

実行中の共有ジョブの停止を試みます。 プロシージャはすぐに戻りますが、関連するジョブの停止には時間がかかる場合があります。

構文

PROCEDURE STOP_JOB
(
  share_job_id         IN NUMBER,
  share_job_owner      IN VARCHAR2 := NULL
);

パラメータ

パラメータ 説明
share_job_id 共有ジョブのID。
share_job_owner ジョブの所有者。 デフォルトは現在のスキーマです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

UNPUBLISH_SHAREプロシージャ

共有を非公開にします。

構文

PROCEDURE UNPUBLISH_SHARE  
(
    share_name           IN VARCHAR2,
    out_share_job_id     IN OUT NOCOPY NUMBER,
    share_owner          IN VARCHAR2 := NULL,
    drop_all_versions    IN BOOLEAN := FALSE,
    restart_versions     IN BOOLEAN := FALSE  
);

パラメータ

パラメータ 説明
share_name 共有の名前。
out_share_job_id このコマンドを処理するために実行する必要がある共有ジョブのID。
share_owner 共有の所有者。 デフォルトは現在のスキーマです。
drop_all_versions TRUEに設定すると、既存のすべてのバージョンと関連するすべてのストレージが削除されます。

drop_all_versionsがFALSEの場合、既存のバージョンはすべて引き続き存在しますが、共有は受信者には表示されません。 後続のPUBLISH_SHAREまたはSET_CURRENT_SHARE_VERSIONをコールすると、それらが再度表示されます。

restart_versions バージョン番号付けを再開します。 FALSEの場合、次に公開されるバージョン番号は、削除されたバージョンがない場合と同じになります。

TRUEの場合、次に公開されるバージョンは、最も高い既存バージョンより1つ多く設定されます。 drop_all_versionsと組み合わせて使用すると、共有を元の状態にリセットした結果になります。 これは既存のデルタ・クライアントを混乱させる可能性があるため、注意して使用してください。

親トピック: 共有プロデューサ・サブプログラムのサマリー

UPDATE_DEFAULT_RECIPIENT_PROPERTYプロシージャ

デフォルトの受信者プロパティ値を更新します。 このプロシージャでは、ユーザーに管理者権限が必要です。

構文

PROCEDURE UPDATE_DEFAULT_RECIPIENT_PROPERTY
(
  recipient_property   IN VARCHAR2,
  new_value_vc         IN VARCHAR2
);

パラメータ

パラメータ 説明
recipient_property 更新するプロパティ。 このパラメータに使用される定数の詳細は、「DBMS_SHARE定数」の「共有受信者のプロパティ」の説明を参照してください。
new_value_vc 新しいプロパティの値

親トピック: 共有プロデューサ・サブプログラムのサマリー

UPDATE_DEFAULT_SHARE_PROPERTYプロシージャ

デフォルトの共有プロパティ値を更新します。

構文

PROCEDURE UPDATE_DEFAULT_SHARE_PROPERTY  
(
    share_property       IN VARCHAR2,
    new_value            IN VARCHAR2  
);

パラメータ

パラメータ 説明
share_property 更新するプロパティ。 このパラメータに使用される定数の詳細は、「DBMS_SHARE定数」の「共有プロパティ」の説明を参照してください。

これらのプロパティは、「ALL_SHARE_DEFAULT_SETTINGSビュー」を使用して読み取ることができます。

new_value 新しいプロパティの値

親トピック: 共有プロデューサ・サブプログラムのサマリー

UPDATE_RECIPIENT_PROPERTYプロシージャ

既存の受信者のプロパティを更新します。

構文

PROCEDURE UPDATE_RECIPIENT_PROPERTY  
(
    recipient_name       IN VARCHAR2,
    recipient_property   IN VARCHAR2,
    new_value            IN VARCHAR2,
    recipient_owner      IN VARCHAR2 := NULL  
);

パラメータ

パラメータ 説明
recipient_name 受信者の名前。
recipient_property 更新するプロパティ。 次のようなプロパティがあります。
  • PROP_RECIPIENT_EMAIL
  • PROP_RECIPIENT_DESCRIPTION
  • PROP_RECIPIENT_LOG_LEVEL
  • PROP_RECIPIENT_SHARING_ID
  • PROP_RECIPIENT_PROFILE_URL
  • PROP_RECIPIENT_PAR_TYPE
  • PROP_RECIPIENT_MIN_PAR_LIFETIME
  • PROP_RECIPIENT_PAR_LIFETIME
  • PROP_RECIPIENT_TOKEN_LIFETIME
このパラメータに使用される定数の詳細は、「DBMS_SHARE定数」の「共有受信者の受信者のプロパティ」の説明を参照してください。
new_value 新しいプロパティの値
recipient_owner 受信者の所有者。 デフォルトは現在のスキーマです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

UPDATE_SHARE_JOB_PROPERTYプロシージャ

実行中の共有ジョブのプロパティを変更します。 プロシージャはすばやく戻りますが、変更が有効になるまでに時間がかかる場合があります。

構文

PROCEDURE UPDATE_SHARE_JOB_PROPERTY  
(
    share_job_id         IN NUMBER,
    share_property       IN VARCHAR2,
    new_value            IN VARCHAR2,
    share_job_owner      IN VARCHAR2 := NULL  
);

パラメータ

パラメータ 説明
share_job_id 共有ジョブのID。
share_property 更新するプロパティ。 このパラメータに使用される定数の詳細は、「DBMS_SHARE定数」の「共有ジョブのプロパティ」の説明を参照してください。
new_value 新しいプロパティの値
share_job_owner ジョブの所有者。 デフォルトは現在のスキーマです。

親トピック: 共有プロデューサ・サブプログラムのサマリー

UPDATE_SHARE_PROPERTYプロシージャ

既存のシェアのプロパティを更新します。

構文

PROCEDURE UPDATE_SHARE_PROPERTY  
(
    share_name           IN VARCHAR2,
    share_property       IN VARCHAR2,
    new_value            IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

パラメータ

パラメータ 説明
share_name 共有の名前。
share_property 更新するプロパティ。 このパラメータに使用される定数の詳細は、「DBMS_SHARE定数」の「共有プロパティ」の説明を参照してください。
new_value 新しいプロパティの値
share_owner 共有の所有者。 デフォルトは現在のスキーマです。
Auto_commit TRUE (デフォルト)の場合、変更は自動的にコミットされます。 FALSEの場合、ユーザーは変更をコミットする必要があります。 変更は、コミットが実行された後に外部で表示されます。

親トピック: 共有プロデューサ・サブプログラムのサマリー

UPDATE_SHARE_TABLE_PROPERTYプロシージャ

既存の共有表のプロパティ値を更新します。

構文

PROCEDURE UPDATE_SHARE_TABLE_PROPERTY  
(
    share_name           IN VARCHAR2,
    share_table_name     IN VARCHAR2,
    share_table_property IN VARCHAR2,
    new_value            IN VARCHAR2,
    share_schema_name    IN VARCHAR2 := NULL,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

パラメータ

パラメータ 説明
share_name 共有の名前。
share_table_name 共有表の名前。
share_table_property 更新するプロパティ。 次のようなプロパティがあります。
  • PROP_SHARE_TABLE_SPLIT_METHOD
  • PROP_SHARE_TABLE_SPLIT_COLUMNS
  • PROP_SHARE_TABLE_ORDER_COLUMNS
  • PROP_SHARE_TABLE_SHARE_COLUMNS
  • PROP_SHARE_TABLE_SPLIT_SIZE
  • PROP_SHARE_TABLE_GATHER_STATS
  • PROP_SHARE_TABLE_SPLIT_ROWS
  • PROP_SHARE_TABLE_FLASHBACK
new_value 新しいプロパティの値
share_schema_name 共有スキーマの名前(デフォルトは現在のユーザーの大文字)。
share_owner 共有の所有者。 デフォルトは現在のスキーマです。
Auto_commit TRUE (デフォルト)の場合、変更は自動的にコミットされます。 FALSEの場合、ユーザーは変更をコミットする必要があります。 変更は、コミットが実行された後に外部で表示されます。

親トピック: 共有プロデューサ・サブプログラムのサマリー

VALIDATE_CREDENTIALファンクション

資格証明名を検証し、必要に応じてまず標準形式に変換します。

名前が有効なOracle識別子でない場合、プロシージャは例外を生成します。 credential_nameは、USER_CREDENTIALSビューのCREDENTIAL_NAME列に表示されるように、二重引用符なしで返されます。

構文

FUNCTION VALIDATE_CREDENTIAL  
(
        credential_name      IN VARCHAR2,
        check_if_exists      IN BOOLEAN := TRUE  
)  
RETURN VARCHAR2;

パラメータ

パラメータ 説明
credential_name 標準データベース・フォームで検証する資格証明の名前。名前が単純な識別子でない場合は二重引用符で囲みます。
check_if_exists TRUEの場合、ファンクションは、現在のユーザーの資格証明が存在することを確認します。

親トピック: 共有プロデューサ・サブプログラムのサマリー

VALIDATE_SHARE_STORAGEプロシージャ

指定されたストレージがバージョン管理されたシェアに適しているかどうかを確認します。

構文

validation_results出力パラメータを含むプロシージャ構文。 

 PROCEDURE VALIDATE_SHARE_STORAGE  
(
    storage_link_name    IN VARCHAR2,
    validation_results   IN OUT NOCOPY VARCHAR2,
    run_storage_tests    IN BOOLEAN := TRUE,
    storage_link_owner   IN VARCHAR2 := NULL  
);

validation_results出力パラメータを含まないプロシージャ構文。 

PROCEDURE VALIDATE_SHARE_STORAGE  
(
    storage_link_name    IN VARCHAR2,
    run_storage_tests    IN BOOLEAN := TRUE,
    storage_link_owner   IN VARCHAR2 := NULL  
);

パラメータ

パラメータ 説明
storage_link_name クラウド・ストレージ・リンク名。
validation_results (オプションの入出力)検証結果の詳細がJSON形式で返されました。

validation_resultsには、個別のテストごとの結果が含まれます。

run_storage_tests テストを実行してストレージを検証します。 TRUE (デフォルト)の場合、プロシージャはREAD、WRITE、DELETEおよびPREAUTHENTICATED REQUESTSをテストします。
storage_link_owner クラウド・ストレージ・リンクの所有者。

例: 検証結果

{
  "READ":"PASSSED",
  "WRITE":"PASSSED",
  "CREATE_PAR":"PASSSED",
  "DELETE_PAR":"PASSSED",
  "DELETE":"PASSSED"
}

親トピック: 共有プロデューサ・サブプログラムのサマリー

WAIT_FOR_JOBプロシージャ

このプロシージャは、指定された共有ジョブが完了するまで待機します。

構文

PROCEDURE WAIT_FOR_JOB  
(
    share_job_id         IN NUMBER,
    completed            IN OUT NOCOPY BOOLEAN,
    maximum_wait         IN NUMBER := NULL  
);

パラメータ

パラメータ 説明
share_job_id 共有ジョブのID。
completed ジョブ完了インジケータ。
maximum_wait 最大待機時間(秒)。 NULL値は制限がないことを意味します。

親トピック: 共有プロデューサ・サブプログラムのサマリー