ALTER BACKUP SET¶

백업 세트의 속성을 수정합니다. 이 작업은 다음 중 하나일 수 있습니다.

백업 세트의 일부가 되는 새 백업 만들기.
백업 세트에서 이전 백업 제거.
백업 정책에 지정된 예약된 백업 및 예약된 백업 삭제 일시 중단 또는 재개.
아직 정책이 없는 백업 세트에 백업 정책 적용.
백업 세트 내의 특정 백업에 대한 법적 보존 추가 또는 제거.
Renaming the backup set.
백업 세트에 대한 설명 지정 또는 제거.

참고 항목:: CREATE BACKUP SET, DROP BACKUP SET, SHOW BACKUP SETS

구문¶

ALTER BACKUP SET <name> ADD BACKUP

ALTER BACKUP SET <name> APPLY BACKUP POLICY <policy_name> [ FORCE ]

ALTER BACKUP SET <name> SUSPEND BACKUP [ { CREATION | EXPIRATION } ] POLICY

ALTER BACKUP SET <name> RESUME BACKUP [ { CREATION | EXPIRATION } ] POLICY

ALTER BACKUP SET <name> DELETE BACKUP IDENTIFIER '<backup_id>'

ALTER BACKUP SET <name> MODIFY BACKUP IDENTIFIER '<backup_id>' { ADD | REMOVE } LEGAL HOLD

ALTER BACKUP SET <name> RENAME TO <new_name>

ALTER BACKUP SET <name> SET COMMENT = '<string_literal>'

ALTER BACKUP SET <name> UNSET COMMENT

ALTER BACKUP SET <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER BACKUP SET <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

Copy

매개 변수¶

name

백업 세트에 대한 식별자를 지정합니다.

식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

ADD BACKUP

세트에 백업을 수동으로 생성합니다. 백업 정책에 새 백업을 수행하는 일정이 포함되어 있지 않은 경우 백업 세트에 포함된 테이블, 스키마 또는 데이터베이스의 새 백업을 만드는 방법입니다. 백업이 정기적으로 수행되는 경우에도 언제든지 백업 세트에서 새 백업을 만들 수도 있습니다.

APPLY BACKUP POLICY policy_name [ FORCE ]

백업 세트에 연결할 백업 정책을 지정합니다.

FORCE 옵션은 백업 세트의 기존 정책을 덮어씁니다. 이전 정책에 보존 잠금이 없는 경우에만 이 옵션을 사용할 수 있습니다.

중요

보존 잠금이 설정된 백업 정책을 백업 세트에 적용하면 되돌릴 수 없습니다. 규정 준수에 필요한 강력한 보장으로 인해 백업 세트에 보존 잠금을 설정한 후에는 잠금을 취소할 수 없습니다. Snowflake 지원도 이러한 보존 잠금을 취소할 수 없습니다. 만료 기간이 긴 백업 세트에 보존 잠금을 설정하기 전에 신중하게 계획하여 삭제할 수 없는 백업 세트 및 이를 포함하는 스키마와 데이터베이스에 예기치 않은 저장소 요금이 부과되지 않도록 하세요.

Snowflake 조직이 삭제되면 해당 조직은 더 이상 Snowflake 고객이 아닙니다. 이 경우 Snowflake는 보존 잠금이 설정된 스냅샷을 포함하여 모든 스냅샷을 삭제합니다. 이 경우 Snowflake는 보존 잠금이 설정된 백업을 포함하여 모든 백업을 삭제합니다. Snowflake 조직을 삭제하려면 Snowflake 지원의 참여가 필요합니다. 관리자가 실수로 삭제할 수 없습니다.

SUSPEND BACKUP [ { CREATION | EXPIRATION } ] POLICY

백업 세트에서 백업 정책을 일시 중단합니다. 전체 백업 정책을 일시 중단하거나 생성 또는 만료 작업만 일시 중단할 수 있습니다. CREATION 또는 EXPIRATION 키워드 없이 SUSPEND BACKUP POLICY를 지정하는 경우 Snowflake는 정책의 생성 및 만료 측면을 모두 일시 중단합니다. 자세한 내용은 백업 세트에 대한 백업 정책 일시 중단하기 섹션을 참조하십시오.

RESUME BACKUP [ { CREATION | EXPIRATION } ] POLICY

세트에서 일시 중단된 백업 정책을 재개합니다. 전체 백업 정책을 재개하거나 생성 또는 만료 작업만 재개할 수 있습니다. CREATION 또는 EXPIRATION 키워드 없이 RESUME BACKUP POLICY를 지정하는 경우 Snowflake는 정책의 생성 및 만료 측면을 모두 재개합니다. 자세한 내용은 백업 세트에 대한 백업 정책 재개하기 섹션을 참조하십시오.

DELETE BACKUP IDENTIFIER 'backup_id'

ID에 의해 설정된 백업에서 백업을 삭제합니다. 백업 ID는 UUID_STRING 함수에서 반환된 형식의 UUID 값입니다. Snowflake는 백업 세트에서 가장 오래된 백업만 삭제할 수 있습니다. 자세한 내용은 백업 세트에서 백업 삭제하기 섹션을 참조하십시오.

MODIFY BACKUP IDENTIFIER 'backup_id' { ADD | REMOVE } LEGAL HOLD

