管理者は DDL を表示 [ジョブ|ジョブクエリ]

ADMIN SHOW DDL [JOBS|JOB QUERIES]ステートメントは、実行中の DDL ジョブと最近完了した DDL ジョブに関する情報を表示します。

概要

AdminShowDDLStmt
NumList
WhereClauseOptional

AdminShowDDLStmt ::=
    'ADMIN' 'SHOW' 'DDL'
    ( 
        'JOBS' Int64Num? WhereClauseOptional 
    |   'JOB' 'QUERIES' NumList 
    |   'JOB' 'QUERIES' 'LIMIT' m ( ('OFFSET' | ',') n )?
    )?

NumList ::=
    Int64Num ( ',' Int64Num )*

WhereClauseOptional ::=
    WhereClause?

例

`ADMIN SHOW DDL`

現在実行中の DDL ジョブのステータスを表示するには、 ADMIN SHOW DDL使用します。出力には、現在のスキーマバージョン、所有者の DDL ID とアドレス、実行中の DDL ジョブと SQL ステートメント、現在の TiDB インスタンスの DDL ID が含まれます。返される結果フィールドは、次のように説明されます。

SCHEMA_VER : スキーマのバージョンを示す数値。
OWNER_ID : DDL所有者のUUID。2も参照してくださいTIDB_IS_DDL_OWNER()
OWNER_ADDRESS : DDL 所有者の IP アドレス。
RUNNING_JOBS : 実行中の DDL ジョブの詳細。
SELF_ID : 現在接続している TiDB ノードの UUID。 SELF_ID OWNER_IDと同じ場合は、DDL 所有者に接続していることを意味します。
QUERY : クエリのステートメント。

ADMIN SHOW DDL\G;

*************************** 1. row ***************************
   SCHEMA_VER: 26
     OWNER_ID: 2d1982af-fa63-43ad-a3d5-73710683cc63
OWNER_ADDRESS: 0.0.0.0:4000
 RUNNING_JOBS: 
      SELF_ID: 2d1982af-fa63-43ad-a3d5-73710683cc63
        QUERY: 
1 row in set (0.00 sec)

`ADMIN SHOW DDL JOBS`

ADMIN SHOW DDL JOBSステートメントは、実行中およびキューイング中のタスクを含む現在の DDL ジョブキュー内のすべての結果と、完了した DDL ジョブキュー内の最新の 10 件の結果を表示するために使用されます。返される結果フィールドは次のように説明されます。

JOB_ID : 各 DDL 操作は DDL ジョブに対応します。2 JOB_IDグローバルに一意です。
DB_NAME : DDL 操作が実行されるデータベースの名前。
TABLE_NAME : DDL 操作が実行されるテーブルの名前。
JOB_TYPE : DDL 操作のタイプ。一般的なジョブタイプは次のとおりです。
- create schema : CREATE SCHEMA操作の場合。
- create table : CREATE TABLE操作の場合。
- create view : CREATE VIEW操作の場合。
- ingest : tidb_ddl_enable_fast_reorgで設定された高速インデックスバックフィルによる取り込み。
- txn : 基本的なトランザクションのバックフィル。
- add index /* txn-merge */ : バックフィルが完了すると元のインデックスとマージされる一時インデックスを使用したトランザクションバックフィル。
SCHEMA_STATE : DDL が操作するスキーマオブジェクトの現在の状態。 JOB_TYPEがADD INDEXの場合はインデックスの状態、 JOB_TYPEがADD COLUMNの場合は列の状態、 JOB_TYPEがCREATE TABLE場合はテーブルの状態です。一般的な状態は次のとおりです。
- none : 存在しないことを示します。通常、 DROPの操作の後、またはCREATE操作が失敗してロールバックした後は、 none番目の状態になります。
- delete only : これらの 4 つwrite only状態は中間状態です。それぞれの意味については、 TiDB でのオンライン DDL 非同期変更の仕組み write reorganizationしてください。中間状態の変換は高速であるため、これらの状態delete reorganization通常、操作中に表示されませんADD INDEX操作を実行している場合にのみ、インデックスデータが追加されていることを示すwrite reorganization状態が表示されます。
- public : 存在し、ユーザーが利用できることを示します。通常、 CREATE TABLEとADD INDEX (またはADD COLUMN ) の操作が完了すると、 public状態になり、新しく作成されたテーブル、列、およびインデックスを正常に読み書きできることを示します。
SCHEMA_ID : DDL 操作が実行されるデータベースの ID。
TABLE_ID : DDL 操作が実行されるテーブルの ID。
ROW_COUNT : ADD INDEX操作を実行すると、追加されたデータ行の数になります。
CREATE_TIME : DDL 操作の作成時刻。
START_TIME : DDL 操作の開始時刻。
END_TIME : DDL 操作の終了時刻。
STATE : DDL 操作の状態。一般的な状態は次のとおりです。
- none : 操作がまだ開始されていないことを示します。
- queueing : 操作ジョブが DDL ジョブキューに入ったが、以前の DDL ジョブの完了を待機しているため実行されていないことを示します。別の理由としては、 DROP操作を実行した後、 queueing番目の状態がdone番目の状態になりますが、すぐにsynced番目の状態に更新され、すべての TiDB インスタンスがその状態に同期されたことが示されることが考えられます。
- running : 操作が実行中であることを示します。
- synced : 操作が正常に実行され、すべての TiDB インスタンスがこの状態に同期されていることを示します。
- rollback done : 操作が失敗し、ロールバックが完了したことを示します。
- rollingback : 操作が失敗し、ロールバック中であることを示します。
- cancelling : 操作がキャンセルされていることを示します。この状態は、 ADMIN CANCEL DDL JOBSコマンドを使用して DDL ジョブをキャンセルした場合にのみ表示されます。
- cancelled : 操作がキャンセルされたことを示します。
- pausing : 操作が一時停止されていることを示します。
- paused : 操作が一時停止されていることを示します。この状態は、 ADMIN PAUSED DDL JOBSコマンドを使用して DDL ジョブを一時停止した場合にのみ表示されます。4 コマンドを使用してADMIN RESUME DDL JOBSジョブを再開できます。
- done : 操作は TiDB 所有者ノードで正常に実行されたが、他の TiDB ノードはこの DDL ジョブによって実行された変更をまだ同期していないことを示します。

