IMPORT_COLUMN_STATS プロシージャは、列レベルの統計情報をインポートするために使用されます。
機能の適用範囲
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity EditionはMySQLモードのみを提供します。
構文
DBMS_STATS.IMPORT_COLUMN_STATS (
ownname VARCHAR2,
tabname VARCHAR2,
colname VARCHAR2,
partname VARCHAR2 DEFAULT NULL,
stattab VARCHAR2,
statown VARCHAR2 DEFAULT NULL,
no_invalidate BOOLEAN DEFAULT FALSE,
force BOOLEAN DEFAULT FALSE);
パラメータの説明
パラメータ |
説明 |
|---|---|
| ownname | ユーザー名。ユーザー名が NULL に設定されている場合、現在ログインしているユーザー名がデフォルトで使用されます。 |
| tabname | この列が属するテーブル名。 |
| colname | 列名。 |
| partname | テーブルのパーティション名。テーブルがパーティション化されており、partname が NULL の場合、グローバルおよびパーティション列統計情報をインポートします。 |
| stattab | インポートするユーザー統計情報テーブルのテーブル名を指定します。 |
| statown | インポートするユーザー統計情報テーブルのユーザー名を指定します。 |
| no_invalidate | 統計情報収集時にPlan Cacheをフラッシュするかどうかを示します。TRUE に設定すると、統計情報収集時にPlan Cacheをフラッシュしません。 |
| force | ロック状態を無視して強制的にインポートするかどうかを示します。デフォルトは FALSE です。TRUE に設定すると、統計情報がロックされていてもインポートされます。 |
例外
エラーコード |
説明 |
|---|---|
| OBE-20000 | 対象が存在しないか、権限が不足しています。 |
| OBE-20001 | ユーザー情報統計テーブルの値が無効または一貫性がありません。 |
| OBE-20005 | 対象の統計情報がロックされています。 |
使用方法
このプロシージャを呼び出すには、テーブルの所有者である必要があります。SYS が所有するオブジェクトについては、テーブルの所有者または SYSDBA 権限が必要です。
例
test_stat テーブルから、ユーザー testUser01 の tbl1 テーブルの col1 列の統計情報をインポートします。
obclient> CALL DBMS_STATS.IMPORT_COLUMN_STATS ('testUser01', 'tbl1','col1',null, stattab=>'test_stat', statown=>'testUser01');
Query OK, 0 rows affected