DESCRIBE ICEBERG TABLE

Iceberg 테이블 의 열 또는 Iceberg 테이블 속성의 기본값은 물론이고 현재 값도 설명합니다.

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

이 항목에서는 Iceberg 테이블 이라고 명시하여 혼동을 피하는 경우를 제외하고는 Iceberg 테이블을 단순히 ‘테이블’로 지칭한다는 점에 유의하십시오.

참고 항목:

ALTER ICEBERG TABLE, DROP ICEBERG TABLE, CREATE ICEBERG TABLE, SHOW ICEBERG TABLES

구문

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

매개 변수

name

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

TYPE = COLUMNS | STAGE

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

기본값: TYPE = COLUMNS

액세스 제어 요구 사항

이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한

오브젝트

참고

SELECT

Iceberg 테이블

스키마의 모든 오브젝트에 대해 작업하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한도 필요합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트

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

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

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

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

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

예시 Iceberg 테이블을 만듭니다.

CREATE OR REPLACE ICEBERG TABLE my_iceberg_table
  CATALOG='my_catalog_integration'
  EXTERNAL_VOLUME='my_ext_volume'
  METADATA_FILE_PATH='path/to/metadata/v2.metadata.json';
Copy

테이블의 열 설명하기:

DESC ICEBERG TABLE my_iceberg_table ;
Copy