SHOW DATASETS

SHOW DATASETS

SHOW DATASETS 명령은 계정의 데이터셋(dataset) 정보를 표시하는 명령이에요. 모든 데이터셋을 보여주거나 IN 하위 명령을 사용해 스키마·데이터베이스 수준으로 결과를 제한할 수 있어요.

출처: 문서

본문

이 명령은 계정의 데이터셋에 대한 정보를 표시해요.

관련 명령: CREATE DATASET, ALTER DATASET.

구문 (Syntax)

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

선택 파라미터 (Optional parameters)

  • LIKE <pattern> — 반환되는 데이터셋 목록을 지정한 패턴과 일치하는 것으로 제한해요.
  • IN { SCHEMA <schema_name> | DATABASE <db_name> | ACCOUNT } — 계정 내 지정한 스키마 또는 데이터베이스의 데이터셋으로 반환 목록을 제한해요.
    • DATABASE db_name — 지정한 데이터베이스의 데이터셋으로 제한. 데이터베이스가 사용 중이 아닌데 db_name 없이 지정하면 키워드가 출력에 영향을 주지 않아요.
    • SCHEMA schema_name — 기본적으로 사용 중인 스키마의 레코드를 반환하며, schema_name을 지정할 수도 있어요.
  • STARTS WITH <name_string> — 지정한 문자열을 사용해 반환되는 데이터셋을 제한해요. 반환되는 데이터셋의 이름은 지정한 문자열과 같은 시작 문자를 가져요.
  • LIMIT <rows> [ FROM <name_string> ] — 반환되는 데이터셋 수를 지정한 행 수로 제한해요. 선택적 FROM 절은 반환되는 데이터셋의 시작점을 지정해요.

접근 제어 요구 사항 (Access control requirements)

이 작업을 실행하는 역할은 최소한 다음 권한을 가져야 해요:

권한 (Privilege) 객체 (Object) 비고
OWNERSHIP 또는 USAGE 데이터셋 계정 내 데이터셋을 표시할 권한 제공

스키마의 객체를 조작하려면 상위 데이터베이스에 최소 하나, 상위 스키마에 최소 하나의 권한이 필요해요. 커스텀 역할을 만드는 방법은 커스텀 역할 만들기를, 역할·권한 부여 일반 정보는 Access Control 개요를 참고해요.

예제 (Examples)

PUBLIC 스키마의 데이터셋 두 개를 표시해요:

SHOW DATASETS IN SCHEMA PUBLIC LIMIT 2;

더 알아보기 (Learn more)