DESCRIBE ICEBERG TABLE
DESCRIBE ICEBERG TABLE
DESCRIBE ICEBERG TABLE 명령은 Apache Iceberg™ 테이블의 컬럼이나 현재 값, 그리고 Iceberg 테이블 속성의 기본값을 설명하는 명령이에요. DESCRIBE는 DESC로 줄여 쓸 수 있습니다.
본문
Apache Iceberg™ 테이블의 컬럼 또는 Iceberg 테이블 속성의 현재 값과 기본값을 설명하는 명령입니다. DESCRIBE는 DESC로 줄여 쓸 수 있어요. 이 주제에서는 혼동을 피하기 위해 특별히 Iceberg 테이블을 지칭할 때를 제외하고는 Iceberg 테이블을 그냥 "테이블"이라고 부릅니다.
관련 명령: ALTER ICEBERG TABLE, DROP ICEBERG TABLE, CREATE ICEBERG TABLE, SHOW ICEBERG TABLES
Syntax
DESC[RIBE] [ ICEBERG ] TABLE <name> [ TYPE = { COLUMNS | STAGE } ]
Parameters
name— 설명할 테이블의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 감싸야 합니다. 큰따옴표로 감싼 식별자는 대소문자를 구분해요.TYPE = { COLUMNS | STAGE }— 테이블의 컬럼을 표시할지, 테이블의 스테이지 속성(현재 값과 기본값 포함)을 표시할지 지정해요. 기본값:TYPE = COLUMNS
Access control requirements (접근 제어 요구 사항)
이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 보유해야 해요.
스키마의 객체를 조작하려면 상위 데이터베이스에 대한 권한과 상위 스키마에 대한 권한이 각각 최소 하나씩 필요합니다. 지정된 권한 집합으로 사용자 정의 역할을 만드는 방법은 Creating custom roles 문서를, 보안 객체에 대한 SQL 작업의 역할·권한 부여에 대한 일반적인 정보는 Overview of Access Control 문서를 참고하세요.
Example (예제)
예시 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';
테이블의 컬럼을 설명해 봅시다.
DESC ICEBERG TABLE my_iceberg_table ;