ALTER USER
説明
ALTER USER 文は、パスワードやパスワードポリシーなど、ユーザーのアカウント属性を変更するために使用します。
構文
ALTER USER [IF EXISTS] <user_identity> [IDENTIFIED BY <password>]
[<password_policy>]
[<comment>]
password_policy:
1. PASSWORD_HISTORY { <n> | DEFAULT }
2. PASSWORD_EXPIRE { DEFAULT | NEVER | INTERVAL <n> { DAY | HOUR | SECOND }}
3. FAILED_LOGIN_ATTEMPTS <n>
4. PASSWORD_LOCK_TIME { UNBOUNDED | <n> { DAY | HOUR | SECOND }}
5. ACCOUNT_UNLOCK
必須パラメータ
1. <user_identity>
user_identityはユーザーを一意に識別します。構文は 'user_name'@'host' です。user_identityは user_name と host の二つの部分で構成され、username はユーザー名です。host はクライアントが接続するホストアドレスを示します。host 部分では % を使用してあいまい一致を指定できます。host を指定しない場合、デフォルトは '%' です。これは、ユーザーが任意のホストから Doris に接続できることを意味します。 host 部分にはドメインも指定できます。構文は 'user_name'@['domain'] です。角括弧で囲まれていても、Doris はこれをドメインとみなし、その ip アドレスの解決を試みます。
オプションパラメータ
1. <password>
ユーザーのパスワードを指定します。
2. <password_policy>
password_policyは、パスワード認証ログインに関するポリシーを指定する句です。現在、次のポリシーがサポートされています。
PASSWORD_HISTORY { <n> | DEFAULT}現在のユーザーがパスワードをリセットするときに、過去のパスワードを使用できるかどうかを指定します。たとえば、
PASSWORD_HISTORY 10は、過去 10 回に設定したパスワードを新しいパスワードとして使用できないことを意味します。PASSWORD_HISTORY DEFAULTに設定すると、グローバル変数password_historyの値が使用されます。0はこの機能を有効にしないことを意味します。デフォルトは 0 です。
PASSWORD_EXPIRE { DEFAULT | NEVER | INTERVAL <n> { DAY | HOUR | SECOND }}現在のユーザーのパスワードの有効期限を設定します。たとえば、
PASSWORD_EXPIRE INTERVAL 10 DAYは、パスワードが 10 日後に期限切れになることを意味します。PASSWORD_EXPIRE NEVERは、パスワードに有効期限がないことを意味します。PASSWORD_EXPIRE DEFAULTに設定すると、グローバル変数default_password_lifetimeの値が使用されます。デフォルトは NEVER(または 0)で、期限切れになりません。
FAILED_LOGIN_ATTEMPTS <n>現在のユーザーがログインするとき、パスワードを n 回間違えると、アカウントがロックされます。たとえば、
FAILED_LOGIN_ATTEMPTS 3は、3 回ログインに失敗するとアカウントがロックされることを意味します。
PASSWORD_LOCK_TIME { UNBOUNDED | <n> { DAY | HOUR | SECOND }}アカウントがロックされたときのロック時間を設定します。たとえば、
PASSWORD_LOCK_TIME 1 DAYは、アカウントが一日間ロックされることを意味します。
ACCOUNT_UNLOCK
ACCOUNT_UNLOCKは、ロックされたユーザーのロックを解除するために使用します。
3. <comment>
ユーザーコメントを指定します。
アクセス制御要件
この SQL コマンドを実行するユーザーには、少なくとも次の権限が必要です。
| 権限 | オブジェクト | 注記 |
|---|---|---|
| ADMIN_PRIV | USER または ROLE | この操作は、ADMIN_PRIV 権限を持つユーザーまたはロールのみ実行できます |
使用上の注意
4.1.5 以降、特別な root アイデンティティは 'root'@'%' のみです。'root'@'localhost' のようなアイデンティティは通常のユーザーのままであり、ユーザー名が root であるというだけで実際の root アカウントを変更する権限を得ることはありません。実際の root アカウントに対する保護は、root という名前の他のユーザーには適用されません。
-
2.0 以降、このコマンドではユーザーロールを変更できなくなりました。関連する操作には GRANT と REVOKE を使用してください。
-
一つの ALTER USER コマンドでは、次のアカウント属性から同時に変更できるのは一項目のみです:
- パスワードの変更
PASSWORD_HISTORYの変更PASSWORD_EXPIREの変更FAILED_LOGIN_ATTEMPTSとPASSWORD_LOCK_TIMEの変更- ユーザーのロック解除
例
セットアップ — 以下の例の対象ユーザーとして jack を作成します。
CREATE USER jack@'%' IDENTIFIED BY "12345";
- ユーザーのパスワードを変更
ALTER USER jack@'%' IDENTIFIED BY "12345";
- ユーザーのパスワードポリシーを変更
ALTER USER jack@'%' FAILED_LOGIN_ATTEMPTS 3 PASSWORD_LOCK_TIME 1 DAY;
- ユーザーのロックを解除
ALTER USER jack@'%' ACCOUNT_UNLOCK
- ユーザーのコメントを変更
ALTER USER jack@'%' COMMENT "this is my first user"