メインコンテンツまでスキップ
に最終更新

SHOW ANALYZE

説明​

統計情報収集ジョブの状態を表示します。

構文​

SHOW [AUTO] ANALYZE [ <table_name> | <job_id> ]
    [ WHERE STATE = {"PENDING" | "RUNNING" | "FINISHED" | "FAILED"} ];

必須パラメータ​

なし

任意パラメータ​

1. AUTO

自動ジョブの情報を表示します。指定しない場合は、デフォルトで手動ジョブの情報を表示します。

2. <table_name>

テーブル名。指定すると、そのテーブルに対応するジョブの情報を表示します。指定しない場合は、デフォルトですべてのテーブルのジョブ情報を返します。

3. <job_id>

統計情報収集ジョブの ID。ANALYZE による非同期収集を実行したときに取得します。指定しない場合は、すべてのジョブの情報を返します。

4. WHERE STATE = {"PENDING" | "RUNNING" | "FINISHED" | "FAILED"}

ジョブの状態によるフィルター条件。指定しない場合は、デフォルトですべての状態のジョブ情報を表示します。

戻り値​

列説明
job_id統計情報収集ジョブの一意な ID
catalog_nameカタログ名
db_nameデータベース名
tbl_nameテーブル名
col_name列名のリスト
job_typeジョブの種類
analysis_type分析の種類
messageエラーメッセージ
last_exec_time_in_ms最後に分析を実行した時刻
stateジョブの状態
progressジョブの進捗
schedule_typeスケジュールの種類
start_timeジョブの開始時刻
end_timeジョブの終了時刻
priorityジョブの優先度
enable_partitionパーティション単位の収集を有効にするかを示すフラグ

アクセス制御要件​

この SQL を実行するユーザーには、少なくとも次の権限が必要です。

権限オブジェクト備考
SELECT_PRIVテーブルSHOW を実行するには、照会対象のテーブルに対する SELECT_PRIV 権限が必要です。

例​

  1. テーブル名でジョブを表示する。
SHOW ANALYZE test1 WHERE STATE="FINISHED";
+---------------+--------------+---------+----------+-----------------------+----------+---------------+---------+----------------------+----------+-------------------------------------------------------+---------------+---------------------+---------------------+----------+------------------+
| job_id        | catalog_name | db_name | tbl_name | col_name              | job_type | analysis_type | message | last_exec_time_in_ms | state    | progress                                              | schedule_type | start_time          | end_time            | priority | enable_partition |
+---------------+--------------+---------+----------+-----------------------+----------+---------------+---------+----------------------+----------+-------------------------------------------------------+---------------+---------------------+---------------------+----------+------------------+
| 1737454119144 | internal     | test    | test1    | [test1:name,test1:id] | MANUAL   | FUNDAMENTALS  |         | 2025-01-21 18:10:11  | FINISHED | 2 Finished  |  0 Failed  |  0 In Progress  |  2 Total | ONCE          | 2025-01-21 18:10:10 | 2025-01-21 18:10:11 | MANUAL   | false            |
| 1738725887879 | internal     | test    | test1    | [test1:name,test1:id] | MANUAL   | FUNDAMENTALS  |         | 2025-02-05 11:26:15  | FINISHED | 2 Finished  |  0 Failed  |  0 In Progress  |  2 Total | ONCE          | 2025-02-05 11:26:15 | 2025-02-05 11:26:15 | MANUAL   | false            |
| 1738725887890 | internal     | test    | test1    | [test1:name,test1:id] | MANUAL   | FUNDAMENTALS  |         | 2025-02-05 12:17:09  | FINISHED | 2 Finished  |  0 Failed  |  0 In Progress  |  2 Total | ONCE          | 2025-02-05 12:17:08 | 2025-02-05 12:17:09 | MANUAL   | false            |
| 1738725887895 | internal     | test    | test1    | [test1:id]            | MANUAL   | FUNDAMENTALS  |         | 2025-02-05 12:17:24  | FINISHED | 1 Finished  |  0 Failed  |  0 In Progress  |  1 Total | ONCE          | 2025-02-05 12:17:23 | 2025-02-05 12:17:24 | MANUAL   | false            |
| 1738725887903 | internal     | test    | test1    | [test1:id]            | MANUAL   | FUNDAMENTALS  |         | 2025-02-05 12:17:42  | FINISHED | 1 Finished  |  0 Failed  |  0 In Progress  |  1 Total | ONCE          | 2025-02-05 12:17:41 | 2025-02-05 12:17:42 | MANUAL   | false            |
+---------------+--------------+---------+----------+-----------------------+----------+---------------+---------+----------------------+----------+-------------------------------------------------------+---------------+---------------------+---------------------+----------+------------------+
  1. ジョブ ID でジョブを表示する。
show analyze 1738725887903;
+---------------+--------------+---------+----------+------------+----------+---------------+---------+----------------------+----------+-------------------------------------------------------+---------------+---------------------+---------------------+----------+------------------+
| job_id        | catalog_name | db_name | tbl_name | col_name   | job_type | analysis_type | message | last_exec_time_in_ms | state    | progress                                              | schedule_type | start_time          | end_time            | priority | enable_partition |
+---------------+--------------+---------+----------+------------+----------+---------------+---------+----------------------+----------+-------------------------------------------------------+---------------+---------------------+---------------------+----------+------------------+
| 1738725887903 | internal     | test    | test1    | [test1:id] | MANUAL   | FUNDAMENTALS  |         | 2025-02-05 12:17:42  | FINISHED | 1 Finished  |  0 Failed  |  0 In Progress  |  1 Total | ONCE          | 2025-02-05 12:17:41 | 2025-02-05 12:17:42 | MANUAL   | false            |
+---------------+--------------+---------+----------+------------+----------+---------------+---------+----------------------+----------+-------------------------------------------------------+---------------+---------------------+---------------------+----------+------------------+
Report issue