SET_INDEX_STATSプロシージャは、インデックス関連の情報を設定するために使用されます。
適用対象
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity EditionはMySQLモードのみを提供します。
構文
DBMS_STATS.SET_INDEX_STATS (
ownname VARCHAR2,
indname VARCHAR2,
partname VARCHAR2 DEFAULT NULL,
numrows NUMBER DEFAULT NULL,
no_invalidate BOOLEAN DEFAULT FALSE,
force BOOLEAN DEFAULT FALSE,
avgrlen NUMBER DEFAULT NULL,
nummacroblks NUMBER DEFAULT NULL,
nummicroblks NUMBER DEFAULT NULL,
tabname VARCHAR2 DEFAULT NULL);
パラメータの説明
| パラメータ | 説明 |
|---|---|
| ownname | ユーザー名。ユーザー名を NULL に設定した場合、デフォルトで現在のログインユーザー名が使用されます。 |
| indname | インデックス名。 |
| partname | パーティション名。 |
| numrows | インデックス内の行数（パーティション）。 |
| no_invalidate | 統計情報収集時にPlan Cacheをフラッシュするかどうか。TRUE に設定すると、統計情報収集時にPlan Cacheをフラッシュしません。 |
| force | インデックス統計情報を強制的に設定し、ロック状態を無視するかどうか。デフォルトは FALSE です。TRUE に設定すると、統計情報がロックされている場合でもインデックス統計情報を設定します。 |
| avgrlen | インデックステーブルの平均行長（バイト単位）。 |
| nummacroblks | インデックステーブルのマクロブロック数。 |
| nummicroblks | インデックステーブルのマイクロブロック数。 |
| tabname | テーブル名。 |
異常時の対応
| エラーコード | 説明 |
|---|---|
| OBE-20000 | 対象のオブジェクトが存在しないか、権限が不足しています。 |
| OBE-20001 | 無効な入力値です。 |
| OBE-20005 | 対象のオブジェクトの統計情報がロックされています。 |
使用方法
このプロシージャを呼び出すには、テーブルの所有者である必要があります。
SYSが所有するオブジェクトについては、テーブルの所有者またはSYSDBA権限を持っている必要があります。オプティマイザーは、データをキャッシュすることでインデックスまたは統計テーブルへのアクセスにおけるキャッシュされたブロック数を推定します。操作の総コストには、ディスクからキャッシュされていないブロックを読み取るI/Oコスト、バッファからキャッシュされたブロックを取得するCPUコスト、およびデータを処理するCPUコストが含まれます。
TRUEおよびFALSEの値を取るパラメータについては、BEGIN ... ENDブロック内でこのプロシージャを実行する必要があります。
例
ユーザーtestUser01のインデックスidx1に関する情報を設定します。
obclient> CALL DBMS_STATS.SET_INDEX_STATS('testUser01', 'idx1', numrows=>10, avgrlen=>10，'tbl1');
Query OK, 0 rows affected
説明
OceanBaseデータベースのOracleモードでは、インデックスは現在のユーザーに対して一意であるため、tabnameを指定する必要はありません。しかし、MySQLモードではインデックスが現在のユーザーに対して一意ではないため、テーブル名を明示的に指定する必要があります。