DESCRIBE TABLE

테이블의 스테이지 속성에 대한 기본값뿐 아니라 테이블의 열 또는 현재 값도 설명합니다.

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

참고 항목:

DROP TABLE , ALTER TABLE , CREATE TABLE , SHOW TABLES

DESCRIBE VIEW

구문

DESC[RIBE] TABLE <name> [ TYPE =  { COLUMNS | STAGE } ]
Copy

매개 변수

name

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

TYPE = COLUMNS | STAGE

테이블의 열을 표시할지, 테이블의 스테이지 속성(현재 값과 기본값 포함)을 표시할지 여부를 지정합니다.

기본값: TYPE = COLUMNS

사용법 노트

  • 이 명령은 테이블의 오브젝트 매개 변수를 표시하지 않습니다. SHOW PARAMETERS IN TABLE … 을 대신 사용하십시오.

  • DESC TABLE과 DESCRIBE VIEW 는 서로 교환할 수 있습니다. 어떤 명령을 사용하든 문의 기준과 일치하는 테이블 또는 뷰에 대한 세부 정보를 검색할 수 있습니다. 하지만 뷰에는 스테이지 속성이 없으므로 TYPE = STAGE 가 뷰에 적용되지 않습니다.

  • 테이블에서 테이블 스키마 진화가 활성화된 경우 출력에 SchemaEvolutionRecord 열이 포함됩니다. 이 열은 2023_08 번들(일반적으로 활성화됨) 과 함께 도입되었습니다. 자세한 내용은 테이블 스키마 진화 섹션을 참조하십시오.

  • 출력에는 열에 설정된 마스킹 정책 을 나타내는 POLICY NAME 열이 포함됩니다.

    열에 마스킹 정책이 설정되어 있지 않거나 Snowflake 계정이 Enterprise Edition 이상이 아닌 경우 Snowflake는 NULL 을 반환합니다.

  • 이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 RESULT_SCAN 함수를 사용하면 됩니다.

예시 테이블 만들기:

CREATE TABLE emp (id NUMBER NOT NULL PRIMARY KEY, fname VARCHAR(50), lname VARCHAR(50), location VARCHAR(100));
Copy

테이블의 열 설명하기:

DESC TABLE emp;
Copy

테이블의 스테이지 속성 설명하기:

DESC TABLE emp TYPE = STAGE;
Copy

테이블 열에 설정된 마스킹 정책 확인하기:

DESC TABLE ssn_record;

---------------+-------------+--------+-------+---------+-------------+------------+--------+------------+---------+----------------------------+------------------+
      name     |    type     |  kind  | null? | default | primary key | unique key | check  | expression | comment |       policy name          |  privacy domain  |
---------------+-------------+--------+-------+---------+-------------+------------+--------+------------+---------+----------------------------+------------------+
EMPLOYEE_SSN_1 | VARCHAR(32) | COLUMN | Y     | [NULL]  | N           | N          | [NULL] | [NULL]     | [NULL]  | MY_DB.MY_SCHEMA.SSN_MASK_1 |     [NULL]       |
---------------+-------------+--------+-------+---------+-------------+------------+--------+------------+---------+----------------------------+------------------+
Copy