TiDB固有の機能
次の関数はTiDB拡張機能であり、MySQLにはありません。
関数名 | 機能の説明 |
---|---|
TIDB_BOUNDED_STALENESS() | TIDB_BOUNDED_STALENESS 関数は、時間範囲内で可能な限り新しいデータを読み取るようにTiDBに指示します。参照: AS OF TIMESTAMP 句を使用して履歴データを読み取る |
TIDB_DECODE_KEY(str) | TIDB_DECODE_KEY 関数を使用して、TiDBでエンコードされたキーエントリを_tidb_rowid とtable_id を含むJSON構造にデコードできます。これらのエンコードされたキーは、一部のシステムテーブルとログ出力にあります。 |
TIDB_DECODE_PLAN(str) | TIDB_DECODE_PLAN 関数は、TiDB実行プランをデコードするために使用できます。 |
TIDB_IS_DDL_OWNER() | TIDB_IS_DDL_OWNER 関数を使用して、接続しているTiDBインスタンスがDDL所有者であるかどうかを確認できます。 DDL所有者は、クラスタの他のすべてのノードに代わってDDLステートメントを実行するタスクを実行するTiDBインスタンスです。 |
TIDB_PARSE_TSO(num) | TIDB_PARSE_TSO 関数を使用して、TiDBTSOタイムスタンプから物理タイムスタンプを抽出できます。参照: tidb_current_ts 。 |
TIDB_VERSION() | TIDB_VERSION 関数は、追加のビルド情報を含むTiDBバージョンを返します。 |
TIDB_DECODE_SQL_DIGESTS(digests, stmtTruncateLength) | TIDB_DECODE_SQL_DIGESTS() 関数は、クラスタのSQLダイジェストのセットに対応する正規化されたSQLステートメント(形式と引数のない形式)を照会するために使用されます。 |
VITESS_HASH(str) | VITESS_HASH 関数は、VitessのHASH 関数と互換性のある文字列のハッシュを返します。これは、Vitessからのデータ移行を支援することを目的としています。 |
例
このセクションでは、上記のいくつかの関数の例を示します。
TIDB_DECODE_KEY
次の例では、テーブルt1
にTiDBによって生成された非表示のrowid
があります。ステートメントではTIDB_DECODE_KEY
が使用されています。結果から、非表示のrowid
がデコードされて出力されていることがわかります。これは、クラスター化されていない主キーの一般的な結果です。
SELECT START_KEY, TIDB_DECODE_KEY(START_KEY) FROM information_schema.tikv_region_status WHERE table_name='t1' AND REGION_ID=2\G
*************************** 1. row ***************************
START_KEY: 7480000000000000FF3B5F728000000000FF1DE3F10000000000FA
TIDB_DECODE_KEY(START_KEY): {"_tidb_rowid":1958897,"table_id":"59"}
1 row in set (0.00 sec)
次の例では、表t2
に複合クラスター主キーがあります。 JSON出力から、主キーの一部である両方の列の名前と値を含むhandle
を確認できます。
show create table t2\G
*************************** 1. row ***************************
Table: t2
Create Table: CREATE TABLE `t2` (
`id` binary(36) NOT NULL,
`a` tinyint(3) unsigned NOT NULL,
`v` varchar(512) DEFAULT NULL,
PRIMARY KEY (`a`,`id`) /*T![clustered_index] CLUSTERED */
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin
1 row in set (0.001 sec)
select * from information_schema.tikv_region_status where table_name='t2' limit 1\G
*************************** 1. row ***************************
REGION_ID: 48
START_KEY: 7480000000000000FF3E5F720400000000FF0000000601633430FF3338646232FF2D64FF3531632D3131FF65FF622D386337352DFFFF3830653635303138FFFF61396265000000FF00FB000000000000F9
END_KEY:
TABLE_ID: 62
DB_NAME: test
TABLE_NAME: t2
IS_INDEX: 0
INDEX_ID: NULL
INDEX_NAME: NULL
EPOCH_CONF_VER: 1
EPOCH_VERSION: 38
WRITTEN_BYTES: 0
READ_BYTES: 0
APPROXIMATE_SIZE: 136
APPROXIMATE_KEYS: 479905
REPLICATIONSTATUS_STATE: NULL
REPLICATIONSTATUS_STATEID: NULL
1 row in set (0.005 sec)
select tidb_decode_key('7480000000000000FF3E5F720400000000FF0000000601633430FF3338646232FF2D64FF3531632D3131FF65FF622D386337352DFFFF3830653635303138FFFF61396265000000FF00FB000000000000F9');
+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| tidb_decode_key('7480000000000000FF3E5F720400000000FF0000000601633430FF3338646232FF2D64FF3531632D3131FF65FF622D386337352DFFFF3830653635303138FFFF61396265000000FF00FB000000000000F9') |
+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| {"handle":{"a":"6","id":"c4038db2-d51c-11eb-8c75-80e65018a9be"},"table_id":62} |
+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
1 row in set (0.001 sec)
TIDB_DECODE_PLAN
遅いクエリログで、エンコードされた形式のTiDB実行プランを見つけることができます。次に、 TIDB_DECODE_PLAN()
関数を使用して、エンコードされた計画を人間が読める形式にデコードします。
この関数は、ステートメントの実行時にプランがキャプチャされるため便利です。 EXPLAIN
でステートメントを再実行すると、データの分散と統計が時間の経過とともに変化するため、異なる結果が生成される可能性があります。
SELECT tidb_decode_plan('8QIYMAkzMV83CQEH8E85LjA0CWRhdGE6U2VsZWN0aW9uXzYJOTYwCXRpbWU6NzEzLjHCtXMsIGxvb3BzOjIsIGNvcF90YXNrOiB7bnVtOiAxLCBtYXg6IDU2OC41wgErRHByb2Nfa2V5czogMCwgcnBjXxEpAQwFWBAgNTQ5LglZyGNvcHJfY2FjaGVfaGl0X3JhdGlvOiAwLjAwfQkzLjk5IEtCCU4vQQoxCTFfNgkxXzAJMwm2SGx0KHRlc3QudC5hLCAxMDAwMCkNuQRrdgmiAHsFbBQzMTMuOMIBmQnEDDk2MH0BUgEEGAoyCTQzXzUFVwX1oGFibGU6dCwga2VlcCBvcmRlcjpmYWxzZSwgc3RhdHM6cHNldWRvCTk2ISE2aAAIMTUzXmYA')\G
*************************** 1. row ***************************
tidb_decode_plan('8QIYMAkzMV83CQEH8E85LjA0CWRhdGE6U2VsZWN0aW9uXzYJOTYwCXRpbWU6NzEzLjHCtXMsIGxvb3BzOjIsIGNvcF90YXNrOiB7bnVtOiAxLCBtYXg6IDU2OC41wgErRHByb2Nfa2V5czogMCwgcnBjXxEpAQwFWBAgNTQ5LglZyGNvcHJfY2FjaGVfaGl0X3JhdGlvOiAwLjAwfQkzLjk5IEtCCU4vQQoxCTFfNgkxXz: id task estRows operator info actRows execution info memory disk
TableReader_7 root 319.04 data:Selection_6 960 time:713.1µs, loops:2, cop_task: {num: 1, max: 568.5µs, proc_keys: 0, rpc_num: 1, rpc_time: 549.1µs, copr_cache_hit_ratio: 0.00} 3.99 KB N/A
└─Selection_6 cop[tikv] 319.04 lt(test.t.a, 10000) 960 tikv_task:{time:313.8µs, loops:960} N/A N/A
└─TableFullScan_5 cop[tikv] 960 table:t, keep order:false, stats:pseudo 960 tikv_task:{time:153µs, loops:960} N/A N/A
TIDB_PARSE_TSO
TIDB_PARSE_TSO
関数を使用して、TiDBTSOタイムスタンプから物理タイムスタンプを抽出できます。 TSOはTimeStampOracleの略で、トランザクションごとにPD(Placement Driver)によって与えられる単調に増加するタイムスタンプです。
TSOは、次の2つの部分で構成される数値です。
- 物理的なタイムスタンプ
- 論理カウンター
BEGIN;
SELECT TIDB_PARSE_TSO(@@tidb_current_ts);
ROLLBACK;
+-----------------------------------+
| TIDB_PARSE_TSO(@@tidb_current_ts) |
+-----------------------------------+
| 2021-05-26 11:33:37.776000 |
+-----------------------------------+
1 row in set (0.0012 sec)
ここでTIDB_PARSE_TSO
は、 tidb_current_ts
セッション変数で使用可能なタイムスタンプ番号から物理タイムスタンプを抽出するために使用されます。タイムスタンプはトランザクションごとに与えられるため、この関数はトランザクションで実行されます。
TIDB_VERSION
TIDB_VERSION
関数を使用して、接続しているTiDBサーバーのバージョンとビルドの詳細を取得できます。この関数は、GitHubで問題を報告するときに使用できます。
SELECT TIDB_VERSION()\G
*************************** 1. row ***************************
TIDB_VERSION(): Release Version: v5.1.0-alpha-13-gd5e0ed0aa-dirty
Edition: Community
Git Commit Hash: d5e0ed0aaed72d2f2dfe24e9deec31cb6cb5fdf0
Git Branch: master
UTC Build Time: 2021-05-24 14:39:20
GoVersion: go1.13
Race Enabled: false
TiKV Min Version: v3.0.0-60965b006877ca7234adaced7890d7b029ed1306
Check Table Before Drop: false
1 row in set (0.00 sec)
TIDB_DECODE_SQL_DIGESTS
TIDB_DECODE_SQL_DIGESTS()
関数は、クラスタのSQLダイジェストのセットに対応する正規化されたSQLステートメント(形式と引数のない形式)を照会するために使用されます。この関数は、1つまたは2つの引数を受け入れます。
digests
:文字列。このパラメーターはJSON文字列配列の形式であり、配列内の各文字列はSQLダイジェストです。stmtTruncateLength
:整数(オプション)。これは、返される結果の各SQLステートメントの長さを制限するために使用されます。 SQLステートメントが指定された長さを超える場合、ステートメントは切り捨てられます。0
は、長さが無制限であることを意味します。
この関数は、JSON文字列配列の形式の文字列を返します。配列のi番目の項目は、 digests
パラメーターのi番目の要素に対応する正規化されたSQLステートメントです。 digests
パラメーターの要素が有効なSQLダイジェストではない場合、またはシステムが対応するSQLステートメントを見つけることができない場合、返される結果の対応する項目はnull
です。切り捨ての長さが指定されている場合( stmtTruncateLength > 0
)、この長さを超える結果の各ステートメントについて、最初のstmtTruncateLength
文字が保持され、末尾に接尾辞"..."
が追加されて切り捨てを示します。 digests
パラメータがNULL
の場合、関数の戻り値はNULL
です。
ノート:
- この機能を使用できるのは、 処理するの権限を持つユーザーのみです。
TIDB_DECODE_SQL_DIGESTS
が実行されると、TiDBはステートメントサマリーテーブルから各SQLダイジェストに対応するステートメントをクエリするため、対応するステートメントがどのSQLダイジェストでも常に検出される保証はありません。クラスタで実行されたステートメントのみを見つけることができ、これらのSQLステートメントを照会できるかどうかは、ステートメント要約テーブルの関連する構成によっても影響を受けます。ステートメント要約テーブルの詳細な説明については、 ステートメント要約表を参照してください。- この関数はオーバーヘッドが高くなります。行数が多いクエリ(たとえば、大規模でビジーなクラスタで
information_schema.cluster_tidb_trx
のテーブル全体をクエリする)では、この関数を使用すると、クエリの実行時間が長すぎる可能性があります。注意して使用してください。
- この関数は、呼び出されるたびに
STATEMENTS_SUMMARY
、およびSTATEMENTS_SUMMARY_HISTORY
テーブルを内部的にクエリし、クエリにはCLUSTER_STATEMENTS_SUMMARY
操作が含まれるため、オーバーヘッドが高くUNION
CLUSTER_STATEMENTS_SUMMARY_HISTORY
。この関数は現在、ベクトル化をサポートしていません。つまり、データの複数の行に対してこの関数を呼び出す場合、上記のクエリは行ごとに個別に実行されます。
set @digests = '["e6f07d43b5c21db0fbb9a31feac2dc599787763393dd5acbfad80e247eb02ad5","38b03afa5debbdf0326a014dbe5012a62c51957f1982b3093e748460f8b00821","e5796985ccafe2f71126ed6c0ac939ffa015a8c0744a24b7aee6d587103fd2f7"]';
select tidb_decode_sql_digests(@digests);
+------------------------------------+
| tidb_decode_sql_digests(@digests) |
+------------------------------------+
| ["begin",null,"select * from `t`"] |
+------------------------------------+
1 row in set (0.00 sec)
上記の例では、パラメーターは3つのSQLダイジェストを含むJSON配列であり、対応するSQLステートメントはクエリ結果の3つの項目です。ただし、2番目のSQLダイジェストに対応するSQLステートメントがクラスタから見つからないため、結果の2番目の項目はnull
です。
select tidb_decode_sql_digests(@digests, 10);
+---------------------------------------+
| tidb_decode_sql_digests(@digests, 10) |
+---------------------------------------+
| ["begin",null,"select * f..."] |
+---------------------------------------+
1 row in set (0.01 sec)
上記の呼び出しは、2番目のパラメーター(つまり、切り捨ての長さ)を10として指定し、クエリ結果の3番目のステートメントの長さは10より大きいため、最初の10文字のみが保持され、 "..."
が追加されます。 end、これは切り捨てを示します。
参照: