SHOW BACKUPS IN BACKUP SET
SHOW BACKUPS IN BACKUP SET
백업 세트(backup set) 안의 모든 백업을 나열하는 명령이에요.
출처: 문서
본문
구문 (Syntax)
SHOW BACKUPS IN BACKUP SET <name>
[ LIMIT <rows> ]
파라미터
- name — 백업 세트의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 묶어야 해요. 큰따옴표로 묶은 식별자는 대소문자를 구분해요.
- LIMIT rows — 반환되는 최대 행 수를 선택적으로 제한하면서 결과의 "페이지네이션"을 가능하게 해요. 기본값: 없음.
접근 제어 요구사항 (Access control requirements)
이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한이 있어야 해요:
| Privilege | Notes |
|---|---|
| OWNERSHIP | 백업 세트에 포함된 백업을 보려면 그 백업 세트에 OWNERSHIP 권한이 있어야 해요. |
사용 메모 (Usage notes)
- 이 명령은 명령 실행에 사용되는 역할의 접근 권한에 따라 지정된 객체 유형에 대해 최대 1만 개의 레코드를 반환해요. 필터를 적용해도 1만 레코드 한도를 초과하는 레코드는 반환되지 않아요.
출력 (Output)
| Column | Description |
|---|---|
| created_on | 백업이 생성된 타임스탬프. |
| backup_id | Snowflake가 생성한 백업 식별자. UUID_STRING 함수가 반환하는 형식의 UUID 값. |
| backup_set_name | 백업을 포함하는 백업 세트의 이름. |
| database_name | 백업 세트를 포함하는 데이터베이스의 이름. |
| schema_name | 백업 세트를 포함하는 스키마의 이름. |
| expire_on | 백업이 만료되는 타임스탬프. |
| comment | 백업에 대한 주석. |
예시 (Examples)
백업 세트 t1_backups의 모든 백업을 나열해요:
SHOW BACKUPS IN BACKUP SET t1_backups;
백업 세트 t1_backups에서 가장 오래된 백업의 생성 날짜와 백업 ID를 표시해요:
SHOW BACKUPS IN BACKUP SET t1_backups ->>
SELECT "created_on", "backup_id" FROM $1
ORDER BY "created_on" LIMIT 1;
백업 세트 t1_backups에서 마지막 백업이 만료될 날짜와 시간, 그리고 백업 ID를 표시해요. 이 예시는 백업 정책에 일정이 없거나 백업 세트에 대해 백업 정책이 일시 중지되어 더 이상 백업이 추가되지 않는다고 가정해요. 기존 백업이 모두 만료될 때까지 기다린 뒤 백업 세트를 삭제하려는 상황이에요.
SHOW BACKUPS IN BACKUP SET t1_backups ->>
SELECT "expire_on", "backup_id" FROM $1
ORDER BY "expire_on" DESC LIMIT 1;