TiDB ユーザー アカウント管理
このドキュメントでは、TiDB ユーザー アカウントを管理する方法について説明します。
ユーザー名とパスワード
TiDB は、ユーザー アカウントをmysql.user
システム データベースのテーブルに格納します。各アカウントは、ユーザー名とクライアント ホストによって識別されます。各アカウントにはパスワードが設定されている場合があります。
MySQL クライアントを使用して TiDBサーバーに接続し、指定したアカウントとパスワードを使用してログインできます。各ユーザー名は、32 文字以内である必要があります。
mysql --port 4000 --user xxx --password
または、コマンド ライン パラメータの省略形を使用します。
mysql -P 4000 -u xxx -p
ユーザー アカウントを追加する
TiDB アカウントは次の 2 つの方法で作成できます。
CREATE USER
やGRANT
など、アカウントの作成と権限の確立を目的とした標準のアカウント管理 SQL ステートメントを使用する。INSERT
、UPDATE
、またはDELETE
などのステートメントを使用して特権テーブルを直接操作する。この方法を使用してアカウントを作成することはお勧めしません。更新が不完全になる可能性があるためです。
サードパーティの GUI ツールを使用してアカウントを作成することもできます。
CREATE USER [IF NOT EXISTS] user [IDENTIFIED BY 'auth_string'];
パスワードを割り当てた後、TiDB はauth_string
暗号化してmysql.user
テーブルに格納します。
CREATE USER 'test'@'127.0.0.1' IDENTIFIED BY 'xxx';
TiDB アカウントの名前は、ユーザー名とホスト名で構成されます。アカウント名の構文は、'user_name'@'host_name' です。
user_name
は大文字と小文字が区別されます。host_name
は、ワイルドカード%
または_
をサポートするホスト名または IP アドレスです。たとえば、ホスト名'%'
すべてのホストに一致し、ホスト名'192.168.1.%'
サブネット内のすべてのホストに一致します。
ホストはあいまい一致をサポートしています。
CREATE USER 'test'@'192.168.10.%';
test
ユーザーは、 192.168.10
サブネット上の任意のホストからログインできます。
ホストが指定されていない場合、ユーザーは任意の IP からログインできます。パスワードが指定されていない場合、デフォルトは空のパスワードです。
CREATE USER 'test';
に相当:
CREATE USER 'test'@'%' IDENTIFIED BY '';
指定されたユーザーが存在しない場合、ユーザーの自動作成の動作はsql_mode
に依存します。 sql_mode
にNO_AUTO_CREATE_USER
が含まれている場合、 GRANT
ステートメントはユーザーを作成せず、エラーが返されます。
たとえば、 sql_mode
にNO_AUTO_CREATE_USER
含まれず、次のCREATE USER
およびGRANT
ステートメントを使用して 4 つのアカウントを作成するとします。
CREATE USER 'finley'@'localhost' IDENTIFIED BY 'some_pass';
GRANT ALL PRIVILEGES ON *.* TO 'finley'@'localhost' WITH GRANT OPTION;
CREATE USER 'finley'@'%' IDENTIFIED BY 'some_pass';
GRANT ALL PRIVILEGES ON *.* TO 'finley'@'%' WITH GRANT OPTION;
CREATE USER 'admin'@'localhost' IDENTIFIED BY 'admin_pass';
GRANT RELOAD,PROCESS ON *.* TO 'admin'@'localhost';
CREATE USER 'dummy'@'localhost';
アカウントに付与された権限を確認するには、 SHOW GRANTS
ステートメントを使用します。
SHOW GRANTS FOR 'admin'@'localhost';
+-----------------------------------------------------+
| Grants for admin@localhost |
+-----------------------------------------------------+
| GRANT RELOAD, PROCESS ON *.* TO 'admin'@'localhost' |
+-----------------------------------------------------+
ユーザー アカウントを削除する
ユーザー アカウントを削除するには、 DROP USER
ステートメントを使用します。
DROP USER 'test'@'localhost';
この操作により、 mysql.user
テーブル内のユーザーのレコードと権限テーブル内の関連レコードがクリアされます。
予約済みユーザー アカウント
TiDB は、データベースの初期化中に'root'@'%'
デフォルト アカウントを作成します。
アカウントのリソース制限を設定する
現在、TiDB はアカウント リソース制限の設定をサポートしていません。
アカウントのパスワードを割り当てる
TiDB はパスワードをmysql.user
システム データベースに格納します。パスワードを割り当てたり更新したりする操作は、 CREATE USER
権限、またはmysql
データベースの権限( INSERT
新しいアカウントを作成する権限、 UPDATE
既存のアカウントを更新する権限) を持つユーザーにのみ許可されます。
新しいアカウントを作成するときにパスワードを割り当てるには、
CREATE USER
使用し、IDENTIFIED BY
句を含めます。CREATE USER 'test'@'localhost' IDENTIFIED BY 'mypass';既存のアカウントのパスワードを割り当てるか変更するには、
SET PASSWORD FOR
またはALTER USER
を使用します。SET PASSWORD FOR 'root'@'%' = 'xxx';または:
ALTER USER 'test'@'localhost' IDENTIFIED BY 'mypass';
root
パスワードを忘れる
構成ファイルを変更します。
tidb-server インスタンスの 1 つが配置されているマシンにログインします。
TiDB ノード展開ディレクトリの下にある
conf
ディレクトリに入り、tidb.toml
構成ファイルを見つけます。構成ファイルの
security
セクションに構成項目skip-grant-table
を追加します。security
セクションがない場合は、次の 2 行を tidb.toml 構成ファイルの末尾に追加します。[security] skip-grant-table = true
tidb-server プロセスを停止します。
tidb-server プロセスをビュー。
ps aux | grep tidb-servertidb-server に対応するプロセス ID (PID) を見つけ、
kill
コマンドを使用してプロセスを停止します。kill -9 <pid>
変更した構成を使用して TiDB を開始します。
ノート:
TiDB プロセスを開始する前に
skip-grant-table
を設定すると、オペレーティング システム ユーザーのチェックが開始されます。オペレーティング システムのroot
ユーザーのみが TiDB プロセスを開始できます。TiDB ノードの配置ディレクトリの下にある
scripts
ディレクトリを入力します。オペレーティング システムの
root
アカウントに切り替えます。フォアグラウンドのディレクトリで
run_tidb.sh
スクリプトを実行します。新しいターミナル ウィンドウで
root
としてログインし、パスワードを変更します。mysql -h 127.0.0.1 -P 4000 -u root
run_tidb.sh
スクリプトの実行を停止し、ステップ 1 で TiDB 構成ファイルに追加されたコンテンツを削除し、tidb-server が自動的に開始するのを待ちます。
FLUSH PRIVILEGES
ユーザーと権限に関連する情報は TiKVサーバーに保存され、TiDB はこの情報をプロセス内にキャッシュします。一般に、 CREATE USER
、 GRANT
、およびその他のステートメントによる関連情報の変更は、クラスター全体ですぐに反映されます。ネットワークが一時的に利用できないなどの影響があった場合は、TiDB が定期的にキャッシュ情報をリロードするため、約 15 分で変更が反映されます。
特権テーブルを直接変更した場合は、次のコマンドを実行して変更をすぐに適用します。
FLUSH PRIVILEGES;
詳細については、 権限管理を参照してください。