GATHER_TABLE_STATS|V4.3.5|OceanBaseデータベース|ドキュメント|OceanBaseマニュアル

パラメータ	説明
ownname	ユーザー名。ユーザー名を `NULL` に設定した場合、現在ログインしているユーザー名がデフォルトで使用されます。
tabname	テーブル名。
partname	パーティション名。
estimate_percent	推定行の割合。有効範囲は [0.000001,100] です。
block_sample	データベースがランダムブロックサンプリング (`TRUE`) を使用するか、ランダム行サンプリング (`FALSE`) を使用するかを決定します。デフォルト値は `FALSE` です。ランダムブロックサンプリングの方が効率は高いですが、データがディスク上にランダムに配置されていない場合、サンプル値に相関性が生じる可能性があります。
method_opt	グローバル、スキーマ、データベース、または辞書レベルで設定する場合、`FOR ALL` 構文のみを使用できます。それ以外の場合、`method_opt` は以下のオプションのいずれか、またはその組み合わせのみとなります： `FOR ALL [INDEXED \\| HIDDEN] COLUMNS [size_clause]` `FOR COLUMNS [column_clause]` ここで、`size_clause` は `size_clause := SIZE {integer \\| REPEAT \\| AUTO \\| SKEWONLY}` として定義されます。 `column_clause` は `column_clause := column_name \\| extension name \\| extension` として定義されます。 `integer`：ヒストグラムバケットの数。有効範囲は [1,2048] です。 `REPEAT`：既存のヒストグラムがある列に対してのみヒストグラムを収集します。 `AUTO`：OceanBaseデータベースのオプティマイザーが、列の使用状況に基づいて列のヒストグラムを収集するかどうかを決定します。ヒストグラムバケット数はデフォルト値の254を使用します。 `SKEWONLY`：データの分布が均一でない列のヒストグラムのみを収集します。ヒストグラムバケット数はデフォルト値の254を使用します。 `column_name`：列名。 `extension`：`(column_name, colume_name [, ...])` 形式の列グループまたは式を指定できます。デフォルト値は `FOR ALL COLUMNS SIZE AUTO` です。
degree	パラレル度。デフォルト値は `NULL` です。`NULL` は `CREATE TABLE` または `ALTER TABLE` ステートメント内の `DEGREE` 句で指定されたテーブルのデフォルト値を使用することを意味します。`DEGREE=>NULL`、`DEGREE=>n` を使用する場合、オブジェクトのサイズがパラレル実行を保証しない場合、`DBMS_STATS` はシリアル実行を使用する可能性があります。
granularity	収集する統計情報の粒度（テーブルがパーティション化されている場合にのみ適用されます）。 `ALL`：すべて（サブパーティション、パーティション、およびグローバル）の統計情報を収集します。 `APPROX_GLOBAL AND PARTITION`：`GLOBAL AND PARTITION` と同様ですが、この場合、グローバル統計情報はパーティションレベルの統計情報の集計です。このオプションは、異なる値の数とインデックスの異なるキーの数以外のすべての統計情報を集計します。ただし、統計情報を持つパーティションのみを集計します。`partname` が `NULL` である場合、または集計を実行できない場合（例えば、いずれかのパーティションの統計情報が欠落している場合）、グローバル統計情報が収集されます。 `AUTO`：パーティションタイプに基づいて粒度を決定します。これがデフォルト値です。 `DEFAULT`：グローバルおよびパーティションレベルの統計情報を収集します。このオプションは廃止されました。代わりに `GLOBAL AND PARTITION` の使用を推奨します。 `GLOBAL`：グローバル統計情報を収集します。 `GLOBAL AND PARTITION`：グローバルおよびパーティションレベルの統計情報を収集します。複合パーティションオブジェクトであっても、サブパーティションレベルの統計情報は収集されません。 `PARTITION`：パーティションレベルの統計情報を収集します。 `SUBPARTITION`：サブパーティションレベルの統計情報を収集します。
cascade	テーブルと列の統計情報に加えて、インデックスに関する統計情報も収集します。これは、スキーマ内の各インデックスに対して`GATHER_INDEX_STATS`プロシージャを実行することと同等です。
no_invalidate	統計情報を収集する際にPlan Cacheをフラッシュするかどうか。`TRUE`に設定すると、統計情報を収集する際にPlan Cacheをフラッシュしません。
stattype	現在の統計情報が格納される場所。
force	ロック状態を無視して強制的に統計情報を収集するかどうか。デフォルトは`FALSE`です。`TRUE`に設定すると、統計情報がロックされていても収集されます。
hist_est_percent	ヒストグラムのサンプリング率を指定します。
hist_block_sample	ヒストグラムのサンプリング方式を指定します。

