📣
TiDB Cloud Serverless が
Starter
に変わりました！このページは自動翻訳されたものです。
原文はこちらからご覧ください。
TiDB Cloud
TiDB Self-Managed
Learning Center
お問い合わせ

MariaDBからTiDBへのデータ移行

このドキュメントでは、MariaDBサーバーインストールから TiDB クラスターにデータを移行する方法について説明します。

前提条件

適切な移行戦略を選択してください。

これら2つの戦略以外にも、あなたの状況に合った戦略が他にもあるかもしれません。例えば：

  • オブジェクト リレーショナル マッピング (ORM) の機能を使用して、データを再デプロイおよび移行します。
  • 移行の進行中に MariaDB と TiDB の両方から書き込むようにアプリケーションを変更します。

このドキュメントでは、最初の 2 つの戦略についてのみ説明します。

選択した戦略に基づいて、次のものを準備します。

  • ダンプと復元の戦略の場合:
    • DumplingとTiDB Lightningインストールします。
    • Dumpling がデータをエクスポートするには、MariaDBサーバーに必要な権限あることを確認してください。
  • データ複製戦略については、 データ移行（DM）設定します。

互換性を確認する

TiDBはMySQLと互換性ありあり、MySQLとMariaDBには多くの共通機能があります。ただし、MariaDB固有の機能の中にはTiDBと互換性がないものもあるため、移行前に注意が必要です。

このセクションの項目を確認するだけでなく、MariaDB ドキュメントの互換性と相違点も確認することをお勧めします。

認証

MySQLとのSecurity互換性ドキュメントでは、TiDB がサポートする認証方法をリストしています。TiDB は MariaDB のいくつかの認証方法をサポートしていません。つまり、アカウントに新しいパスワードハッシュを作成するか、その他の特別な対策を講じる必要がある可能性があります。

使用されている認証方法を確認するには、次のステートメントを実行します。

SELECT
  plugin,
  COUNT(*)
FROM
  mysql.user
GROUP BY
  plugin;

+-----------------------+----------+
| plugin                | COUNT(*) |
+-----------------------+----------+
| mysql_native_password |       11 |
+-----------------------+----------+
1 row in set (0.002 sec)

システムバージョン管理されたテーブル

TiDBはシステムバージョン管理されたテーブルサポートしていません。ただし、TiDBはAS OF TIMESTAMPサポートしており、システムバージョン管理されたテーブルのユースケースの一部を置き換える可能性があります。

次のステートメントを使用して、影響を受けるテーブルを確認できます。

SELECT
  TABLE_SCHEMA,
  TABLE_NAME
FROM
  information_schema.tables
WHERE
  TABLE_TYPE='SYSTEM VERSIONED';

+--------------+------------+
| TABLE_SCHEMA | TABLE_NAME |
+--------------+------------+
| test         | t          |
+--------------+------------+
1 row in set (0.005 sec)

システムのバージョン管理を削除するには、次のALTER TABLEステートメントを実行します。

MariaDB [test]> ALTER TABLE t DROP SYSTEM VERSIONING;
Query OK, 0 rows affected (0.071 sec)
Records: 0  Duplicates: 0  Warnings: 0

シーケンス

MariaDBとTiDBはどちらもCREATE SEQUENCEサポートしています。ただし、現在DMではサポートされていません。移行中はシーケンスの作成、変更、削除を行わず、移行後に特にこの点をテストすることをお勧めします。

シーケンスを使用しているかどうかを確認するには、次のステートメントを実行します。

SELECT
  TABLE_SCHEMA,
  TABLE_NAME
FROM
  information_schema.tables
WHERE
  TABLE_TYPE='SEQUENCE';

+--------------+------------+
| TABLE_SCHEMA | TABLE_NAME |
+--------------+------------+
| test         | s1         |
+--------------+------------+
1 row in set (0.016 sec)

ストレージエンジン

MariaDBは、 InnoDBといったローカルデータ用のstorageエンジンを提供しています。 Aria MyISAMデータ形式はTiDBでは直接サポートされていませんが、これらの移行は問題なく行えます。ただし、 CONNECTstorageエンジンやSpiderなど、一部のエンジンはデータをサーバーの外部に配置します。このようなテーブルをTiDBに移行することは可能ですが、TiDBはTiDBクラスターの外部にデータを保存する機能を提供していません。

使用しているstorageエンジンを確認するには、次のステートメントを実行します。

SELECT
  ENGINE,
  COUNT(*)
FROM
  information_schema.tables
GROUP BY
  ENGINE;

+--------------------+----------+
| ENGINE             | COUNT(*) |
+--------------------+----------+
| NULL               |      101 |
| Aria               |       38 |
| CSV                |        2 |
| InnoDB             |        6 |
| MEMORY             |       67 |
| MyISAM             |        1 |
| PERFORMANCE_SCHEMA |       81 |
+--------------------+----------+
7 rows in set (0.009 sec)