次の例はADMIN SHOW DDL JOBSの結果を示しています。

ADMIN SHOW DDL JOBS;

mysql> ADMIN SHOW DDL JOBS;
+--------+---------+--------------------+--------------+----------------------+-----------+----------+-----------+-----------------------------------------------------------------+---------+
| JOB_ID | DB_NAME | TABLE_NAME         | JOB_TYPE     | SCHEMA_STATE         | SCHEMA_ID | TABLE_ID | ROW_COUNT | CREATE_TIME         | START_TIME          | END_TIME            | STATE   |
+--------+---------+--------------------+--------------+----------------------+-----------+----------+-----------+---------------------+-------------------------------------------+---------+
|     59 | test    | t1                 | add index    | write reorganization |         1 |       55 |     88576 | 2020-08-17 07:51:58 | 2020-08-17 07:51:58 | NULL                | running |
|     60 | test    | t2                 | add index    | none                 |         1 |       57 |         0 | 2020-08-17 07:51:59 | 2020-08-17 07:51:59 | NULL                | none    |
|     58 | test    | t2                 | create table | public               |         1 |       57 |         0 | 2020-08-17 07:41:28 | 2020-08-17 07:41:28 | 2020-08-17 07:41:28 | synced  |
|     56 | test    | t1                 | create table | public               |         1 |       55 |         0 | 2020-08-17 07:41:02 | 2020-08-17 07:41:02 | 2020-08-17 07:41:02 | synced  |
|     54 | test    | t1                 | drop table   | none                 |         1 |       50 |         0 | 2020-08-17 07:41:02 | 2020-08-17 07:41:02 | 2020-08-17 07:41:02 | synced  |
|     53 | test    | t1                 | drop index   | none                 |         1 |       50 |         0 | 2020-08-17 07:35:44 | 2020-08-17 07:35:44 | 2020-08-17 07:35:44 | synced  |
|     52 | test    | t1                 | add index    | public               |         1 |       50 |    451010 | 2020-08-17 07:34:43 | 2020-08-17 07:34:43 | 2020-08-17 07:35:16 | synced  |
|     51 | test    | t1                 | create table | public               |         1 |       50 |         0 | 2020-08-17 07:34:02 | 2020-08-17 07:34:02 | 2020-08-17 07:34:02 | synced  |
|     49 | test    | t1                 | drop table   | none                 |         1 |       47 |         0 | 2020-08-17 07:34:02 | 2020-08-17 07:34:02 | 2020-08-17 07:34:02 | synced  |
|     48 | test    | t1                 | create table | public               |         1 |       47 |         0 | 2020-08-17 07:33:37 | 2020-08-17 07:33:37 | 2020-08-17 07:33:37 | synced  |
|     46 | mysql   | stats_extended     | create table | public               |         3 |       45 |         0 | 2020-08-17 06:42:38 | 2020-08-17 06:42:38 | 2020-08-17 06:42:38 | synced  |
|     44 | mysql   | opt_rule_blacklist | create table | public               |         3 |       43 |         0 | 2020-08-17 06:42:38 | 2020-08-17 06:42:38 | 2020-08-17 06:42:38 | synced  |
+--------+---------+--------------------+--------------+----------------------+-----------+----------+-----------+---------------------+---------------------+-------------------------------+
12 rows in set (0.00 sec)

上記の出力から:

