DESCRIBE ICEBERG TABLE

Apache 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

액세스 제어 요구 사항

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

권한

오브젝트

참고

SELECT

Iceberg 테이블

스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한. 스키마에 대한 모든 권한이 부여된 역할은 스키마를 확인할 수 있습니다. 예를 들어, 스키마에 대해 CREATE 권한을 부여받은 역할은 해당 스키마에 대한 USAGE 권한을 함께 부여받지 않더라도 해당 스키마에 대한 오브젝트를 생성할 수 있습니다.

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

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

사용법 노트

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

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

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

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

  • 이 명령은 Iceberg 테이블의 기반이 되는 델타 테이블에 대해 Iceberg 호환성 V2(icebergCompatV2)를 구성한 경우에만 NAME_MAPPING 열을 반환합니다.

    참고

    NAME_MAPPING 열을 보려면 계정에서 2025_01 동작 변경 번들도 활성화해야 합니다.

    계정에서 이 번들을 활성화 하려면 다음 문을 실행합니다.

    SELECT SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE('2025_01');
    Copy

  • 이 명령의 출력을 후처리하기 위해 파이프 연산자 (->>) 또는 RESULT_SCAN 함수를 사용할 수 있습니다. 두 구문 모두 출력을 쿼리할 수 있는 결과 세트로 간주합니다.

    이 명령의 출력 열 이름은 소문자로 생성됩니다. 파이프 연산자 또는 RESULT_SCAN 함수와 함께 이 명령의 결과 세트를 사용하는 경우 쿼리의 열 이름에 큰따옴표로 묶인 식별자 를 사용하여 스캔된 출력의 열 이름과 일치하도록 합니다. 예를 들어, 출력 열의 이름이 type 인 경우 식별자에 대해 "type" 을 지정합니다.

예

예시 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
언어: 한국어