DBMS_SHARE定数

これらの定数は、DBMS_SHAREパッケージで使用されます。

デタッチされたファイル

PURGE_DETACHED_FILESプロシージャで使用される定数。

名前 タイプ 説明
PURGE_DROP PLS_INTEGER 1 指定された資格証明を使用してファイルを削除しようとしました。ファイルを削除できない場合、ファイルは引き続き*_SHARE_DETACHED_FILESビューにリストされます。
PURGE_DROP_FORCE PLS_INTEGER 2 指定された資格証明を使用してファイルを削除しようとしました。ファイルの削除が再度失敗した場合でも、ファイルは*_SHARE_DETACHED_FILESビューから削除されます。
PURGE_FORGET PLS_INTEGER 3 ファイル*_SHARE_DETACHED_FILESビューを削除せずに削除します。

ログ・レベル

ログに収集される情報のレベルの設定に使用される定数。これらのレベルは、ALL_SHARE_EVENTSおよびALL_SHARE_RECIPIENTSにログインするイベントの数を制御します。

SET_SHARE_LOG_LEVELプロシージャおよびSET_RECIPIENT_LOG_LEVELプロシージャを参照してください。

名前 タイプ 説明
LOG_LEVEL_ERRORS_ONLY PLS_INTEGER 0 ログ・エラーのみ。
LOG_LEVEL_BASIC PLS_INTEGER 1 エラーと基本情報を記録します。
LOG_LEVEL_DETAIL PLS_INTEGER 2 エラーおよび追加詳細を記録します。
LOG_LEVEL_DEBUG PLS_INTEGER 3 情報のデバッグ・レベルをログに記録します。

ジョブ・プロパティの共有

UPDATE_SHARE_JOB_PROPERTYプロシージャで使用されるプロパティ。

名前 タイプ 説明
PROP_SHARE_JOB_DOP VARCHAR2(7) 'JOB_DOP' JOB_DOPプロパティは、共有の公開に使用されるDBMS_SCHEDULERジョブの数を決定します。これは1から5までの数値にする必要があります。
PROP_SHARE_JOB_CLASS VARCHAR2(9) 'JOB_CLASS' JOB_CLASSプロパティーは、シェアの公開に使用されるスケジューラジョブクラスを決定します。有効な値のリストについては、ALL_SCHEDULER_JOB_CLASSESを参照してください。デフォルト値はDEFAULT_JOB_CLASSです。
PROP_SHARE_JOB_PRIORITY VARCHAR2(12) 'JOB_PRIORITY' JOB_PRIORITYプロパティーは、同じユーザーからの2つ以上のシェアが同時に公開されるときの相対的な優先順位を決定します。値は数値で、デフォルトは0です。優先度の高いシェアは、優先度の低いシェアの前に処理されます。同じ優先度のシェアは、先着順、先着順で処理されます。
ジョブ優先度の標準値:
SHARE_PRIORITY_LOW     CONSTANT NUMBER := 1;
SHARE_PRIORITY_DEFAULT CONSTANT NUMBER := 2;
SHARE_PRIORITY_HIGH    CONSTANT NUMBER := 3;

プロパティの共有

シェアのプロパティーを示すために使用される定数。

UPDATE_SHARE_PROPERTYプロシージャUPDATE_DEFAULT_SHARE_PROPERTYプロシージャおよびGET_SHARE_PROPERTYファンクションを参照してください。

名前 タイプ 説明
PROP_SHARE_DESC VARCHAR2(11) 'DESCRIPTION' シェアのローカルに表示される説明。
PROP_SHARE_PUBLIC_DESC VARCHAR2(18) 'PUBLIC_DESCRIPTION' シェアの外部に表示される説明。
PROP_SHARE_SPLIT_SIZE VARCHAR2(10) 'SPLIT_SIZE' SPLIT_SIZEプロパティは、生成されるparquetファイルの大きさを決定します。アルゴリズムの機能は次のとおりです。
  1. SQLオプティマイザは、特定のセグメントのサイズ(表のパーティションやビューの結果など)をバイト単位で推定します。
  2. バイト数はSPLIT_SIZEで除算され、切り上げられて分割数が生成されます。
  3. セグメント内のデータは、なんらかの方法(ROWID、索引列、指定された列など)を使用して、この分割数にチャンク化されます。
  4. その後、データの各チャンクはparquetファイルに変換されます。

通常、圧縮によってparquetファイルはSPLIT_SIZEより小さくなります。特に、SPLIT_SIZEは圧縮前のデータの量を決定します。

PROP_SHARE_LOG_LEVEL VARCHAR2(9) 'LOG_LEVEL' LOG_LEVELプロパティは、ALL_SHARE_EVENTSログに記録される情報の量を決定します。
PROP_SHARE_VERSION_ACCESS VARCHAR2(14) 'VERSION_ACCESS' 受信者が参照できる公開済共有のバージョン。

受取人PARタイプの共有

これらの定数は、UPDATE_RECIPIENT_PROPERTYプロシージャおよびGET_RECIPIENT_PROPERTYのプロパティPROP_RECIPIENT_PAR_TYPEの有効な値です。

