メインコンテンツまでスキップ
に最終更新

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_PRIVUSER または ROLEこの操作は、ADMIN_PRIV 権限を持つユーザーまたはロールのみ実行できます

使用上の注意​

4.1.5 以降、特別な root アイデンティティは 'root'@'%' のみです。'root'@'localhost' のようなアイデンティティは通常のユーザーのままであり、ユーザー名が root であるというだけで実際の root アカウントを変更する権限を得ることはありません。実際の root アカウントに対する保護は、root という名前の他のユーザーには適用されません。

  1. 2.0 以降、このコマンドではユーザーロールを変更できなくなりました。関連する操作には GRANT と REVOKE を使用してください。

  2. 一つの 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"