PolarDB:指定されたデータベースシャードで SQL ステートメントを実行する

シャード名の取得

SHOW NODE を実行して、シャードとその名前を一覧表示します：

mysql> SHOW NODE\G

出力例：

*************************** 1. 行 ******************
                 ID: 0
               NAME: DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0000_RDS
  MASTER_READ_COUNT: 212
   SLAVE_READ_COUNT: 0
MASTER_READ_PERCENT: 100%
 SLAVE_READ_PERCENT: 0%
*************************** 2. 行 ******************
                 ID: 1
               NAME: DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0001_RDS
  MASTER_READ_COUNT: 29
   SLAVE_READ_COUNT: 0
MASTER_READ_PERCENT: 100%
 SLAVE_READ_PERCENT: 0%
...
8 行がセットされました (0.02 秒)

NAME フィールドが各シャードの固有識別子です。たとえば、DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0003_RDS は物理データベースシャード drds_test_vtla_0003 に対応します。

単一のシャードへのルーティング

シャード 0 で SELECT ステートメントを実行します：

SELECT /*TDDL:node('DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0000_RDS')*/ * FROM table_name;

複数のシャードへのルーティング

シャード 0 およびシャード 6 で SELECT ステートメントを実行します：

SELECT /*TDDL:node('DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0000_RDS','DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0006_RDS')*/ * FROM table_name;

このステートメントは、DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0000_RDS シャードおよび DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0006_RDS シャードの両方で実行されます。

シャード上の物理実行計画の表示

/*TDDL:node('DRDS_TEST_1473471355140LRPRDRDS_TEST_VTLA_0000_RDS')*/ EXPLAIN SELECT * FROM table_name;

MySQL コマンドラインクライアントで NODE HINT が効かない

原因：標準のヒント形式 (/*+TDDL:hint_command*/) を使用した場合、MySQL コマンドラインクライアントがサーバーにステートメントを送信する前にコメントを削除してしまうため、PolarDB-X 1.0 がヒントを受信できません。

解決策：MySQL コマンドラインクライアントにログインする際に -c フラグを指定します：

mysql -h <host> -P <port> -u <username> -p -c

-c フラグにより、クライアントがコメントを保持するようになります。詳細については、「mysql クライアントのオプション」をご参照ください。

また、/!+TDDL:hint_command*/ 形式を使用することも可能です。こちらは -c フラグを指定する必要はありません。