백업 세트 내의 지정된 백업에서 법적 보존을 추가하거나 제거합니다. WORM 백업의 법적 보존에 대한 자세한 내용은 법적 보존 섹션을 참조하세요. 이 절을 사용하는 예제는 법적 보존 추가 및 제거하기 섹션을 참조하세요.

RENAME TO new_name

Specifies a new identifier for the backup set; must be unique for your account.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

SET COMMENT = 'string_literal'

설명을 백업 세트와 연결합니다.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

태그 이름과 태그 문자열 값을 지정합니다.

태그 값은 항상 문자열이며, 태그 값의 최대 문자 수는 256자입니다.

문에서 태그를 지정하는 방법에 대한 자세한 내용은 Tag quotas 섹션을 참조하십시오.

UNSET ...

백업 세트에 대해 설정 해제할 하나 이상의 속성 및/또는 매개 변수를 지정하여 기본값으로 재설정합니다.

property_name
param_name
- COMMENT
- TAG tag_name [ , tag_name ... ]

단일 ALTER 문으로 여러 속성/매개 변수를 재설정할 수 있지만, 각 속성/매개 변수는 쉼표로 구분해야 합니다. 또한, 속성/매개 변수를 재설정할 때는 이름만 지정하며 값은 필요하지 않습니다.

액세스 제어 요구 사항¶

이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한	설명
OWNERSHIP	백업 세트를 수정하는 데 사용되는 역할에는 백업 세트에 대한 OWNERSHIP 권한이 있어야 합니다.
APPLY BACKUP RETENTION LOCK	백업 세트에 적용된 백업 정책에 보존 잠금이 포함된 경우 정책을 적용하는 데 사용되는 역할은 계정에 대해 이 권한이 있어야 합니다.
APPLY LEGAL HOLD	이 계정 권한은 백업에서 법적 보존을 추가하거나 제거할 수 있는 권한을 부여합니다. 이 권한은 ADD LEGAL HOLD 및 REMOVE LEGAL HOLD 절에 대해서만 필요합니다. 기본적으로 ACCOUNTADMIN 역할에는 이 권한이 있습니다.
APPLY	백업 정책에 대해 이 권한이 있는 사용자만 APPLY BACKUP POLICY 절에 ALTER BACKUP SET 명령을 사용하여 이미 존재하는 백업 세트에 백업 정책을 추가할 수 있습니다.

이러한 권한은 보조 역할이 아닌 현재 활성 상태인 기본 역할에 필요합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트¶

메타데이터 관련:

주의

고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.

중요

백업 정책에 보존 잠금이 적용되어 있고 백업 세트에 만료되지 않은 백업이 있는 경우 백업 세트를 삭제할 수 없습니다. 이 경우 세트의 모든 백업이 만료될 때까지 기다려야 합니다. 이 제한은 ACCOUNTADMIN과 같은 권한이 있는 역할과 Snowflake 지원에도 적용됩니다. 따라서 백업 정책에서 보존 잠금과 긴 만료 기간을 지정할 때는 주의해야 합니다.

예¶

백업 세트 ``t1_backups``에 수동으로 백업 추가하기:

ALTER BACKUP SET t1_backups
  ADD BACKUP;

Copy

백업 세트 ``t1_backups``에 대한 백업 정책 업데이트하기:

ALTER BACKUP SET t1_backups
  APPLY BACKUP POLICY daily_backup_policy;

Copy

백업 세트 ``t1_backup``에 대한 백업 정책 일시 중단하기:

ALTER BACKUP SET t1_backups
  SUSPEND BACKUP POLICY;

Copy

백업 세트 ``t1_backups``에 대한 백업 정책 재개하기:

ALTER BACKUP SET t1_backups
  RESUME BACKUP POLICY;

Copy

Rename the backup set t1_backups to table1_backups:

ALTER BACKUP SET t1_backups
  RENAME TO table1_backups;

Copy

ADD LEGAL HOLD 및 REMOVE LEGAL HOLD 절과 함께 사용할 백업 식별자를 찾으려면 일반적으로 SHOW BACKUPS 명령을 사용하여 적합한 백업과 생성 시간을 나열합니다. 다음 예제에서는 적절한 백업을 나열하고, 하나의 특정 백업에 법적 보존을 추가하고, 나중에 해당 법적 보존을 제거하는 방법을 보여줍니다. 자신의 역할 이름, 백업 세트 이름, 백업 식별자로 바꿉니다.

USE ROLE my_legal_hold_role; -- use a role that has the APPLY LEGAL HOLD privilege
SHOW BACKUPS IN BACKUP SET my_db_backup_set
  ->> SELECT "created_on", "backup_id" FROM $1 WHERE "is_under_legal_hold" = 'N';
ALTER BACKUP SET my_db_backup_set
  MODIFY BACKUP IDENTIFIER '790d1ee4-88b2-451f-9ccc-eacd1e93a134'
  ADD LEGAL HOLD;

USE ROLE my_legal_hold_role; -- use a role that has the APPLY LEGAL HOLD privilege
SHOW BACKUPS IN BACKUP SET my_db_backup_set
  ->> SELECT "created_on", "backup_id" FROM $1 WHERE "is_under_legal_hold" = 'Y';
ALTER BACKUP SET my_db_backup_set
  MODIFY BACKUP IDENTIFIER '790d1ee4-88b2-451f-9ccc-eacd1e93a134'
  REMOVE LEGAL HOLD;

Copy