名前 タイプ 説明
PAR_TYPE_FOLDER PLS_INTEGER 1 PARは、フォルダ全体にアクセスできます。
PAR_TYPE_FILE PLS_INTEGER 2 PARは、一度に1つのファイルにアクセスできます。

共有受信者のプロパティ

これらの定数は、GET_SHARE_PROPERTYファンクションUPDATE_DEFAULT_SHARE_PROPERTYプロシージャおよびUPDATE_SHARE_PROPERTYプロシージャで使用されます。

名前 タイプ 説明
PROP_RECIPIENT_PAR_LIFETIME VARCHAR2(12) 'PAR_LIFETIME' デルタ共有APIを介して受信者に送信される事前認証済リクエストURLの存続期間。デフォルトは、'00 03:00:00'の3時間です
PROP_RECIPIENT_MIN_PAR_LIFETIME VARCHAR2(16) 'MIN_PAR_LIFETIME' デルタ共有APIを介して受信者に送信される事前認証済リクエストURLの最小保証存続期間。同じparquetファイルに既存のPARがある場合、残りの存続期間がこの最小値を超える場合にのみ再使用されます。デフォルトは2 1/2時間: '00 02:30:00'です
PROP_RECIPIENT_MAX_PAR_LIFETIME VARCHAR2(16) 'MAX_PAR_LIFETIME' 任意の受信者の最大許容期間を定義する管理者設定。デフォルトは1日です: '01 00:00:00'
PROP_RECIPIENT_TOKEN_LIFETIME VARCHAR2(14) 'TOKEN_LIFETIME' デルタ共有ベアラー・トークンの存続期間を表す、INTERVAL DAY TO SECOND形式の文字列。デフォルトは1時間です: '01 00:00:00'。
PROP_RECIPIENT_MAX_TOKEN_LIFETIME VARCHAR2(18) 'MAX_TOKEN_LIFETIME' 任意の受信者の最大許容ベアラー・トークンの存続期間を定義する管理者設定。デフォルトは90日です: '90 00:00:00'
PROP_RECIPIENT_EMAIL VARCHAR2(5) 'EMAIL' 受信者の電子メール。これは、デルタ共有受信者にのみ必要です。
PROP_RECIPIENT_DESCRIPTION VARCHAR2(11) 'DESCRIPTION' 受信者の説明。
PROP_RECIPIENT_LOG_LEVEL VARCHAR2(9) 'LOG_LEVEL' 受信者のロギング・レベル。これは、USER_SHARE_RECIPIENT_EVENTSに記録される内容を制御します。値は、LOG_LEVEL_*定数の1つです。
PROP_RECIPIENT_SHARING_ID VARCHAR2(10) 'SHARING_ID' 受信者の共有ID。これは、Autonomous Database受信者にのみ必要です。
PROP_RECIPIENT_PAR_TYPE VARCHAR2(8) 'PAR_TYPE' 作成する事前認証済リクエストのタイプ。これは、PAR_TYPE_FOLDER (デフォルト)またはPAR_TYPE_FILEのいずれかである必要があります。
PROP_RECIPIENT_VERSION_ACCESS VARCHAR2(14) 'VERSION_ACCESS' 受信者が表示できる公開済みシェアのバージョンを指定します。VERSION_ACCESS_CURRENTまたはVERSION_ACCESS_ANYのいずれか。

共有テーブルのプロパティー

共有表のプロパティを示すために使用する定数。これらは、GET_SHARE_TABLE_PROPERTYファンクションおよびUPDATE_SHARE_TABLE_PROPERTYプロシージャで使用されます。

