SET TABLE STATUS
説明
SET TABLE STATUS文は、OLAPテーブルのステータスを手動で設定するために使用されます。この文には以下の機能があります：
- OLAPテーブルのステータス設定のみをサポートします。
- テーブルステータスを指定されたターゲット状態に変更できます。
- テーブルステータスによって引き起こされるタスクのブロッキングを解決するために使用されます。
サポートされる状態：
| State | Description |
|---|---|
| NORMAL | テーブルが正常な状態にあることを示します。 |
| ROLLUP | テーブルがROLLUP操作を実行中であることを示します。 |
| SCHEMA_CHANGE | テーブルがスキーマ変更を実行中であることを示します。 |
| BACKUP | テーブルがバックアップ操作を実行中であることを示します。 |
| RESTORE | テーブルがリストア操作を実行中であることを示します。 |
| WAITING_STABLE | テーブルが安定状態を待機中であることを示します。 |
構文
ADMIN SET TABLE <table_name> STATUS PROPERTIES ("<key>" = "<value>" [, ...]);
ここで：
<key>
: "state"
<value>
: "NORMAL"
| "ROLLUP"
| "SCHEMA_CHANGE"
| "BACKUP"
| "RESTORE"
| "WAITING_STABLE"
必須パラメータ
1. <table_name>
ステータスを設定する必要があるテーブルの名前を指定します。
テーブル名はそのデータベース内で一意である必要があります。
2. PROPERTIES ("state" = "<value>")
テーブルの目標ステータスを指定します。
"state" プロパティを設定する必要があり、その値はサポートされているステータスのいずれかである必要があります。
アクセス制御要件
このSQLコマンドを実行するユーザーは、少なくとも以下の権限を持つ必要があります：
| 権限 | オブジェクト | 備考 |
|---|---|---|
| ADMIN | System | このコマンドを実行するには、ユーザーはADMIN権限を持つ必要があります。 |
使用上の注意
- このコマンドは緊急時の障害復旧を目的としています。慎重にご使用ください。
- OLAPテーブルのみサポートしており、他のタイプのテーブルはサポートしていません。
- テーブルがすでに目標ステータスにある場合、このコマンドは無視されます。
- 不適切なステータス設定はシステム異常を引き起こす可能性があります。技術サポートの指導の下でこのコマンドを使用することを推奨します。
- ステータスを変更した後は、システムの運用状況を速やかに監視することをお勧めします。
例
-
テーブルステータスをNORMALに設定：
ADMIN SET TABLE tbl1 STATUS PROPERTIES("state" = "NORMAL"); -
テーブルのステータスをSCHEMA_CHANGEに設定します：
ADMIN SET TABLE tbl2 STATUS PROPERTIES("state" = "SCHEMA_CHANGE");