DESCRIBE USER¶
ユーザーのプロパティの現在値とデフォルト値を含む ユーザー を説明します。
DESCRIBE は DESC に短縮できます。
- こちらもご参照ください。
構文¶
{ DESC | DESCRIBE } USER <name>
パラメーター¶
name
説明するユーザーの識別子を指定します。
識別子にスペースまたは特殊文字が含まれる場合、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。
詳細については、 識別子の要件 をご参照ください。
出力¶
コマンドの出力には、オブジェクトのプロパティとメタデータを説明する以下の列が含まれます。
列 |
説明 |
---|---|
|
プロパティの名前(ユーザーのプロパティ を参照)。 |
|
プロパティのデータ型(例えば、 |
|
プロパティに割り当てられた値。 |
|
プロパティのデフォルト値。 |
property
列には、通知統合の以下のプロパティを含めることができます。
プロパティ |
説明 |
---|---|
|
ユーザー名。 |
|
ユーザーについてのコメント。 |
|
Snowsight でユーザーに表示される名前。 |
|
ユーザーのタイプ。可能な値のリストについては、ユーザーのタイプ をご参照ください。 |
|
ユーザーがシステムにログインするために入力する名前。 |
|
ユーザーの名。 |
|
ユーザーのミドルネーム。 |
|
ユーザーの姓。 |
|
ユーザーのメールアドレス。 |
|
ユーザーの難読化されたパスワード。 |
|
|
|
|
|
``true``の場合、ユーザーはSnowflakeによってロックされます。ユーザーがロックされると、ロックが解除されるまでログインできません。 |
|
|
|
ユーザーのステータスが「期限切れ」に設定され、ユーザーがログインできなくなるまでの日数。 |
|
ユーザーログインの一時ロックが解除される までの分数。 |
|
ログイン時のユーザーのセッションに対して、デフォルトでアクティブになる仮想ウェアハウス。 |
|
ログイン時にユーザーのセッションに対して、デフォルトでアクティブになる名前空間(データベースのみ、またはデータベースとスキーマ)。 |
|
ログイン時にユーザーのセッションに対してデフォルトでアクティブになるプライマリロール。 |
|
ログイン時にユーザのセッションに対してアクティブになるセカンダリロールのセット。 |
|
|
|
Duoに使用される認証 ID 。 |
|
ユーザーの:ref: |
|
|
|
``true``の場合、ユーザーは1つ以上の プログラムのアクセストークン を持っています。 |
|
|
|
MFA ユーザーの要件を 一時的に回避する までの分数。 |
|
|
|
|
|
ユーザーの RSA パブリックキーのフィンガープリント。 |
|
RSA パブリックキーが最後にユーザーに設定された日時。 |
|
キーペアローテーション の期間に使用するユーザーの2番目の RSA パブリックキー。 |
|
ユーザーの2番目の RSA パブリックキーのフィンガープリント。 |
|
2番目の RSA パブリックキーが最後にユーザーに設定された日時。 |
|
最後の非 NULL パスワードがユーザーに設定された日時。パスワードが設定されていない場合、このプロパティの値は NULL です。 |
|
今後の使用のために予約されています。 |
|
今後の使用のために予約されています。 |
|
|
アクセス制御の要件¶
個々のユーザーは、このコマンドを実行して独自の name
を指定することにより、独自のプロパティを表示できます。
他のユーザーのプロパティを表示するには、次の権限を持つロールを使用する必要があります。
権限 |
オブジェクト |
メモ |
---|---|---|
OWNERSHIP |
ユーザー |
指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。
セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。
使用上の注意¶
ユーザーオブジェクトプロパティ
MINS_TO_BYPASS_NETWORK_POLICY
は、ユーザーが既存の ネットワークポリシー に準拠することなく、Snowflakeにアクセスできる時間(分)を定義します。分数はSnowflakeによってのみ設定でき(デフォルト:NULL
)、ユーザーがSnowflakeにアクセスできるようにする一時的な回避策として意図されています。このプロパティの値を設定するには、 Snowflakeサポート にお問い合わせください。このコマンドは、ユーザーのセッションパラメーターのデフォルトを表示しません。代わりに、 SHOW PARAMETERS IN USER を使用してください。
パスワードがまだ設定されていない場合、ユーザーオブジェクトプロパティ
PASSWORD_LAST_SET_TIME
はデフォルトでNull
になります。292278994-08-17 07:12:55.807
または1969-12-31 23:59:59.999
の値は、この行が含まれる前にパスワードが設定されたことを示します。値1969-12-31 23:59:59.999
は、有効期限が切れたパスワードを示している場合もあり、ユーザーはパスワードを変更する必要があります。
このコマンドの出力を後処理するには、 パイプ演算子 (
->>
)または RESULT_SCAN 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。このコマンドの出力列名は小文字で生成されます。パイプ演算子または でこのコマンドの結果セットを消費する場合 RESULT_SCAN 関数の場合は、を使用します 二重引用符で囲まれた識別子 クエリの列名に を使用し、スキャンされた出力の列名と一致するようにします。たとえば、出力列の名前が次の場合
type``次に を指定します ``"type"
識別子用。
例¶
次の例は、my_user
という名前のユーザーについて説明しています。
DESCRIBE USER my_user;
+--------------------------------------------+-------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------+
| property | value | default | description |
|--------------------------------------------+-------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------|
| NAME | JSMITH | null | Name |
| COMMENT | null | null | user comment associated to an object in the dictionary |
| DISPLAY_NAME | Jane Smith | null | Display name of the associated object |
| TYPE | PERSON | null | Type of the account, application package, data exchange, data exchange listing, replication group, secret, network rule, or user. |
| LOGIN_NAME | JSMITH | null | Login name of the user |
| FIRST_NAME | Jane | null | First name of the user |
| MIDDLE_NAME | null | null | Middle name of the user |
| LAST_NAME | Smith | null | Last name of the user |
| EMAIL | jane.smith@example.com | null | Email address of the user |
| PASSWORD | ******** | null | Password of the user |
| MUST_CHANGE_PASSWORD | false | false | User must change the password |
| DISABLED | false | false | Whether the entity is disabled |
| SNOWFLAKE_LOCK | false | false | Whether the user, account, or organization is locked by Snowflake |
| SNOWFLAKE_SUPPORT | false | false | Snowflake Support is allowed to use the user or account |
| DAYS_TO_EXPIRY | null | null | User record will be treated as expired after specified number of days |
| MINS_TO_UNLOCK | null | null | Temporary lock on the user will be removed after specified number of minutes |
| DEFAULT_WAREHOUSE | MY_WAREHOUSE | null | Default warehouse for this user |
| DEFAULT_NAMESPACE | MY_DB.MY_SCHEMA | null | Default database namespace prefix for this user |
| DEFAULT_ROLE | MY_ROLE | null | Primary principal of user session will be set to this role |
| DEFAULT_SECONDARY_ROLES | [] | [ALL] | The secondary roles will be set to all roles provided here. |
| EXT_AUTHN_DUO | false | false | Whether Duo Security is enabled as second factor authentication |
| EXT_AUTHN_UID | null | null | External authentication ID of the user |
| DEFAULT_MFA_METHOD | null | null | Default MFA method for the user |
| HAS_MFA | true | false | Whether the user is enrolled in multi-factor authentication |
| HAS_PAT | true | false | Whether the user has a programmatic access token |
| HAS_FEDERATED_WORKLOAD_AUTHENTICATION | false | false | Reserved for future use |
| MINS_TO_BYPASS_MFA | null | null | Temporary bypass MFA for the user for a specified number of minutes |
| MINS_TO_BYPASS_NETWORK_POLICY | null | null | Temporary bypass network policy on the user for a specified number of minutes |
| RSA_PUBLIC_KEY | ... | null | RSA public key of the user |
| RSA_PUBLIC_KEY_FP | SHA256:...= | null | Fingerprint of user's RSA public key. |
| RSA_PUBLIC_KEY_LAST_SET_TIME | null | null | The timestamp at which the RSA public key was last set for the user. Defaults to null if no RSA public key has been set yet. |
| RSA_PUBLIC_KEY_2 | ... | null | Second RSA public key of the user |
| RSA_PUBLIC_KEY_2_FP | SHA256:...= | null | Fingerprint of user's second RSA public key. |
| RSA_PUBLIC_KEY_2_LAST_SET_TIME | null | null | The timestamp at which the second RSA public key was last set for the user. Defaults to null if no second RSA public key has been set yet. |
| PASSWORD_LAST_SET_TIME | 2020-10-08 01:33:13.43 | null | The timestamp on which the last non-null password was set for the user. Default to null if no password has been set yet. |
| CUSTOM_LANDING_PAGE_URL | null | null | Reserved for future use |
| CUSTOM_LANDING_PAGE_URL_FLUSH_NEXT_UI_LOAD | false | false | Reserved for future use |
+--------------------------------------------+-------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------+