TiDB Cloud
TiDB Self-Managed
Learning Center
お問い合わせ

メタデータロック

このドキュメントでは、TiDB のメタデータ ロックについて説明します。

コンセプト

TiDB は、オンライン非同期スキーマ変更アルゴリズムを使用して、メタデータ オブジェクトの変更をサポートします。トランザクションが実行されると、トランザクションの開始時に対応するメタデータ スナップショットが取得されます。トランザクション中にメタデータが変更された場合、データの一貫性を確保するために、TiDB はInformation schema is changedエラーを返し、トランザクションはコミットに失敗します。

この問題を解決するために、TiDB v6.3.0 では、オンライン DDL アルゴリズムにメタデータ ロックが導入されています。ほとんどの DML エラーを回避するために、TiDB はテーブル メタデータの変更中に DML と DDL の優先順位を調整し、実行中の DDL が古いメタデータを持つ DML がコミットされるまで待機するようにします。

シナリオ

TiDB のメタデータ ロックは、次のようなすべての DDL ステートメントに適用されます。

メタデータ ロックを有効にすると、TiDB での DDL タスクの実行にパフォーマンス上の影響が出る可能性があります。影響を軽減するために、メタデータ ロックを必要としないシナリオをいくつか次に示します。

  • 自動コミットが有効になっているクエリはSELECTです
  • ステイル読み取りが有効になっています
  • 一時テーブルにアクセスする

使用法

v6.5.0 以降、TiDB はデフォルトでメタデータ ロックを有効にします。既存のクラスターを v6.4.0 以前から v6.5.0 以降にアップグレードすると、TiDB はメタデータ ロックを自動的に有効にします。メタデータ ロックを無効にするには、システム変数tidb_enable_metadata_lockをOFFに設定します。

インパクト

  • DML の場合、メタデータ ロックは実行をブロックせず、デッドロックも発生しません。

  • メタデータ ロックを有効にすると、トランザクション内のメタデータ オブジェクトの情報は最初のアクセス時に決定され、その後は変更されません。

  • DDL の場合、メタデータの状態を変更すると、古いトランザクションによって DDL がブロックされる可能性があります。次に例を示します。

    セッション 1セッション2
    CREATE TABLE t (a INT);
    INSERT INTO t VALUES(1);
    BEGIN;
    ALTER TABLE t ADD COLUMN b INT;
    SELECT * FROM t;
    (テーブルtの現在のメタデータ バージョンを使用します(a=1, b=NULL)を返し、テーブルtをロックします。)
    ALTER TABLE t ADD COLUMN c INT; (セッション 1 によってブロックされています)

    繰り返し読み取り分離レベルでは、トランザクションの開始からテーブルのメタデータを決定する時点までの間に、インデックスの追加や列タイプの変更など、データの変更を必要とする DDL が実行されると、DDL は次のようにエラーを返します。

    セッション 1セッション2
    CREATE TABLE t (a INT);
    INSERT INTO t VALUES(1);
    BEGIN;
    ALTER TABLE t ADD INDEX idx(a);
    SELECT * FROM t; (インデックスidxは使用できません)
    COMMIT;
    BEGIN;
    ALTER TABLE t MODIFY COLUMN a CHAR(10);
    SELECT * FROM t; ( ERROR 8028 (HY000): public column a has changedを返す)

可観測性

TiDB v6.3.0 では、現在ブロックされている DDL の情報を取得するのに役立つmysql.tidb_mdl_viewビューが導入されています。

注記：

mysql.tidb_mdl_viewビューを選択するには、 PROCESS権限が必要です。

以下は、テーブルtにインデックスを追加する例です。DDL ステートメントALTER TABLE t ADD INDEX idx(a)があると仮定します。

SELECT * FROM mysql.tidb_mdl_view\G
*************************** 1. row ***************************
    JOB_ID: 141
   DB_NAME: test
TABLE_NAME: t
     QUERY: ALTER TABLE t ADD INDEX idx(a)
SESSION ID: 2199023255957
  TxnStart: 08-30 16:35:41.313(435643624013955072)
SQL_DIGESTS: ["begin","select * from `t`"]
1 row in set (0.02 sec)

上記の出力から、 SESSION IDが2199023255957であるトランザクションがADD INDEX DDL をブロックしていることがわかります。 SQL_DIGEST 、このトランザクションによって実行された SQL ステートメント ( ["begin","select * from `t`"]を示しています。ブロックされた DDL の実行を継続するには、次のグローバルKILLステートメントを使用して2199023255957トランザクションを強制終了します。

mysql> KILL 2199023255957;
Query OK, 0 rows affected (0.00 sec)

トランザクションを強制終了した後、 mysql.tidb_mdl_viewビューを再度選択できます。この時点で、前のトランザクションは出力に表示されません。これは、DDL がブロックされていないことを意味します。

SELECT * FROM mysql.tidb_mdl_view\G
Empty set (0.01 sec)

原則

問題の説明

TiDB の DDL 操作はオンライン DDL モードです。DDL ステートメントが実行されると、変更対象の定義済みオブジェクトのメタデータ バージョンは、複数のマイナー バージョン変更を経る可能性があります。オンライン非同期メタデータ変更アルゴリズムは、隣接する 2 つのマイナー バージョンに互換性があることのみを確立します。つまり、2 つのバージョン間の操作によって、DDL によって変更されるオブジェクトのデータ整合性が損なわれることはありません。

テーブルにインデックスを追加すると、DDL ステートメントの状態は次のように変わります: なし -> 削除のみ、削除のみ -> 書き込みのみ、書き込みのみ -> 書き込み再編成、書き込み再編成 -> パブリック。

次のトランザクションのコミット プロセスは、前述の制約に違反します。

トランザクショントランザクションで使用されるバージョンクラスター内の最新バージョンバージョンの違い
txn1なしなし0
txn2削除のみ削除のみ0
txn3書き込み専用書き込み専用0
txn4なし書き込み専用2
txn5書き込み再編成書き込み再編成0
翻訳書き込み専用書き込み再編成1
txn7公共公共0

上の表では、 txn4がコミットされたときに使用されるメタデータ バージョンは、クラスター内の最新バージョンとは 2 バージョン異なります。これにより、データの不整合が発生する可能性があります。

実装の詳細

メタデータ ロックにより、TiDB クラスター内のすべてのトランザクションで使用されるメタデータ バージョンが最大 1 バージョンしか異ならないことが保証されます。この目標を達成するために、TiDB は次の 2 つのルールを実装します。

  • DML を実行すると、TiDB は、テーブル、ビュー、対応するメタデータ バージョンなど、トランザクション コンテキストで DML によってアクセスされたメタデータ オブジェクトを記録します。これらのレコードは、トランザクションがコミットされるとクリーンアップされます。
  • DDL ステートメントの状態が変化すると、最新バージョンのメタデータがすべての TiDB ノードにプッシュされます。TiDB ノード上のこの状態変化に関連するすべてのトランザクションで使用されるメタデータ バージョンと現在のメタデータ バージョンの差が 2 未満の場合、TiDB ノードはメタデータ オブジェクトのメタデータ ロックを取得したと見なされます。次の状態変化は、クラスター内のすべての TiDB ノードがメタデータ オブジェクトのメタデータ ロックを取得した後にのみ実行できます。

このページは役に立ちましたか？