データベースユーザーとロールの管理

このドキュメントでは、 TiDB CloudコンソールのSQL ユーザーページを使用してデータベースユーザーとロールを管理する方法について説明します。

注記：
SQL ユーザーページはベータ版であり、リクエストがあった場合にのみ利用できます。この機能をリクエストするには、 TiDB Cloudコンソールの右下隅にある[?]をクリックし、 [サポートのリクエスト] をクリックします。次に、 [説明]フィールドに「SQL ユーザーページに申し込む」と入力し、 [送信]をクリックします。
データベースユーザーとロールは組織とプロジェクトのユーザーと役割とは独立しています。データベースユーザーは TiDB クラスター内のデータベースにアクセスするために使用されますが、組織ユーザーとプロジェクトユーザーはTiDB Cloudコンソール内の組織とプロジェクトにアクセスするために使用されます。
SQL ユーザーページに加えて、SQL クライアントを使用してクラスターに接続し、SQL ステートメントを記述することで、データベースユーザーとロールを管理することもできます。詳細については、 TiDB ユーザーアカウント管理参照してください。

データベースユーザーの役割

TiDB Cloudでは、ロールベースのアクセス制御のために、組み込みロールと複数のカスタムロール (使用可能な場合) の両方を SQL ユーザーに付与できます。

組み込みロール
TiDB Cloud には、 SQL ユーザーのデータベースアクセスを制御するのに役立つ次の組み込みロールが用意されています。組み込みロールの 1 つを SQL ユーザーに付与できます。
- Database Admin
- Database Read-Write
- Database Read-Only
カスタムロール
組み込みロールに加えて、クラスターにCREATE ROLEステートメントを使用して作成されたカスタムロールがある場合は、 TiDB Cloudコンソールで SQL ユーザーを作成または編集するときに、これらのカスタムロールを SQL ユーザーに付与することもできます。

SQL ユーザーに組み込みロールと複数のカスタムロールの両方が付与されると、ユーザーの権限はこれらのロールから派生したすべての権限の結合になります。

前提条件

SQL ユーザーページを使用してデータベースユーザーとロールを管理するには、組織のOrganization OwnerロールまたはプロジェクトのProject Ownerロールに属している必要があります。
プロジェクトのロールProject Data Access Read-WriteまたはProject Data Access Read-Onlyの場合、そのプロジェクトのSQL ユーザーページでのみデータベースユーザーを表示できます。

SQLユーザーを作成する

SQL ユーザーを作成するには、次の手順を実行します。

TiDB Cloudコンソールで、プロジェクトのクラスターページに移動します。
ヒント：
複数のプロジェクトがある場合は、左下隅にあるをクリックして、別のプロジェクトに切り替えます。
クラスター名をクリックし、左側のナビゲーションペインで[SQL ユーザー]をクリックします。
右上隅の「SQL ユーザーの作成」をクリックします。
SQL ユーザー構成のダイアログが表示されます。
ダイアログで、SQL ユーザーの情報を次のように入力します。
1. SQL ユーザーの名前を入力します。
2. SQL ユーザーのパスワードを作成するか、 TiDB Cloud でユーザーのパスワードを自動的に生成します。
3. SQL ユーザーにロールを付与します。
  - 組み込みロール:組み込みロールドロップダウンリストで SQL ユーザーの組み込みロールを選択する必要があります。
  - カスタムロール: クラスターにCREATE ROLEステートメントを使用して作成されたカスタムロールがある場合は、[カスタムロール**]ドロップダウンリストからロールを選択して、SQL ユーザーにカスタムロールを付与できます。それ以外の場合、[カスタムロール] ドロップ**ダウンリストはここでは表示されません。
各 SQL ユーザーに対して、組み込みロールと複数のカスタムロール (存在する場合) を付与できます。
[作成]をクリックします。

SQL ユーザーをビュー

クラスターの SQL ユーザーを表示するには、次の手順を実行します。

TiDB Cloudコンソールで、プロジェクトのクラスターページに移動します。
ヒント：
複数のプロジェクトがある場合は、左下隅にあるをクリックして、別のプロジェクトに切り替えます。
クラスター名をクリックし、左側のナビゲーションペインで[SQL ユーザー]をクリックします。

SQL ユーザーを編集する

SQL ユーザーのパスワードまたはロールを編集するには、次の手順を実行します。

TiDB Cloudコンソールで、プロジェクトのクラスターページに移動します。
ヒント：
複数のプロジェクトがある場合は、左下隅にあるをクリックして、別のプロジェクトに切り替えます。
クラスター名をクリックし、左側のナビゲーションペインで[SQL ユーザー]をクリックします。
編集する SQL ユーザーの行で、 [アクション] 列の[...]をクリックし、 [編集]をクリックします。
SQL ユーザー構成のダイアログが表示されます。
ダイアログでは、必要に応じてユーザーのパスワードとロールを編集し、 「更新」をクリックできます。
注記：
デフォルトの<prefix>.rootユーザーの役割は変更をサポートしていません。パスワードのみ変更できます。

SQL ユーザーを削除する

SQL ユーザーを削除するには、次の手順を実行します。

TiDB Cloudコンソールで、プロジェクトのクラスターページに移動します。
ヒント：
複数のプロジェクトがある場合は、左下隅にあるをクリックして、別のプロジェクトに切り替えます。
クラスター名をクリックし、左側のナビゲーションペインで[SQL ユーザー]をクリックします。
編集する SQL ユーザーの行で、 [アクション] 列の[...]をクリックし、 [削除]をクリックします。
注記：
デフォルトの<prefix>.rootユーザーは削除をサポートしていません。
削除を確認します。