構文

MariaDBは、 DELETE 、 INSERT 、 REPLACEステートメントでRETURNINGキーワードをサポートしています。TiDBはこれらのステートメントをサポートしていません。移行に影響があるかどうかを確認するには、アプリケーションとクエリのログを確認することをお勧めします。

データ型

MariaDB は、 UUID 、 INET4 、 INET6など、TiDB がサポートしていないいくつかのデータ型をサポートしています。

これらのデータ型を確認するには、次のステートメントを実行します。

SELECT
  TABLE_SCHEMA,
  TABLE_NAME,
  COLUMN_NAME,
  DATA_TYPE
FROM
  information_schema.columns
WHERE
  DATA_TYPE IN('INET4','INET6','UUID');

+--------------+------------+-------------+-----------+
| TABLE_SCHEMA | TABLE_NAME | COLUMN_NAME | DATA_TYPE |
+--------------+------------+-------------+-----------+
| test         | u1         | u           | uuid      |
| test         | u1         | i4          | inet4     |
| test         | u1         | i6          | inet6     |
+--------------+------------+-------------+-----------+
3 rows in set (0.026 sec)

文字セットと照合順序

TiDB は、MariaDB でよく使用されるlatin1_swedish_ci照合順序をサポートしていません。

TiDB がサポートする照合順序を確認するには、TiDB で次のステートメントを実行します。

SHOW COLLATION;

+--------------------+---------+-----+---------+----------+---------+---------------+
| Collation          | Charset | Id  | Default | Compiled | Sortlen | Pad_attribute |
+--------------------+---------+-----+---------+----------+---------+---------------+
| ascii_bin          | ascii   |  65 | Yes     | Yes      |       1 | PAD SPACE     |
| binary             | binary  |  63 | Yes     | Yes      |       1 | NO PAD        |
| gbk_bin            | gbk     |  87 |         | Yes      |       1 | PAD SPACE     |
| gbk_chinese_ci     | gbk     |  28 | Yes     | Yes      |       1 | PAD SPACE     |
| latin1_bin         | latin1  |  47 | Yes     | Yes      |       1 | PAD SPACE     |
| utf8_bin           | utf8    |  83 | Yes     | Yes      |       1 | PAD SPACE     |
| utf8_general_ci    | utf8    |  33 |         | Yes      |       1 | PAD SPACE     |
| utf8_unicode_ci    | utf8    | 192 |         | Yes      |       8 | PAD SPACE     |
| utf8mb4_0900_ai_ci | utf8mb4 | 255 |         | Yes      |       0 | NO PAD        |
| utf8mb4_0900_bin   | utf8mb4 | 309 |         | Yes      |       1 | NO PAD        |
| utf8mb4_bin        | utf8mb4 |  46 | Yes     | Yes      |       1 | PAD SPACE     |
| utf8mb4_general_ci | utf8mb4 |  45 |         | Yes      |       1 | PAD SPACE     |
| utf8mb4_unicode_ci | utf8mb4 | 224 |         | Yes      |       8 | PAD SPACE     |
+--------------------+---------+-----+---------+----------+---------+---------------+
13 rows in set (0.00 sec)

現在のテーブルの列が使用している照合順序を確認するには、次のステートメントを使用できます。

SELECT
  TABLE_SCHEMA,
  COLLATION_NAME,
  COUNT(*)
FROM
  information_schema.columns
GROUP BY
  TABLE_SCHEMA, COLLATION_NAME
ORDER BY
  COLLATION_NAME;

+--------------------+--------------------+----------+
| TABLE_SCHEMA       | COLLATION_NAME     | COUNT(*) |
+--------------------+--------------------+----------+
| sys                | NULL               |      562 |
| test               | NULL               |       14 |
| mysql              | NULL               |       84 |
| performance_schema | NULL               |      892 |
| information_schema | NULL               |      421 |
| mysql              | latin1_swedish_ci  |       34 |
| performance_schema | utf8mb3_bin        |       38 |
| mysql              | utf8mb3_bin        |       61 |
| sys                | utf8mb3_bin        |       40 |
| information_schema | utf8mb3_general_ci |      375 |
| performance_schema | utf8mb3_general_ci |      244 |
| sys                | utf8mb3_general_ci |      386 |
| mysql              | utf8mb3_general_ci |       67 |
| mysql              | utf8mb4_bin        |        8 |
+--------------------+--------------------+----------+
14 rows in set (0.045 sec)

文字セットと照合順序も参照してください。

Dumplingでデータをダンプし、 TiDB Lightningでデータを復元する

この方法では、アプリケーションをオフラインにしてデータを移行し、移行したデータを使用するようにアプリケーションを再構成することを前提としています。

注記：

本番本番で実行する前に、アプリケーションのテストインスタンスまたは開発インスタンスでこの作業を実行することを強くお勧めします。これは、互換性の問題が発生する可能性を確認するためと、移行にかかる時間を把握するためです。

