SHOW ICEBERG TABLES

SHOW ICEBERG TABLES

SHOW ICEBERG TABLES 명령은 접근 권한(privilege)이 있는 Apache Iceberg™ 테이블 목록을 보여주는 명령이에요. 현재/지정한 데이터베이스·스키마 또는 계정 전체의 Iceberg 테이블을 나열할 수 있어요.

출처: 문서

본문

이 명령은 접근 권한이 있는 Iceberg 테이블을 나열해요. (Iceberg 테이블은 Snowflake 및 Apache Iceberg™ 호환 테이블 형식으로 관리되는 개방형 테이블 형식이에요.)

관련 명령: CREATE ICEBERG TABLE, ALTER ICEBERG TABLE, DROP ICEBERG TABLE, UNDROP ICEBERG TABLE, DESCRIBE ICEBERG TABLE.

구문 (Syntax)

SHOW ICEBERG TABLES
  [ LIKE '<pattern>' ]
  [ IN { ACCOUNT | DATABASE [ <db_name> ] | [ SCHEMA ] [ <schema_name> ] } ]
  [ STARTS WITH '<name_string>' ]
  [ LIMIT <rows> [ FROM '<name_string>' ] ]

(구체적인 구문은 Snowflake 문서를 참고해요.)

파라미터 (Parameters)

  • LIKE <pattern> — 명령 출력을 객체 이름으로 필터링해요. 대소문자를 구분하지 않는 패턴 매칭이며 SQL 와일드카드 문자(%와 _)를 지원해요.

  • IN { ACCOUNT | DATABASE [ <db_name> ] | [ SCHEMA ] [ <schema_name> ] } — 명령의 범위를 지정해요. 계정 전체, 지정한 데이터베이스, 또는 지정한 스키마의 Iceberg 테이블을 반환해요.

  • STARTS WITH <name_string> — 객체 이름의 시작 문자를 기준으로 출력을 필터링해요. 문자열은 작은따옴표로 묶어야 하며 대소문자를 구분해요.

  • LIMIT <rows> [ FROM <name_string> ] — 최대 행 수를 제한하면서 결과의 "페이지네이션"을 가능하게 해요.

출력 (Output)

명령 출력은 Iceberg 테이블 속성과 메타데이터를 제공해요. 출력 컬럼에는 생성 시간, 이름, 데이터베이스·스키마 이름, 소유자, 주석, 그리고 Iceberg 테이블 관련 속성(예: external volume, 카탈로그)이 포함돼요.

사용 참고 사항 (Usage notes)

  • Iceberg 테이블은 일반 표준 테이블과 동일한 SHOW 규칙을 따르며, 실행에 실행 중인 웨어하우스를 요구하지 않아요.
  • 현재 역할에 하나 이상의 접근 권한이 부여된 객체만 반환해요.
  • MANAGE GRANTS 권한은 보유자가 계정의 모든 객체를 볼 수 있게 해줘요. 기본적으로 ACCOUNTADMIN과 SECURITYADMIN 역할만 이 권한을 가져요.
  • 출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요.

예제 (Examples)

현재 스키마의 Iceberg 테이블을 나열해요:

SHOW ICEBERG TABLES;

더 알아보기 (Learn more)