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

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

注記：
SQLユーザーページはベータ版であり、リクエストに応じてのみご利用いただけます。この機能をリクエストするには、 TiDB Cloudコンソールの右下にある「？」をクリックし、「サポートをリクエスト」をクリックしてください。次に、 「説明」欄に「SQLユーザーページへの申請」と入力し、 「送信」をクリックしてください。
データベースユーザーとロールは組織とプロジェクトのユーザーと役割とは独立しています。データベースユーザーは TiDB クラスター内のデータベースにアクセスするために使用されますが、組織ユーザーとプロジェクトユーザーはTiDB Cloudコンソール内の組織とプロジェクトにアクセスするために使用されます。
SQLユーザーページに加えて、SQLクライアントを使用してクラスターに接続し、SQL文を記述することで、データベースユーザーとロールを管理することもできます。詳細については、 TiDB ユーザーアカウント管理ご覧ください。

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

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

組み込みロール
TiDB Cloud は、SQL ユーザーのデータベースアクセスを制御するために、以下の組み込みロールを提供しています。組み込みロールのいずれかを 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 ユーザーを表示するには、次の手順を実行します。

プロジェクトのクラスターページで、ターゲットクラスターの名前をクリックして、概要ページに移動します。
ヒント：
左上隅のコンボボックスを使用して、組織、プロジェクト、クラスターを切り替えることができます。
左側のナビゲーションペインで、 [設定] > [SQL ユーザー] をクリックします。

SQLユーザーを作成する

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

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

SQLユーザーを編集する

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

クラスターのSQLユーザーページに移動します。
編集する SQL ユーザーの行で、 [アクション] 列の[...]をクリックし、 [編集] をクリックします。
SQL ユーザー構成のダイアログが表示されます。
ダイアログで、必要に応じてユーザーのパスワードとロールを編集し、 「更新」をクリックします。
注記：
デフォルトユーザー<prefix>.rootのロールは変更できません。パスワードのみ変更できます。

SQLユーザーを削除する

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

クラスターのSQLユーザーページに移動します。
削除する SQL ユーザーの行で、 [アクション] 列の[...]をクリックし、 [削除]をクリックします。
注記：
デフォルトの<prefix>.rootユーザーは削除をサポートしていません。
削除を確認します。