DESCRIBE USER

사용자 속성의 현재 및 기본값을 포함하여 사용자 에 대해 설명합니다.

DESCRIBE는 DESC로 축약할 수 있습니다.

참고 항목:

DROP USER , ALTER USER , CREATE USER , SHOW USERS

구문

{ DESC | DESCRIBE } USER <name>
Copy

매개 변수

name

설명할 사용자의 식별자를 지정합니다.

식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

출력

명령의 출력에는 오브젝트의 속성과 메타데이터를 설명하는 다음 열이 포함됩니다.

설명

property

속성의 이름(사용자의 속성 참조)입니다.

property_type

속성의 데이터 타입입니다(예: Boolean 또는 String).

property_value

속성에 할당된 값입니다.

property_default

속성의 기본값입니다.

property 열에는 알림 통합의 다음 속성을 포함할 수 있습니다.

사용자의 속성입니다.

속성

설명

NAME

사용자의 이름입니다.

COMMENT

사용자에 대한 설명입니다.

DISPLAY_NAME

Snowsight 에서 사용자에게 표시되는 이름입니다.

TYPE

사용자의 유형입니다. 가능한 값 목록은 사용자 유형 섹션을 참조하세요.

LOGIN_NAME

사용자가 시스템에 로그인하기 위해 입력하는 이름입니다.

FIRST_NAME

사용자의 이름입니다.

MIDDLE_NAME

사용자의 중간 이름입니다.

LAST_NAME

사용자의 성입니다.

EMAIL

사용자의 이메일 주소입니다.

PASSWORD

사용자의 난독화된 비밀번호입니다.

MUST_CHANGE_PASSWORD

true 인 경우 사용자는 다음에(최초 로그인 포함) 시스템에 로그인할 때 비밀번호를 반드시 변경하도록 요구됩니다.

DISABLED

true 인 경우 사용자는 Snowflake 외부에서 잠기며 다시 로그인할 수 없습니다.

SNOWFLAKE_LOCK

true 인 경우 사용자는 Snowflake에 의해 잠깁니다. 사용자 계정이 잠기면 잠금이 해제될 때까지 로그인할 수 없습니다.

SNOWFLAKE_SUPPORT

true 인 경우 Snowflake 지원은 사용자 또는 계정을 사용할 수 있습니다.

DAYS_TO_EXPIRY

사용자 상태가 “만료됨”으로 설정된 후 사용자가 더 이상 로그인할 수 없는 기간(일)입니다.

MINS_TO_UNLOCK

사용자 로그인에 대한 임시 잠금이 해제 될 때까지의 시간(분)입니다.

DEFAULT_WAREHOUSE

로그인 시 사용자 세션에 대해 기본적으로 활성 상태인 가상 웨어하우스입니다.

DEFAULT_NAMESPACE

로그인 시 사용자 세션에 대해 기본적으로 활성 상태인 네임스페이스(데이터베이스 전용 또는 데이터베이스 및 스키마)입니다.

DEFAULT_ROLE

로그인 시 사용자 세션에 대해 기본적으로 활성화되는 기본 역할입니다.

DEFAULT_SECONDARY_ROLES

로그인 시 사용자 세션에 대해 활성화되는 보조 역할 세트입니다.

EXT_AUTHN_DUO

true 인 경우 사용자에 대해 Duo 가 활성화되며 이 경우 사용자는 로그인할 때 MFA(다단계 인증) 를 사용해야 합니다.

EXT_AUTHN_UID

Duo에 사용되는 권한 부여 ID입니다.

DEFAULT_MFA_METHOD

사용자의 기본 MFA 메서드 입니다.

HAS_MFA

true 인 경우 사용자가 MFA(다단계 인증) 에 등록됩니다.

HAS_PAT

true 인 경우 사용자는 1개 이상의 프로그래밍 방식 액세스 토큰 을 보유합니다.

HAS_WORKLOAD_IDENTITY

true 인 경우 사용자가 워크로드 ID 페더레이션 으로 인증하도록 구성됩니다.

MINS_TO_BYPASS_MFA

사용자의 MFA 요구를 일시적으로 우회 하는 시간(분)입니다.

MINS_TO_BYPASS_NETWORK_POLICY

프로그래밍 방식 액세스 토큰에 대한 네트워크 정책이 있어야 한다는 요구 사항을 일시적으로 우회 할 시간(분)입니다.

RSA_PUBLIC_KEY

키 페어 인증 에 대한 사용자의 RSA 공개 키입니다.

RSA_PUBLIC_KEY_FP

사용자의 RSA 공개 키 지문입니다.

RSA_PUBLIC_KEY_LAST_SET_TIME

RSA 공개 키가 사용자에 대해 마지막으로 설정된 날짜 및 시간입니다.

RSA_PUBLIC_KEY_2

키 페어 순환 중에 사용할 사용자의 두 번째 RSA 공개 키입니다.

RSA_PUBLIC_KEY_2_FP

사용자의 두 번째 RSA 공개 키 지문입니다.

RSA_PUBLIC_KEY_2_LAST_SET_TIME

두 번째 RSA 공개 키가 사용자에 대해 마지막으로 설정된 날짜 및 시간입니다.

PASSWORD_LAST_SET_TIME

NULL이 아닌 마지막 비밀번호가 사용자에 대해 설정된 날짜 및 시간입니다. 비밀번호가 설정되지 않은 경우 이 속성의 값은 NULL입니다.

CUSTOM_LANDING_PAGE_URL

향후 사용을 위해 예약되어 있습니다.

CUSTOM_LANDING_PAGE_URL_FLUSH_NEXT_UI_LOAD

향후 사용을 위해 예약되어 있습니다.

IS_FROM_ORGANIZATION_USER

true 인 경우 사용자를 전역 조직 사용자 에서 가져온 것입니다.

액세스 제어 요구 사항

개별 사용자는 이 명령을 실행하고 자신의 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;
Copy
+--------------------------------------------+-------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------+
| 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                                                                                                                    |
+--------------------------------------------+-------------------------+---------+--------------------------------------------------------------------------------------------------------------------------------------------+