PolarDB:使用ガイド

前提条件

• マルチマスタークラスター (無制限) エディションのクラスターを購入済みであること。 詳細については、「カスタム購入」および「サブスクリプションクラスターの購入」をご参照ください。

• 特権アカウントを作成済みであること。 詳細については、「特権アカウントの作成」をご参照ください。

• データベースクラスターに接続済みであること。 詳細については、「データベースクラスターへの接続」をご参照ください。

• マルチマスタークラスター (無制限) エディションは PolarDB for MySQL 8.0 でサポートされています。

制限事項

• 各データベースまたはデータオブジェクトのデータは、1 つのノードからのみ書き込むことができます。対応するデータベースまたはデータオブジェクトが割り当てられていないノードでは、データの読み取りまたは書き込みはできません。デフォルトでは、操作はデータベースレベルで実行されます。データオブジェクトレベルで操作を実行するには、指定された構文を使用して分離レベルを切り替える必要があります。

• RW ノード間のデータクエリはサポートされていません。クエリ SQL 文に複数の RW ノード上のデータベースまたはデータオブジェクトが含まれている場合、システムはエラーを報告します。このようなクエリを実行する前に、関連するすべてのデータベースまたはデータオブジェクトのエンドポイントを単一の RW ノードに移動する必要があります。

• クラスターエンドポイント () のみがサポートされ、プライマリエンドポイントはサポートされていません。

• エンドポイントの切り替えでは、次のモードがサポートされています:

  • データベース分離レベルでは、データベースエンドポイントを切り替えることができます。

  • データオブジェクト分離レベルでは、データオブジェクトのエンドポイントを切り替えることができます。

データベース作成時に RW ノードを指定する

CREATE DATABASE name [POLARDB_WRITE_NODE master_id];

CREATE DATABASE db1 POLARDB_WRITE_NODE 1;

指定した RW ノード上のデータベースを削除する

DROP DATABASE name;

DROP DATABASE db1;

データベースエンドポイントの切り替え

ALTER DATABASE name POLARDB_WRITE_NODE master_id;

ALTER DATABASE db1 POLARDB_WRITE_NODE 2;

データベース分離レベルからデータオブジェクト分離レベルへの切り替え

ALTER DATABASE name TO TABLE_LOCK POLARDB_WRITE_NODE master_id;

ALTER DATABASE db1 TO TABLE_LOCK POLARDB_WRITE_NODE 2;

データオブジェクト分離レベルからデータベース分離レベルへの切り替え

ALTER DATABASE name TO DB_LOCK POLARDB_WRITE_NODE master_id;

ALTER DATABASE db1 TO DB_LOCK POLARDB_WRITE_NODE 1;

データオブジェクトのエンドポイントの切り替え

ALTER obj_type name POLARDB_WRITE_NODE master_id;

ALTER TABLE db1.t1 POLARDB_WRITE_NODE 3;

ALTER VIEW t2 POLARDB_WRITE_NODE 2;

ALTER FUNCTION db2.f1, db2.f2 POLARDB_WRITE_NODE 1;

SQL 文の RW ノードを指定する

ALTER SESSION POLARDB_WRITE_NODE master_id;

ALTER SESSION POLARDB_WRITE_NODE 1;   # SQL 文を RW1 ノードに送信します。
SHOW VARIABLES LIKE 'innodb_buffer_pool_size';  # RW1 ノードで innodb_buffer_pool_size の値をクエリします。

RESET SESSION POLARDB_WRITE_NODE;

データベースの分散をクエリする

• PolarDB コンソールの [設定と管理] > [データベース管理] ページに移動して、クラスター内のすべてのデータベースの分散を表示できます。

