管理者
このステートメントは TiDB 拡張構文であり、TiDB のステータスを表示し、TiDB 内のテーブルのデータを確認するために使用されます。このドキュメントでは、次のADMIN
の関連ステートメントを紹介します。
DDL 関連ステートメント
声明 | 説明 |
---|---|
ADMIN CANCEL DDL JOBS | 現在実行中の DDL ジョブをキャンセルします。 |
ADMIN CHECKSUM TABLE | テーブルのすべての行 + インデックスの CRC64 を計算します。 |
[`ADMIN CHECK [TABLE | INDEX]`](/sql-statements/sql-statement-admin-check-table-index.md) |
[`ADMIN SHOW DDL [JOBS | QUERIES]`](/sql-statements/sql-statement-admin-show-ddl.md) |
ADMIN SHOW TELEMETRY | テレメトリ機能の一部として PingCAP に報告される情報を示します。 |
ADMIN RELOAD
ステートメント
ADMIN RELOAD expr_pushdown_blacklist;
上記のステートメントは、式によってプッシュされたブロックリストをリロードするために使用されます。
ADMIN RELOAD opt_rule_blacklist;
上記のステートメントは、ロジック最適化ルールのブロックリストをリロードするために使用されます。
ADMIN PLUGINS
関連ステートメント
ADMIN PLUGINS ENABLE plugin_name [, plugin_name] ...;
上記のステートメントは、 plugin_name
プラグインを有効にするために使用されます。
ADMIN PLUGINS DISABLE plugin_name [, plugin_name] ...;
上記のステートメントは、 plugin_name
プラグインを無効にするために使用されます。
ADMIN BINDINGS
関連ステートメント
ADMIN FLUSH BINDINGS;
上記のステートメントは、SQL Plan バインディング情報を保持するために使用されます。
ADMIN CAPTURE BINDINGS;
上記のステートメントは、複数回出現するSELECT
のステートメントから SQL Plan のバインドを生成できます。
ADMIN EVOLVE BINDINGS;
自動バインディング機能が有効になると、SQL計画バインディング情報の展開がbind-info-leave
ごとにトリガーされます(デフォルト値は3s
です)。上記のステートメントは、この進化を積極的にトリガーするために使用されます。
ADMIN RELOAD BINDINGS;
上記のステートメントは、SQL 計画バインディング情報を再ロードするために使用されます。
ADMIN REPAIR
ステートメント
極端な場合に、格納されたテーブルのメタデータを信頼できない方法で上書きするには、 ADMIN REPAIR TABLE
を使用します。
ADMIN REPAIR TABLE tbl_name CREATE TABLE STATEMENT;
ここで「信頼できない」とは、元のテーブルのメタデータがCREATE TABLE STATEMENT
の操作でカバーできることを手動で確認する必要があることを意味します。このREPAIR
ステートメントを使用するには、 repair-mode
構成項目を有効にし、修復するテーブルがrepair-table-list
にリストされていることを確認します。
ADMIN SHOW SLOW
ステートメント
ADMIN SHOW SLOW RECENT N;
ADMIN SHOW SLOW TOP [INTERNAL | ALL] N;
詳細は管理者は遅いステートメントを表示します参照
あらすじ
- AdminStmt
AdminStmt ::=
'ADMIN' ( 'SHOW' ( 'DDL' ( 'JOBS' Int64Num? WhereClauseOptional | 'JOB' 'QUERIES' NumList )? | TableName 'NEXT_ROW_ID' | 'SLOW' AdminShowSlow ) | 'CHECK' ( 'TABLE' TableNameList | 'INDEX' TableName Identifier ( HandleRange ( ',' HandleRange )* )? ) | 'RECOVER' 'INDEX' TableName Identifier | 'CLEANUP' ( 'INDEX' TableName Identifier | 'TABLE' 'LOCK' TableNameList ) | 'CHECKSUM' 'TABLE' TableNameList | 'CANCEL' 'DDL' 'JOBS' NumList | 'RELOAD' ( 'EXPR_PUSHDOWN_BLACKLIST' | 'OPT_RULE_BLACKLIST' | 'BINDINGS' ) | 'PLUGINS' ( 'ENABLE' | 'DISABLE' ) PluginNameList | 'REPAIR' 'TABLE' TableName CreateTableStmt | ( 'FLUSH' | 'CAPTURE' | 'EVOLVE' ) 'BINDINGS' )
例
次のコマンドを実行して、現在実行中の DDL ジョブ キューで完了した最新の 10 個の DDL ジョブを表示します。 NUM
が指定されていない場合、デフォルトでは、完了した最後の 10 個の DDL ジョブのみが表示されます。
ADMIN SHOW DDL JOBS;
+--------+---------+------------+---------------------+----------------+-----------+----------+-----------+-----------------------------------+-----------------------------------+---------------+
| JOB_ID | DB_NAME | TABLE_NAME | JOB_TYPE | SCHEMA_STATE | SCHEMA_ID | TABLE_ID | ROW_COUNT | START_TIME | END_TIME | STATE |
+--------+---------+------------+---------------------+----------------+-----------+----------+-----------+-----------------------------------+-----------------------------------+---------------+
| 45 | test | t1 | add index | write reorganization | 32 | 37 | 0 | 2019-01-10 12:38:36.501 +0800 CST | | running |
| 44 | test | t1 | add index | none | 32 | 37 | 0 | 2019-01-10 12:36:55.18 +0800 CST | 2019-01-10 12:36:55.852 +0800 CST | rollback done |
| 43 | test | t1 | add index | public | 32 | 37 | 6 | 2019-01-10 12:35:13.66 +0800 CST | 2019-01-10 12:35:14.925 +0800 CST | synced |
| 42 | test | t1 | drop index | none | 32 | 37 | 0 | 2019-01-10 12:34:35.204 +0800 CST | 2019-01-10 12:34:36.958 +0800 CST | synced |
| 41 | test | t1 | add index | public | 32 | 37 | 0 | 2019-01-10 12:33:22.62 +0800 CST | 2019-01-10 12:33:24.625 +0800 CST | synced |
| 40 | test | t1 | drop column | none | 32 | 37 | 0 | 2019-01-10 12:33:08.212 +0800 CST | 2019-01-10 12:33:09.78 +0800 CST | synced |
| 39 | test | t1 | add column | public | 32 | 37 | 0 | 2019-01-10 12:32:55.42 +0800 CST | 2019-01-10 12:32:56.24 +0800 CST | synced |
| 38 | test | t1 | create table | public | 32 | 37 | 0 | 2019-01-10 12:32:41.956 +0800 CST | 2019-01-10 12:32:43.956 +0800 CST | synced |
| 36 | test | | drop table | none | 32 | 34 | 0 | 2019-01-10 11:29:59.982 +0800 CST | 2019-01-10 11:30:00.45 +0800 CST | synced |
| 35 | test | | create table | public | 32 | 34 | 0 | 2019-01-10 11:29:40.741 +0800 CST | 2019-01-10 11:29:41.682 +0800 CST | synced |
| 33 | test | | create schema | public | 32 | 0 | 0 | 2019-01-10 11:29:22.813 +0800 CST | 2019-01-10 11:29:23.954 +0800 CST | synced |
+--------+---------+------------+---------------------+----------------+-----------+----------+-----------+-----------------------------------+-----------------------------------+---------------+
次のコマンドを実行して、現在実行中の DDL ジョブ キューで完了した最後の 5 つの DDL ジョブを表示します。
ADMIN SHOW DDL JOBS 5;
+--------+---------+------------+---------------------+----------------+-----------+----------+-----------+-----------------------------------+-----------------------------------+---------------+
| JOB_ID | DB_NAME | TABLE_NAME | JOB_TYPE | SCHEMA_STATE | SCHEMA_ID | TABLE_ID | ROW_COUNT | START_TIME | END_TIME | STATE |
+--------+---------+------------+---------------------+----------------+-----------+----------+-----------+-----------------------------------+-----------------------------------+---------------+
| 45 | test | t1 | add index | write reorganization | 32 | 37 | 0 | 2019-01-10 12:38:36.501 +0800 CST | | running |
| 44 | test | t1 | add index | none | 32 | 37 | 0 | 2019-01-10 12:36:55.18 +0800 CST | 2019-01-10 12:36:55.852 +0800 CST | rollback done |
| 43 | test | t1 | add index | public | 32 | 37 | 6 | 2019-01-10 12:35:13.66 +0800 CST | 2019-01-10 12:35:14.925 +0800 CST | synced |
| 42 | test | t1 | drop index | none | 32 | 37 | 0 | 2019-01-10 12:34:35.204 +0800 CST | 2019-01-10 12:34:36.958 +0800 CST | synced |
| 41 | test | t1 | add index | public | 32 | 37 | 0 | 2019-01-10 12:33:22.62 +0800 CST | 2019-01-10 12:33:24.625 +0800 CST | synced |
| 40 | test | t1 | drop column | none | 32 | 37 | 0 | 2019-01-10 12:33:08.212 +0800 CST | 2019-01-10 12:33:09.78 +0800 CST | synced |
+--------+---------+------------+---------------------+----------------+-----------+----------+-----------+-----------------------------------+-----------------------------------+---------------+
次のコマンドを実行して、テスト データベース内の未完了の DDL ジョブを表示します。結果には、実行中の DDL ジョブと、完了したが失敗した最後の 5 つの DDL ジョブが含まれます。
ADMIN SHOW DDL JOBS 5 WHERE state != 'synced' AND db_name = 'test';
+--------+---------+------------+---------------------+----------------+-----------+----------+-----------+-----------------------------------+-----------------------------------+---------------+
| JOB_ID | DB_NAME | TABLE_NAME | JOB_TYPE | SCHEMA_STATE | SCHEMA_ID | TABLE_ID | ROW_COUNT | START_TIME | END_TIME | STATE |
+--------+---------+------------+---------------------+----------------+-----------+----------+-----------+-----------------------------------+-----------------------------------+---------------+
| 45 | test | t1 | add index | write reorganization | 32 | 37 | 0 | 2019-01-10 12:38:36.501 +0800 CST | | running |
| 44 | test | t1 | add index | none | 32 | 37 | 0 | 2019-01-10 12:36:55.18 +0800 CST | 2019-01-10 12:36:55.852 +0800 CST | rollback done |
+--------+---------+------------+---------------------+----------------+-----------+----------+-----------+-----------------------------------+-----------------------------------+---------------+
JOB_ID
: 各 DDL 操作は 1 つの DDL ジョブに対応します。JOB_ID
は世界的にユニークです。DB_NAME
: DDL 操作が実行されるデータベースの名前。TABLE_NAME
: DDL 操作が実行されるテーブルの名前。JOB_TYPE
: DDL 操作のタイプ。SCHEMA_STATE
: スキーマの現在の状態。JOB_TYPE
がadd index
の場合、それはインデックスの状態です。JOB_TYPE
がadd column
の場合、それは列の状態です。JOB_TYPE
がcreate table
の場合、それはテーブルの状態です。一般的な状態には次のものがあります。none
: 存在しないことを示します。drop
またはcreate
の操作が失敗してロールバックすると、通常はnone
の状態になります。delete only
、write only
、delete reorganization
、write reorganization
: これら 4 つの状態は中間状態です。これらの状態は、中間状態からの変換が非常に迅速であるため、一般的な操作では表示されません。write reorganization
の状態はadd index
の操作でのみ確認できます。これは、インデックス データが追加されていることを意味します。public
: 既存で使用可能であることを示します。create table
とadd index/column
のような操作が完了すると、通常はpublic
の状態になります。これは、作成されたテーブル/列/インデックスが正常に読み書きできるようになったことを意味します。
SCHEMA_ID
: DDL 操作が実行されるデータベースの ID。TABLE_ID
: DDL 操作が実行されるテーブルの ID。ROW_COUNT
:add index
操作の実行時に追加されたデータ行の数。START_TIME
: DDL 操作の開始時刻。END_TIME
: DDL 操作の終了時刻。STATE
: DDL 操作の状態。一般的な状態には次のものがあります。none
: 操作タスクが DDL ジョブ キューに入れられましたが、前のタスクが完了するのを待っているため、まだ実行されていないことを示します。もう 1 つの理由は、ドロップ操作を実行した後にnone
の状態になる可能性がありますが、すぐにsynced
の状態に更新されます。これは、すべての TiDB インスタンスがこの状態に同期されたことを意味します。running
: 操作が実行されていることを示します。synced
: 操作が正常に実行され、すべての TiDB インスタンスがこの状態に同期されたことを示します。rollback done
: 操作が失敗し、ロールバックが完了したことを示します。rollingback
: 操作が失敗し、ロールバックしていることを示します。cancelling
: 操作がキャンセル中であることを示します。この状態は、ADMIN CANCEL DDL JOBS
コマンドを使用して DDL ジョブをキャンセルした場合にのみ発生します。
MySQL の互換性
このステートメントは、MySQL 構文に対する TiDB 拡張です。