ownname

ユーザー名。ユーザー名を NULL に設定した場合、現在ログインしているユーザー名がデフォルトで使用されます。

tabname

テーブル名。

partname

パーティション名。

estimate_percent

推定行の割合。有効範囲は [0.000001,100] です。

block_sample

データベースがランダムブロックサンプリング (TRUE) を使用するか、ランダム行サンプリング (FALSE) を使用するかを決定します。デフォルト値は FALSE です。ランダムブロックサンプリングの方が効率は高いですが、データがディスク上にランダムに配置されていない場合、サンプル値に相関性が生じる可能性があります。

method_opt

グローバル、スキーマ、データベース、または辞書レベルで設定する場合、FOR ALL 構文のみを使用できます。それ以外の場合、method_opt は以下のオプションのいずれか、またはその組み合わせのみとなります：

FOR ALL [INDEXED \| HIDDEN] COLUMNS [size_clause]
FOR COLUMNS [column_clause] ここで、size_clause は size_clause := SIZE {integer \| REPEAT \| AUTO \| SKEWONLY} として定義されます。 column_clause は column_clause := column_name \| extension name \| extension として定義されます。
integer：ヒストグラムバケットの数。有効範囲は [1,2048] です。
REPEAT：既存のヒストグラムがある列に対してのみヒストグラムを収集します。
AUTO：OceanBaseデータベースのオプティマイザーが、列の使用状況に基づいて列のヒストグラムを収集するかどうかを決定します。ヒストグラムバケット数はデフォルト値の254を使用します。
SKEWONLY：データの分布が均一でない列のヒストグラムのみを収集します。ヒストグラムバケット数はデフォルト値の254を使用します。
column_name：列名。
extension：(column_name, colume_name [, ...]) 形式の列グループまたは式を指定できます。デフォルト値は FOR ALL COLUMNS SIZE AUTO です。

degree

パラレル度。デフォルト値は NULL です。NULL は CREATE TABLE または ALTER TABLE ステートメント内の DEGREE 句で指定されたテーブルのデフォルト値を使用することを意味します。DEGREE=>NULL、DEGREE=>n を使用する場合、オブジェクトのサイズがパラレル実行を保証しない場合、DBMS_STATS はシリアル実行を使用する可能性があります。

granularity

収集する統計情報の粒度（テーブルがパーティション化されている場合にのみ適用されます）。

ALL：すべて（サブパーティション、パーティション、およびグローバル）の統計情報を収集します。
APPROX_GLOBAL AND PARTITION：GLOBAL AND PARTITION と同様ですが、この場合、グローバル統計情報はパーティションレベルの統計情報の集計です。このオプションは、異なる値の数とインデックスの異なるキーの数以外のすべての統計情報を集計します。ただし、統計情報を持つパーティションのみを集計します。partname が NULL である場合、または集計を実行できない場合（例えば、いずれかのパーティションの統計情報が欠落している場合）、グローバル統計情報が収集されます。
AUTO：パーティションタイプに基づいて粒度を決定します。これがデフォルト値です。
DEFAULT：グローバルおよびパーティションレベルの統計情報を収集します。このオプションは廃止されました。代わりに GLOBAL AND PARTITION の使用を推奨します。
GLOBAL：グローバル統計情報を収集します。
GLOBAL AND PARTITION：グローバルおよびパーティションレベルの統計情報を収集します。複合パーティションオブジェクトであっても、サブパーティションレベルの統計情報は収集されません。
PARTITION：パーティションレベルの統計情報を収集します。
SUBPARTITION：サブパーティションレベルの統計情報を収集します。

cascade

テーブルと列の統計情報に加えて、インデックスに関する統計情報も収集します。これは、スキーマ内の各インデックスに対してGATHER_INDEX_STATSプロシージャを実行することと同等です。

no_invalidate

統計情報を収集する際にPlan Cacheをフラッシュするかどうか。TRUEに設定すると、統計情報を収集する際にPlan Cacheをフラッシュしません。

stattype

現在の統計情報が格納される場所。

force

ロック状態を無視して強制的に統計情報を収集するかどうか。デフォルトはFALSEです。TRUEに設定すると、統計情報がロックされていても収集されます。

hist_est_percent

ヒストグラムのサンプリング率を指定します。

hist_block_sample

ヒストグラムのサンプリング方式を指定します。

エラーコード	説明
OBE-20000	テーブルが存在しないか、権限が不足しています。
OBE-20001	入力値が誤っています。

GATHER_TABLE_STATS

適用対象

構文

パラメータの説明

異常時の対応

使用方法

例