• 次のコマンドを実行して、特定の RW ノード上のデータベースの分散をクエリできます:

  ALTER SESSION POLARDB_WRITE_NODE master_id;
  SELECT * FROM INFORMATION_SCHEMA.INNODB_MASTER_GLOBAL_LOCK_INFO WHERE LOCK_MODE = 'SLS_X';

  例: RW1 ノード上のデータベースの分散をクエリします。

  ALTER SESSION POLARDB_WRITE_NODE 1;
  SELECT * FROM INFORMATION_SCHEMA.INNODB_MASTER_GLOBAL_LOCK_INFO WHERE LOCK_MODE = 'SLS_X';

  クエリ結果は次のとおりです:

   SELECT * FROM INFORMATION_SCHEMA.INNODB_MASTER_GLOBAL_LOCK_INFO WHERE LOCK_MODE = 'SLS_X';
  
  +------------+---------------------+----------+--------------+-----------+----------+-------------+-------------+---------------------+-----------------+
  | table_name | table_id            | space_id | s_lock_count | lock_mode | object   | current_lsn | hold_thread | hold_start_time     | hold_total_time |
  +------------+---------------------+----------+--------------+-----------+----------+-------------+-------------+---------------------+-----------------+
  | test3/f1   | 9149389368458135753 |        0 |            0 | SLS_X     | function |    28076635 |          17 | 2024-07-10 21:35:20 |             214 |
  | test3/e1   | 9149389368458332874 |        0 |            0 | SLS_X     | event    |    28077248 |          17 | 2024-07-10 21:35:30 |             204 |
  | test3/v1   | 9149389368457234649 |        0 |            0 | SLS_X     | view     |    28075972 |          17 | 2024-07-10 21:35:08 |             226 |
  | sbtest     | 2107518311328629409 |        0 |            0 | SLS_X     | db       |    28034927 |  4294967295 | 2024-07-07 23:04:41 |          254053 |
  | test       | 7190879906290573778 |        0 |            0 | SLS_X     | db       |    28034927 |  4294967295 | 2024-07-10 11:20:57 |           37077 |
  | test2      | 3381728963524265351 |        0 |            0 | SLS_X     | db       |    28034927 |  4294967295 | 2024-07-10 11:13:09 |           37545 |
  +------------+---------------------+----------+--------------+-----------+----------+-------------+-------------+---------------------+-----------------+
  
  6 rows in set (0.00 sec)

  列名は table_name ですが、クエリ結果の各行はデータベースまたはデータオブジェクトに関する情報を提供します。結果では、sbtest、test、および test2 はデータベース分離レベルを使用します。関数 test3.f1、イベント test3.e1、および ビュー test3.v1 はデータオブジェクト分離レベルを使用します。オブジェクトタイプが Table の mysql/global_ddl_lock という名前のオブジェクトが表示されることもあります。これは無視できる内部情報です。

• 次のコマンドを実行して、クラスター内のすべてのデータベースの分散をクエリできます:

  説明

  このクエリは、特権アカウントを使用してのみ実行できます。新しく作成されたアカウントではこのクエリを実行できません。

  SELECT * FROM INFORMATION_SCHEMA.INNODB_CC_GLOBAL_LOCK_INFO WHERE LOCK_MODE = 'SLS_X';

  クエリ結果は次のとおりです:

  mysql> SELECT * FROM INFORMATION_SCHEMA.INNODB_CC_GLOBAL_LOCK_INFO WHERE LOCK_MODE = 'SLS_X';
  +-----------+------------+---------------------+-----------+-----------+-------------+---------------------+-----------------+
  | master_id | table_name | table_id            | lock_mode | object    | current_lsn | hold_start_time     | hold_total_time |
  +-----------+------------+---------------------+-----------+-----------+-------------+---------------------+-----------------+
  |         1 | test3/v1   | 9149389368457234649 | SLS_X     | view      |    28075972 | 2024-07-10 21:35:08 |             754 |
  |         2 | test5/t1   | 9149389447232697561 | SLS_X     | table     |     7256175 | 2024-07-10 21:46:36 |              66 |
  |         1 | test2      | 3381728963524265351 | SLS_X     | db        |    28034927 | 2024-07-10 11:13:09 |           38073 |
  |         2 | test4      | 3381728963524272009 | SLS_X     | db        |     7255352 | 2024-07-10 21:46:27 |              75 |
  |         1 | test3/f1   | 9149389368458135753 | SLS_X     | function  |    28076635 | 2024-07-10 21:35:20 |             742 |
  |         1 | test3/e1   | 9149389368458332874 | SLS_X     | event     |    28077248 | 2024-07-10 21:35:30 |             732 |
  |         1 | test       | 7190879906290573778 | SLS_X     | db        |    28034927 | 2024-07-10 11:20:57 |           37605 |
  |         2 | test5/p1   | 9149389447233473757 | SLS_X     | procedure |     7257051 | 2024-07-10 21:46:45 |              57 |
  |         1 | sbtest     | 2107518311328629409 | SLS_X     | db        |    28034927 | 2024-07-07 23:04:41 |          254581 |
  +-----------+------------+---------------------+-----------+-----------+-------------+---------------------+-----------------+
  
  9 rows in set (0.00 sec)

  列名は table_name ですが、クエリ結果の各行はデータベースまたはデータオブジェクトに関する情報を提供します。結果は、データベースまたはデータオブジェクトが存在する RW ノードを示します。オブジェクトタイプが Table の mysql/global_ddl_lock という名前のオブジェクトが表示されることもあります。これは無視できる内部情報です。

バイナリログの設定方法

マルチマスタークラスター (無制限) エディションは、MySQL バイナリログと完全に互換性があります。クラスター内のすべての RW ノードからの操作ログを統合して、グローバルに統一され、論理的に順序付けられたバイナリログを生成します。

loose_polar_log_bin パラメーターを設定して、マルチマスタークラスター (無制限) エディションのバイナリログ機能を有効にすることができます。また、binlog_expire_logs_seconds パラメーターを設定して、マルチマスタークラスター (無制限) エディションのバイナリログの保持期間を設定することもできます。詳細については、「バイナリログの有効化」をご参照ください。