SHOW BACKUP POLICIES

접근 권한이 있는 계정의 모든 백업 정책(backup policies)을 나열하는 명령이에요.

출처: 문서

본문

구문 (Syntax)

SHOW BACKUP POLICIES
   [ 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 뷰를 쿼리해요.
백업 정책이 백업 세트와 연결되어 있는지 확인하려면 SHOW BACKUP SETS 명령을 사용해요.
백업 정책은 특정 스키마와 데이터베이스 안의 객체예요. 따라서 정책을 포함하는 스키마와 데이터베이스에 대해 해당 작업이 수행될 때 정책도 복제, 삭제, undrop 등이 돼요. 백업 세트와 연결되어 있어 백업 정책을 삭제할 수 없다면, 정책을 포함하는 스키마나 데이터베이스도 삭제할 수 없어요.

출력 (Output)

Column	Description
created_on	백업 정책이 생성된 타임스탬프.
name	백업 정책의 이름.
database_name	백업 정책을 포함하는 데이터베이스의 이름.
schema_name	백업 정책을 포함하는 스키마의 이름.
owner	백업 정책에 OWNERSHIP 권한이 있는 역할의 이름.
comment	백업 정책에 대한 주석.
schedule	백업 생성 일정.
expire_after_days	백업 생성 후 백업이 만료될 때까지의 일수.
has_retention_lock	정책에 보존 잠금(retention lock)이 포함되어 있는지 여부. 있으면 Y, 없으면 N.
owner	백업 세트에 OWNERSHIP 권한이 있는 역할의 이름.
owner_role_type	백업 정책에 OWNERSHIP 권한이 있는 역할의 유형.

예시 (Examples)

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

SHOW BACKUP POLICIES IN ACCOUNT;

더 알아보기 (Learn more)

본문