PolarDB:マルチテナント管理

データ分離の有効化

データ分離機能を有効にするには、enable_multi_tenantパラメーターをONに設定します。

リソース分離の有効化

リソース分離機能を有効にするには、まずデータ分離機能を有効にします。 enable_multi_tenant、thread_pool_multi_tenant_enabled、およびthread_pool_enabledパラメーターをONに設定します。 thread_pool_sizeパラメーターの値がクラスターノード仕様のCPUコア数と一致していることを確認します。

• ノード仕様の表示

  PolarDBコンソールのクラスターの [基本情報] ページに移動します。 [データベースノード] セクションでは、クラスターのノード仕様を確認できます。

  

• パラメーターの設定

  • enable_multi_tenantおよびthread_pool_multi_tenant_enabledパラメーター: テクニカルサポートに連絡して、パラメーターをONに設定します。

  • thread_pool_enabledおよびthread_pool_sizeパラメーター: PolarDBコンソールにログインします。 [クラスター] ページでクラスターを見つけます。 [設定と管理] > [パラメーター] ページに移動してパラメーターを変更します。 詳細については、「クラスターとノードパラメーターの設定」をご参照ください。

スタンドアロンマルチテナントモードのPolarDB for MySQLクラスターは、CPUリソースの分離のみをサポートします。 リソース設定を作成するときは、min_cpuパラメーターとmax_cpuパラメーターを使用して、設定のCPUリソース制限を指定します。 テナントがリソース構成にバインドされている場合、リソース構成はテナントのユーザー接続が使用できるCPUリソースを制限します。

CREATE resource_config <resource_config_name> min_cpu <min_cpu> max_cpu <min_cpu>;

CREATE resource_config r1 min_cpu 0 max_cpu 1;
CREATE resource_config r2 min_cpu 1 max_cpu 4;

SELECT * FROM mysql.tenant_resource_config;

+----------------------+-------------------------+-------------------------+
| resource_config_name | resource_config_min_cpu | resource_config_max_cpu |
+----------------------+-------------------------+-------------------------+
| r1                   |                       0 |                       1 |
| r2                   |                       1 |                       4 |
+----------------------+-------------------------+-------------------------+

ALTER resource_config <resource_config_name> min_cpu <min_cpu> max_cpu <min_cpu>;

ALTER resource_config r2 min_cpu 1 max_cpu 2;

DROP resource_config <resource_config_name>;

DROP resource_config r1;

テナントは、システムテナントと通常テナントの2種類に分類されます。 システムテナントは、元のモードのユーザーに対応するように設計されており、管理操作を必要とせず、関与しません。 ここでは、通常のテナントを管理する方法について説明します。

CREATE tenant <tenant_name> resource_config <resource_config_name>;

CREATE tenant tn1 resource_config r1;

SELECT * FROM mysql.tenants;

+-------------+----------------------+
| tenant_name | resource_config_name |
+-------------+----------------------+
| tn1         | r1                   |
+-------------+----------------------+

ALTER tenant <tenant_name> resource_config <resource_config_name>;

ALTER tenant tn1 resource_config r2;

DROP tenant <tenant_name>;

DROP tenant tn1;

ユーザーは、システムテナントのユーザーと通常のテナントのユーザーの2つのタイプに分けられます。 システムテナントのユーザーは、元のモードのユーザーです。 システムテナントのユーザーの管理方法については、「アカウント管理」をご参照ください。 ここでは、通常テナントのユーザーを管理する方法について説明します。

対応する管理操作は、システムテナントまたは通常テナントで実行できます。

CREATE USER <user_name>@<tenant_name> [IDENTIFIED BY <password>];

-- without a password
CREATE USER 'u1@tn1';

-- with a password
CREATE USER 'u1@tn1' IDENTIFIED BY 'password';

DROP USER <user_name>@<tenant_name>;

DROP USER 'u1@tn1';

CREATE USER <user_name> [IDENTIFIED BY <password>];

-- without password
CREATE USER 'u2';

-- with a password
CREATE USER 'u2' IDENTIFIED BY 'password';

DROP USER <user_name>;

DROP USER 'u2';

データベースへの接続

クライアントを使用してデータベースに接続する場合、username @ tenant name形式でユーザーを指定する必要があります。 接続が確立された後、ユーザーはテナントのリソース制限の対象となります。

構文

mysql -h <host> -P <port> -u <user_name>@<tenant_name> -p

例

mysql -h pc... -P 3306 -u u1@tn1 -p
Enter password: 

データベースは、システムテナントのデータベースと通常テナントのデータベースに分かれています。 システムテナントのデータベースは、元のモードのデータベースです。 システムテナントのデータベースの管理方法については、「データベース管理」をご参照ください。 ここでは、通常テナントのデータベースを管理する方法について説明します。

対応する管理操作は、システムテナントまたは通常テナントで実行できます。

CREATE DATABASE <database_name>@<tenant_name>;

CREATE DATABASE `db1@tn1`;

DROP DATABASE <database_name>@<tenant_name>;

DROP DATABASE `db1@tn1`;

CREATE DATABASE <database_name>;

CREATE DATABASE `db2`;

DROP DATABASE <database_name>;

DROP DATABASE `db2`;

1. 特権アカウントを使用してクラスターに接続し、次のSQL文を実行して、スレッドグループとテナント間のバインディング関係を表示します。

   SELECT * FROM information_schema.thread_pool_status;

2. サンプル出力：

   マルチテナントリソースの分離が有効になっている場合、TENANT_NAME列には、スレッドグループを排他的に使用するテナントが表示されます。 スレッドグループのTENANT_NAME列が空の場合、スレッドグループは複数のテナントで共有されます。

   TENANT_NAME: スレッドグループを排他的に使用するテナントの名前。

   +----+--------------+---------------------+----------------------+-------------------+----------------+-------------+
   | ID | THREAD_COUNT | ACTIVE_THREAD_COUNT | WAITING_THREAD_COUNT | DUMP_THREAD_COUNT |      ...       | TENANT_NAME |
   +----+--------------+---------------------+----------------------+-------------------+----------------+-------------+
   |  0 |            2 |                   0 |                    0 |                 0 |      ...       |             |
   |  1 |            2 |                   1 |                    0 |                 0 |      ...       | tn1         |
   |  2 |            4 |                   0 |                    0 |                 1 |      ...       |             |
   |  3 |            2 |                   0 |                    0 |                 0 |      ...       |             |
   |  4 |            3 |                   0 |                    0 |                 1 |      ...       |             |
   +----+--------------+---------------------+----------------------+-------------------+----------------+-------------+

マルチテナントモードでは、監査ログは各操作に関係するデータベースとユーザーを記録します。

たとえば、データベースdb3に対してテナントt2のユーザーu1によって実行されたSQLクエリが監査ログに記録されます。 データベース列はdb3 @ t2として表示され、user列はu1 @ t2として表示されます。