MariaDB から TiDB にデータを移行するには、次の手順を実行します。

  1. アプリケーションを停止します。アプリケーションをオフラインにします。これにより、移行中および移行後にMariaDBのデータが変更されないことが保証されます。

  2. tiup dumplingコマンドで MariaDB にデータをダンプします。

    tiup dumpling --port 3306 --host 127.0.0.1 --user root --password secret -F 256MB  -o /data/backup

  3. tiup tidb-lightningコマンドを使用してデータを復元します。TiDB TiDB Lightning の設定方法と実行方法の詳細については、 TiDB Lightningを使い始める参照してください。

  4. ユーザーアカウントと権限を移行します。ユーザーと権限の移行方法の詳細については、 ユーザーと権限をエクスポートする参照してください。

  5. アプリケーションを再設定してください。TiDBサーバーに接続できるように、アプリケーションの設定を変更する必要があります。

  6. クリーンアップ。移行が成功したことを確認したら、MariaDBのデータの最終バックアップを作成し、サーバーを停止します。これにより、 TiUP、 Dumpling、 TiDB Lightningなどのツールも削除できます。

DMでデータを複製する

この方法では、レプリケーションを設定し、アプリケーションを停止してレプリケーションが追いつくまで待機し、その後、TiDB を使用するようにアプリケーションを再構成することを前提としています。

DMを使用するには、 TiUPクラスターまたはTiDB Operatorを使用してDMサービスのセットをデプロイする必要があります。その後、 dmctl使用してDMサービスを設定します。

注記：

本番本番で実行する前に、アプリケーションのテストインスタンスまたは開発インスタンスでこの作業を実行することを強くお勧めします。これは、互換性の問題が発生する可能性を確認するためと、移行にかかる時間を把握するためです。

ステップ1.準備

MariaDBでbinlogsが有効になっていること、およびbinlog_format ROWに設定されていることを確認してください。5とbinlog_annotate_row_events=OFF log_bin_compress=OFF設定することも推奨されます。

また、権限SUPER 、または権限BINLOG MONITORと権限REPLICATION MASTER ADMINを持つアカウントも必要です。このアカウントには、移行するスキーマに対する読み取り権限も必要です。

SUPER権限を持つアカウントを使用していない場合は、TiDB が MariaDB 固有の権限を確認する方法をまだ知らないため、DM 構成に以下を追加する必要がある可能性があります。

ignore-checking-items: ["replication_privilege"]

DMを使用して上流から下流へデータを移行する前に、事前チェックを行うことで上流データベース構成のエラーを検出し、移行がスムーズに進むようにします。詳細については、 移行タスクの事前チェック参照してください。

ステップ2. データを複製する

TiDB データ移行のクイックスタートガイドに従って、MariaDB から TiDB にデータを複製します。

MariaDB から MariaDB へのレプリケーションの場合のように、最初に初期データをコピーする必要はないことに注意してください。DM が自動的にこれを実行します。

ステップ3. ユーザーアカウントと権限を移行する

ユーザーと権限の移行方法については、 ユーザーと権限をエクスポートする参照してください。

ステップ4. データをテストする

データが複製されたら、読み取り専用クエリを実行して検証できます。詳細については、 アプリケーションをテストする参照してください。

ステップ5. 切り替える

TiDB に切り替えるには、次の手順を実行する必要があります。

  1. アプリケーションを停止します。
  2. レプリケーションの遅延を監視します。0 秒になるはずです。
  3. アプリケーションの構成を TiDB に接続するように変更し、再度起動します。

レプリケーションの遅延を確認するには、 query-status <taskname>からdmctl実行し、 subTaskStatusで"synced: true"を確認します。

ステップ6. クリーンアップ

移行が成功したことを確認したら、MariaDB のデータの最終バックアップを作成し、サーバーを停止します。これにより、DM クラスターを停止して削除することもできます。

ユーザーと権限をエクスポートする

pt-show-grants使用できます。これは、MariaDB からユーザーと権限をエクスポートし、TiDB にロードするための Percona Toolkit の一部です。

アプリケーションをテストする

sysbenchような汎用ツールをテストに使用することも可能ですが、アプリケーションの特定の機能をテストすることを強くお勧めします。例えば、アプリケーションのコピーを、データの一時コピーを含む TiDB クラスターに対して実行します。

このようなテストを行うことで、アプリケーションとTiDBの互換性とパフォーマンスを検証できます。アプリケーションとTiDBのログファイルを監視して、対処が必要な警告がないか確認する必要があります。アプリケーションが使用しているデータベースドライバ（ Javaベースのアプリケーションの場合はMySQL Connector/Jなど）がテストされていることを確認してください。必要に応じて、JMeterなどのアプリケーションを使用してアプリケーションに負荷をかけることもできます。

データを検証する

同期差分インスペクター使用して、MariaDB と TiDB のデータが同じかどうかを検証できます。

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