テーブルステータスを設定

説明

SET TABLE STATUS文は、OLAPテーブルのステータスを手動で設定するために使用されます。この文には以下の機能があります：

• OLAPテーブルのステータス設定のみサポートします。
• テーブルステータスを指定したターゲット状態に変更できます。
• テーブルステータスによって引き起こされるタスクブロッキングを解決するために使用されます。

サポートされる状態：

状態	説明
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"プロパティは設定する必要があり、その値はサポートされている状態の1つである必要があります。

アクセス制御要件

この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");