ジョブ 59 は現在進行中です ( STATE )。スキーマの状態は現在write reorganizationですが、タスクが完了するとpublicに切り替わりrunningユーザーセッションによって変更が公開されることに注意してください。9 列もend_timeになっておりNULLジョブの完了時間が現在不明であることを示しています。
ジョブ 60 はadd indexジョブであり、現在キューに入れられてジョブ 59 の完了を待機しています。ジョブ 59 が完了すると、ジョブ 60 のSTATE runningに切り替わります。
インデックスの削除やテーブルの削除などの破壊的な変更の場合、ジョブが完了するとSCHEMA_STATEがnoneに変わります。追加的な変更の場合、 SCHEMA_STATEがpublicに変わります。

表示される行数を制限するには、数値と where 条件を指定します。

ADMIN SHOW DDL JOBS [NUM] [WHERE where_condition];

NUM : 完了した DDL ジョブキューの最後のNUMの結果を表示します。指定しない場合は、デフォルトでNUMまたは 10 になります。
WHERE : フィルター条件を追加します。

`ADMIN SHOW DDL JOB QUERIES`

job_idに対応する DDL ジョブの元の SQL ステートメントを表示するには、 ADMIN SHOW DDL JOB QUERIES使用します。

ADMIN SHOW DDL JOBS;
ADMIN SHOW DDL JOB QUERIES 51;

mysql> ADMIN SHOW DDL JOB QUERIES 51;
+--------------------------------------------------------------+
| QUERY                                                        |
+--------------------------------------------------------------+
| CREATE TABLE t1 (id INT NOT NULL PRIMARY KEY auto_increment) |
+--------------------------------------------------------------+
1 row in set (0.02 sec)

DDL 履歴ジョブキュー内の過去 10 件の結果のうち、 job_idに対応する実行中の DDL ジョブのみを検索できます。

`ADMIN SHOW DDL JOB QUERIES LIMIT m OFFSET n`

job_idに対応する指定された範囲[n+1, n+m]内の DDL ジョブの元の SQL ステートメントを表示するには、 ADMIN SHOW DDL JOB QUERIES LIMIT m OFFSET nを使用します。

 ADMIN SHOW DDL JOB QUERIES LIMIT m;  # Retrieve first m rows
 ADMIN SHOW DDL JOB QUERIES LIMIT n, m;  # Retrieve rows [n+1, n+m]
 ADMIN SHOW DDL JOB QUERIES LIMIT m OFFSET n;  # Retrieve rows [n+1, n+m]

ここで、 nとm 0 以上の整数です。

ADMIN SHOW DDL JOB QUERIES LIMIT 3;  # Retrieve first 3 rows
+--------+--------------------------------------------------------------+
| JOB_ID | QUERY                                                        |
+--------+--------------------------------------------------------------+
|     59 | ALTER TABLE t1 ADD INDEX index2 (col2)                       |
|     60 | ALTER TABLE t2 ADD INDEX index1 (col1)                       |
|     58 | CREATE TABLE t2 (id INT NOT NULL PRIMARY KEY auto_increment) |
+--------+--------------------------------------------------------------+
3 rows in set (0.00 sec)

ADMIN SHOW DDL JOB QUERIES LIMIT 6, 2;  # Retrieve rows 7-8
+--------+----------------------------------------------------------------------------+
| JOB_ID | QUERY                                                                      |
+--------+----------------------------------------------------------------------------+
|     52 | ALTER TABLE t1 ADD INDEX index1 (col1)                                     |
|     51 | CREATE TABLE IF NOT EXISTS t1 (id INT NOT NULL PRIMARY KEY auto_increment) |
+--------+----------------------------------------------------------------------------+
3 rows in set (0.00 sec)

ADMIN SHOW DDL JOB QUERIES LIMIT 3 OFFSET 4;  # Retrieve rows 5-7
+--------+----------------------------------------+
| JOB_ID | QUERY                                  |
+--------+----------------------------------------+
|     54 | DROP TABLE IF EXISTS t3                |
|     53 | ALTER TABLE t1 DROP INDEX index1       |
|     52 | ALTER TABLE t1 ADD INDEX index1 (col1) |
+--------+----------------------------------------+
3 rows in set (0.00 sec)

DDL 履歴ジョブキュー内の任意に指定した結果範囲内で、 job_idに対応する実行中の DDL ジョブを検索できます。この構文には、 ADMIN SHOW DDL JOB QUERIESの最後の 10 件の結果という制限はありません。

MySQL 互換性

このステートメントは、MySQL 構文に対する TiDB 拡張です。

管理者は DDL を表示 [ジョブ|ジョブ クエリ]

概要

例

ADMIN SHOW DDL

ADMIN SHOW DDL JOBS

ADMIN SHOW DDL JOB QUERIES

ADMIN SHOW DDL JOB QUERIES LIMIT m OFFSET n