Oracle Cloud Infrastructureドキュメント

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プロパティーは、同じユーザーの複数のシェアが同時に公開されるときの相対的な優先順位を決定します。値は数値で、デフォルトは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形式の文字列。デフォルトは「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' 受信者のEメール。これは、デルタ共有受信者にのみ必要です。
PROP_RECIPIENT_DESCRIPTION VARCHAR2(11) 'DESCRIPTION' 受信者のテキスト形式の説明。
PROP_RECIPIENT_LOG_LEVEL VARCHAR2(9) 'LOG_LEVEL' 受信者のロギング・レベル。これは、USER_SHARE_RECIPIENT_EVENTSに記録される内容を制御します。値は、LOG_LEVEL_*定数のいずれかである必要があります。
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プロパティを使用して分割数を制御することをお薦めします。たとえば、900列がVARCHAR2(4000)の行は、NUMBER(1)型の単一列を持つ行よりもはるかに大きくなります。

SPLIT_ROWSは、各行の平均データ量を考慮している場合にのみ使用します。

PROP_SHARE_TABLE_FLASHBACK VARCHAR2(9) 'FLASHBACK' FLASHBACKプロパティは、異なるエクスポート・ファイル間の読取り一貫性を確保するために、フラッシュバック問合せを使用して表を公開するかどうかを決定します。値は、YES、NOまたは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 受信者は現在のバージョンのみを表示できます。(デフォルト)
VERSION_ACCESS_ANY PLS_INTEGER 2 受信者は、任意のCURRENTまたはRETIREDバージョンを選択できます。

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