SHOW BACKUP SETS

접근 권한이 있는 모든 백업 세트(backup sets)를 나열하는 명령이에요. 명령의 범위는 전체 계정, 또는 지정된 데이터베이스나 스키마가 될 수 있어요.

출처: 문서

본문

구문 (Syntax)

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

파라미터

LIKE 'pattern' — 객체 이름으로 명령 출력을 선택적으로 필터링해요. 대소문자 무시 패턴 매칭을 사용하며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.
[ IN ... ] — 명령의 범위를 선택적으로 지정해요:
- ACCOUNT 키워드를 지정하면 현재 계정의 모든 데이터베이스의 모든 스키마에 대한 레코드를 검색해요.
- DATABASE 키워드를 지정하면: db_name을 지정하면 지정된 데이터베이스의 모든 스키마에 대한 레코드를 검색. db_name을 지정하지 않으면 현재 데이터베이스가 있으면 그 데이터베이스의 모든 스키마, 없으면 계정의 모든 데이터베이스와 스키마를 검색.
- SCHEMA 키워드를 지정하면: 정규화된 스키마 이름(예: my_database.my_schema)을 지정하면 지정된 데이터베이스와 스키마를 검색. 정규화되지 않은 schema_name을 지정하면 현재 데이터베이스가 있으면 그 안에서 검색, 없으면 오류 표시. schema_name을 지정하지 않으면 현재 스키마/데이터베이스 상태에 따라 범위가 결정돼요.
STARTS WITH 'name_string' — 객체 이름 시작 부분의 문자를 기반으로 출력을 필터링해요. 문자열은 작은따옴표로 묶어야 하며 대소문자를 구분해요. 기본값: 없음.
LIMIT rows — 반환되는 최대 행 수를 선택적으로 제한하면서 결과의 "페이지네이션"을 가능하게 해요. 기본값: 없음.

사용 메모 (Usage notes)

이 명령은 명령 실행에 사용되는 역할의 접근 권한에 따라 지정된 객체 유형에 대해 최대 1만 개의 레코드를 반환해요. 필터를 적용해도 1만 레코드 한도를 초과하는 레코드는 반환되지 않아요. 1만 개 이상의 레코드가 있는 결과를 보려면 해당하는 Snowflake Information Schema 뷰를 쿼리해요.

출력 (Output)

Column	Description
created_on	백업 세트가 생성된 타임스탬프.
name	백업 세트의 이름.
database_name	백업 세트를 포함하는 데이터베이스의 이름.
schema_name	백업 세트를 포함하는 스키마의 이름.
object_kind	백업 세트가 백업하는 객체의 유형.
object_name	백업 세트가 백업하는 객체의 이름.
object_database_name	이 백업 세트가 백업하는 객체를 포함하는 데이터베이스의 이름.
object_schema_name	이 백업 세트가 백업하는 객체를 포함하는 스키마의 이름.
backup_policy_name	이 백업 세트에 연결된 백업 정책의 이름.
backup_policy_database_name	백업 정책을 포함하는 데이터베이스의 이름.
backup_policy_schema_name	백업 정책을 포함하는 스키마의 이름.
backup_policy_state	백업 정책의 현재 상태.
owner_role	백업 세트에 OWNERSHIP 권한이 있는 역할의 이름.
owner_role_type	백업 세트에 OWNERSHIP 권한이 있는 역할의 유형.
comment	백업 세트에 대한 주석.

예시 (Examples)

현재 계정에서 권한이 있는 모든 백업 세트를 나열해요:

SHOW BACKUP SETS IN ACCOUNT;

이름에 T1이 포함된 백업 세트를 나열해요:

SHOW BACKUP SETS LIKE '%T1%';

더 알아보기 (Learn more)

본문