機械翻訳について

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の存続期間。 デフォルトは3時間です: '00 03:00:00'
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_*定数のいずれかである必要があります。
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プロパティは、フラッシュバック問合せを使用して表を公開し、異なるエクスポート・ファイル間の読取り整合性を確保するかどうかを決定します。 値は、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 受信者はCURRENTバージョンのみを表示できます。 (デフォルト)
VERSION_ACCESS_ANY PLS_INTEGER 2 受信者は、任意のCURRENTまたはRETIREDバージョンを選択できます。

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