SHOW HYBRID TABLES

SHOW HYBRID TABLES

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

출처: 문서

본문

이 명령은 접근 권한이 있는 하이브리드 테이블을 나열해요. 하이브리드 테이블은 온라인 트랜잭션 처리(OLTP) 워크로드를 지원하는 테이블로, 이 명령으로 정의된 테이블들을 확인할 수 있어요.

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

구문 (Syntax)

SHOW HYBRID 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> ] } — 명령의 범위를 지정해요. 계정 전체, 지정한 데이터베이스, 또는 지정한 스키마의 하이브리드 테이블을 반환해요.

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

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

Output (출력)

명령 출력은 하이브리드 테이블 속성과 메타데이터를 제공해요. 출력 컬럼에는 생성 시간, 이름, 데이터베이스·스키마 이름, 소유자, 주석, 그리고 하이브리드 테이블 관련 속성이 포함돼요.

사용 참고 사항 (Usage notes)

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

예제 (Examples)

현재 스키마의 하이브리드 테이블을 나열해요:

SHOW HYBRID TABLES;

더 알아보기 (Learn more)