LOCK_TABLE_STATS プロシージャは、テーブルの統計情報をロックするために使用されます。
適用対象
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity EditionはMySQLモードのみを提供します。
構文
DBMS_STATS.LOCK_TABLE_STATS (
ownname VARCHAR2,
tabname VARCHAR2,
stattype VARCHAR2 DEFAULT 'ALL');
パラメータ説明
パラメータ |
説明 |
|---|---|
| ownname | ユーザー名。ユーザー名をNULLに設定した場合、デフォルトで現在ログインしているユーザー名が使用されます。 |
| tabname | テーブル名。 |
| stattype | ロックのタイプ。一般的に以下の3種類のロックタイプが含まれます:
'ALL'タイプのみをサポートしています。 |
使用方法
このプロシージャを呼び出すには、テーブルの所有者である必要があります。
SYSが所有するオブジェクトについては、テーブルの所有者またはSYSDBA権限が必要です。テーブルの統計情報がロックされると、そのテーブルに依存するすべての統計情報もロックされます。これには、テーブルレベルの統計情報、列レベルの統計情報、ヒストグラム統計情報、およびインデックスに依存するすべての統計情報が含まれます。
オブジェクトの統計情報がロックされている場合、
SET_*、DELETE_*、IMPORT_*、GATHER_*プロシージャを実行して単一のテーブル、インデックス、または列の統計情報を変更しようとすると、エラーが発生します。EXPORT_*_STATSプロシージャを呼び出す際、ロックまたはアンロック状態はテーブルレベルの統計情報と共にエクスポートされません。UNLOCK_SCHEMA_STATSプロシージャとUNLOCK_TABLE_STATSプロシージャのどちらも、対応するパーティションの統計情報をアンロックすることはできません。LOCK_TABLE_STATSプロシージャを呼び出すと、テーブルレベルでロック位置が設定されます。そのため、パーティションやインデックスなどの依存オブジェクトに関する統計情報を収集することはできません。また、テーブルレベルの統計情報がロックされている場合、その依存関係もロックされるため、パーティション統計情報をロックするためにLOCK_PARTITION_STATSプロシージャを明示的に呼び出す必要はありません。
例
ユーザー testUser01 のテーブル t1 のテーブルレベル統計情報をロックします。
obclient> CALL DBMS_STATS.LOCK_TABLE_STATS ('testUser01', 't1');
Query OK, 0 rows affected