名前 タイプ 説明
PROP_SHARE_TABLE_SPLIT_METHOD VARCHAR2(12) 'SPLIT_METHOD' セグメントを異なるファイルに分割する方法を指定します。
SPLIT_METHOD_AUTO VARCHAR2(4) 'AUTO' Autonomous Databaseは、セグメントの分割方法を決定します。
SPLIT_METHOD_RANGE VARCHAR2(5) 'RANGE' 値範囲に基づいてセグメントを分割します。正確な範囲は、データ・ヒストグラムを分析することによって決定されます。このメソッドでは、1つ以上のsplit_columnsを指定する必要があります。
SPLIT_METHOD_ROWID VARCHAR2(5) 'ROWID' ROWIDに基づいてセグメントを分割します。
SPLIT_METHOD_HASH VARCHAR2(4) 'HASH' HASH値に基づいてセグメントを分割します。このメソッドでは、1つ以上のsplit_columnsを指定する必要があります。
SPLIT_METHOD_VALUE VARCHAR2(5) 'VALUE' 個別値に基づいてセグメントを分割します。このメソッドでは、1つ以上のsplit_columnsを指定する必要があります。
PROP_SHARE_TABLE_SPLIT_COLUMNS VARCHAR2(13) 'SPLIT_COLUMNS' 分割に使用する列を指定します。これらは、RANGE、VALUEおよびHASHメソッドに必要です。値は、共有列のカンマ区切りセット(たとえば、'STATE、CITY'または'"STATE"、"CITY"')である必要があります。
PROP_SHARE_TABLE_ORDER_COLUMNS VARCHAR2(13) 'ORDER_COLUMNS' parquetの収集時に順序付けに使用される列を指定します。値は、共有列のカンマ区切りセット(たとえば、'STATE、CITY'または'"STATE"、"CITY"')である必要があります。
PROP_SHARE_TABLE_SHARE_COLUMNS VARCHAR2(13) 'SHARE_COLUMNS' 共有する列を指定します。この値は、共有列のカンマ区切りセットです。たとえば、'STATE、CITY'または'"STATE"、"CITY"です。
PROP_SHARE_TABLE_SPLIT_SIZE VARCHAR2(10) 'SPLIT_SIZE' 特定の表の共有レベルsplit_sizeをオーバーライドします。値は数値です。
PROP_SHARE_TABLE_GATHER_STATS VARCHAR2(12) 'GATHER_STATS' Autonomous Databaseが統計を収集する場合、'GATHER_STATS'の値は'YES'.ですそうでない場合は、値は'NO'です。
PROP_SHARE_TABLE_SPLIT_ROWS VARCHAR2(10) 'SPLIT_ROWS' SPLIT_ROWSプロパティは、各parquetファイルに格納するデータの量を指定する別の方法です。
  1. Autonomous Databaseは、特定のセグメント内の行数(表のパーティションやビューの結果など)を計算します。
  2. 行数はSPLIT_ROWSで除算され、切り上げられて分割数が生成されます。
  3. セグメント内のデータは、なんらかの方法(ROWID、索引列、指定された列など)を使用して、この数の分割にチャンク化されます。
  4. その後、データの各チャンクはparquetファイルに変換されます。

分割の数は各行のデータ量を反映するため、SPLIT_SIZEプロパティを使用して制御することをお薦めします。たとえば、VARCHAR2(4000)の900列を含む行は、NUMBER(1)型の単一列を持つ行よりもはるかに大きくなります。

SPLIT_ROWSは、各行の平均データ量を計上した場合にのみ使用します。

PROP_SHARE_TABLE_FLASHBACK VARCHAR2(9) 'FLASHBACK' FLASHBACKプロパティは、異なるエクスポート・ファイル間の読取り一貫性を確保するために、フラッシュバック問合せを使用して表を公開するかどうかを決定します。値は、YESNOまたはAUTOである必要があります。

AUTO設定が使用可能な場合は、フラッシュバックが使用されます。

YES設定では、表またはビューでフラッシュバックが不可能な場合、パブリケーションが失敗します。

NO設定ではフラッシュバックは使用されません。これは、parquetファイルがデータの異なるスナップショットを表す可能性があることを意味します。

共有タイプ

共有のタイプを識別するために共有の作成時に使用される定数。

CREATE_SHAREプロシージャを参照してください。

名前 タイプ 説明
SHARE_TYPE_VERSIONED DBMS_ID 'VERSIONED' 共有は、バージョン管理されたデータの共有に使用されます。
SHARE_TYPE_LIVE DBMS_ID 'LIVE' 共有は、ライブ・データの共有に使用されます。

共有IDタイプ

ASSERT_SHARING_IDおよび GET_SHARING_IDで使用されます。

名前 タイプ 説明
SHARING_ID_TYPE_TENANCY VARCHAR2(7) 'TENANCY' 共有IDはOCIテナンシを表します。
SHARING_ID_TYPE_COMPARTMENT VARCHAR2(11) 'COMPARTMENT' 共有IDは、OCIコンパートメントを表します。
SHARING_ID_TYPE_DATABASE VARCHAR2(8) 'DATABASE' 共有IDは、OCI Autonomous Databaseを表します。
SHARING_ID_TYPE_REGION VARCHAR2(6) 'REGION' 共有IDはOCIリージョンを表します。

バージョン・アクセス

VERSION_ACCESS共有プロパティに指定可能な値。これは、デルタ時間移動の実装に使用されます。これらは、PROP_SHARE_VERSION_ACCESSおよびPROP_RECIPIENT_VERSION_ACCESSに関連付けられた有効な値です。

これらは、デルタ共有問合せエンドポイントでversionプロパティを有効にするために使用できます。これにより、受信者は常にCURRENTバージョンを受信するのではなく、特定のバージョンのデータを選択できます。これは、共有と受信者の両方で有効にする必要があります。

次に例を示します。
UPDATE_SHARE_PROPERTY(
          share_name => '...',
          share_property => DBMS_SHARE.PROP_SHARE_VERSION_ACCESS,
          new_value => DBMS_SHARE.VERSION_ACCESS_ANY);

UPDATE_SHARE_PROPERTY(
          share_name => '...',
          share_property => DBMS_SHARE.PROP_RECIPIENT_VERSION_ACCESS,
          new_value => DBMS_SHARE.VERSION_ACCESS_ANY);
名前 タイプ 説明
VERSION_ACCESS_CURRENT PLS_INTEGER 1 受信者はCURRENTバージョンのみを表示できます。(デフォルト)。
VERSION_ACCESS_ANY PLS_INTEGER 2 受信者は、任意のCURRENTまたはRETIREDバージョンを選択できます。