ALTER FAILOVER GROUP¶
기존 장애 조치 그룹 의 속성을 수정합니다.
원본 계정에서 다음 작업을 수행할 수 있습니다.
장애 조치 그룹의 이름을 바꿉니다.
복제 및 장애 조치에 대해 활성화된 지정된 오브젝트 유형 목록을 재설정합니다.
보조 장애 조치 그룹의 자동 새로 고침을 위한 복제 일정을 설정하거나 업데이트합니다.
장애 조치 그룹에 다음 유형의 계정 오브젝트를 추가하거나 제거합니다.
데이터베이스
공유
보안 통합
API 통합
특정 유형의 알림 통합(통합 복제 참조)
복제 및 장애 조치가 활성화된 대상 계정을 추가하거나 제거합니다.
공유 또는 데이터베이스를 다른 장애 조치 그룹으로 이동합니다.
대상 계정에서 다음 작업을 수행할 수 있습니다.
원본 계정에서 대상 계정의 오브젝트를 새로 고칩니다.
보조 장애 조치 그룹을 기본으로 승격합니다(예: 오브젝트의 장애 조치 그룹 장애 조치).
예약된 복제를 일시 중단합니다.
예약된 복제를 재개합니다.
구문¶
원본 계정
ALTER FAILOVER GROUP [ IF EXISTS ] <name> RENAME TO <new_name>
ALTER FAILOVER GROUP [ IF EXISTS ] <name> SET
[ OBJECT_TYPES = <object_type> [ , <object_type> , ... ] ]
[ REPLICATION_SCHEDULE = '{ <num> MINUTE | USING CRON <expr> <time_zone> }' ]
ALTER FAILOVER GROUP [ IF EXISTS ] <name> SET
OBJECT_TYPES = INTEGRATIONS [ , <object_type> , ... ] ]
ALLOWED_INTEGRATION_TYPES = <integration_type_name> [ , <integration_type_name> ... ] ]
[ REPLICATION_SCHEDULE = '{ <num> MINUTE | USING CRON <expr> <time_zone> }' ]
ALTER FAILOVER GROUP [ IF EXISTS ] <name>
ADD <db_name> [ , <db_name> , ... ] TO ALLOWED_DATABASES
ALTER FAILOVER GROUP [ IF EXISTS ] <name>
MOVE DATABASES <db_name> [ , <db_name> , ... ] TO FAILOVER GROUP <move_to_fg_name>
ALTER FAILOVER GROUP [ IF EXISTS ] <name>
REMOVE <db_name> [ , <db_name> , ... ] FROM ALLOWED_DATABASES
ALTER FAILOVER GROUP [ IF EXISTS ] <name>
ADD <share_name> [ , <share_name> , ... ] TO ALLOWED_SHARES
ALTER FAILOVER GROUP [ IF EXISTS ] <name>
MOVE SHARES <share_name> [ , <share_name> , ... ] TO FAILOVER GROUP <move_to_fg_name>
ALTER FAILOVER GROUP [ IF EXISTS ] <name>
REMOVE <share_name> [ , <share_name> , ... ] FROM ALLOWED_SHARES
ALTER FAILOVER GROUP [ IF EXISTS ] <name>
ADD <org_name>.<target_account_name> [ , <org_name>.<target_account_name> , ... ] TO ALLOWED_ACCOUNTS
[ IGNORE EDITION CHECK ]
ALTER FAILOVER GROUP [ IF EXISTS ] <name>
REMOVE <org_name>.<target_account_name> [ , <org_name>.<target_account_name> , ... ] FROM ALLOWED_ACCOUNTS
대상 계정
ALTER FAILOVER GROUP [ IF EXISTS ] <name> REFRESH
ALTER FAILOVER GROUP [ IF EXISTS ] <name> PRIMARY
ALTER FAILOVER GROUP [ IF EXISTS ] <name> SUSPEND
ALTER FAILOVER GROUP [ IF EXISTS ] <name> RESUME
매개 변수¶
원본 계정
name
장애 조치 그룹의 식별자를 지정합니다.
RENAME TO new_name
new_name
장애 조치 그룹의 새 식별자를 지정합니다. 다른 복제 또는 장애 조치 그룹에 대해 식별자가 이미 있는 경우 새 식별자를 사용할 수 없습니다.
자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.
SET ...
장애 조치 그룹에 대해 설정할 하나 이상의 속성을 지정합니다(공백, 쉼표 또는 새 줄로 구분). 설정할 수 있는 속성에 대한 자세한 내용은 CREATE FAILOVER GROUP 를 참조하십시오.
ADD db_name [ , db_name , ... ] TO ALLOWED_DATABASES
복제 및 장애 조치에 사용할 추가 데이터베이스에 대한, 쉼표로 구분된 목록을 지정합니다. 데이터베이스를 추가하려면, 지정된 오브젝트 유형 목록에 DATABASES가 포함되어야 합니다. 오브젝트 유형 목록에 DATABASES가 아직 포함되어 있지 않으면 추가해야 합니다.
db_name
데이터베이스의 식별자를 지정합니다.
MOVE DATABASES db_name [ , db_name , ... ] TO FAILOVER GROUP move_to_fg_name
한 장애 조치 그룹에서 다른 장애 조치 그룹으로 이동할 데이터베이스에 대한, 쉼표로 구분된 목록을 지정합니다. 데이터베이스가 이동되는 장애 조치 그룹은 지정된 오브젝트 유형 목록에 DATABASES를 포함해야 합니다.
db_name
데이터베이스의 식별자를 지정합니다.
move_to_fg_name
데이터베이스가 이동되는 장애 조치 그룹의 식별자를 지정합니다.
REMOVE db_name [ , db_name , ... ] FROM ALLOWED_DATABASES
복제 및 장애 조치가 활성화된 데이터베이스 목록에서 제거할 데이터베이스에 대한, 쉼표로 구분된 목록을 지정합니다.
ADD share_name [ , share_name , ... ] TO ALLOWED_SHARES
복제 및 장애 조치에 사용할 추가 공유에 대한, 쉼표로 구분된 목록을 지정합니다. 공유를 추가하려면, 지정된 오브젝트 유형 목록에 SHARES가 포함되어야 합니다. 오브젝트 유형 목록에 SHARES가 아직 포함되어 있지 않으면 추가해야 합니다.
share_name
공유의 식별자를 지정합니다.
MOVE SHARES share_name [ , share_name , ... ] TO FAILOVER GROUP move_to_fg_name
한 장애 조치 그룹에서 다른 장애 조치 그룹으로 이동할 공유에 대한, 쉼표로 구분된 목록을 지정합니다. 공유가 이동되는 장애 조치 그룹은 지정된 오브젝트 유형 목록에 SHARES를 포함해야 합니다.
share_name
공유의 식별자를 지정합니다.
move_to_fg_name
공유가 이동되는 장애 조치 그룹의 식별자를 지정합니다.
REMOVE share_name [ , share_name , ... ] FROM ALLOWED_SHARES
복제 및 장애 조치가 활성화된 공유 목록에서 제거할 공유에 대한, 쉼표로 구분된 목록을 지정합니다.
ADD org_name.target_account_name [ , org_name.target_account_name , ... ] TO ALLOWED_ACCOUNTS
원본 계정의 지정된 오브젝트를 대상 계정으로 복제 및 장애 조치할 수 있도록 기본 장애 조치 그룹에 추가할 대상 계정에 대한, 쉼표로 구분된 목록을 지정합니다. 이 목록의 대상 계정에 있는 보조 장애 조치 그룹은 장애 조치 시 기본 장애 조치 그룹으로 승격될 수 있습니다.
org_name
Snowflake 조직의 이름입니다.
target_account_name
지정된 오브젝트의 복제를 활성화하는 대상 계정입니다.
REMOVE org_name.target_account_name [ , org_name.target_account_name , ... ] FROM ALLOWED_ACCOUNTS
원본 계정의 지정된 오브젝트를 대상 계정에 복제하는 것을 비활성화하기 위해 기본 장애 조치 그룹에서 제거할 대상 계정에 대한, 쉼표로 구분된 목록을 지정합니다. 대상 계정을 제거하면 현재 계정에서 이 대상 계정으로의 장애 조치가 비활성화됩니다.
org_name
Snowflake 조직의 이름입니다.
target_account_name
지정된 오브젝트의 복제를 비활성화하는 대상 계정입니다.
IGNORE EDITION CHECK
다음 시나리오에서 계정에 오브젝트를 복제할 수 있습니다.
기본 장애 조치 그룹이 Business Critical(또는 그 이상) 계정에 있고, HIPAA 및 HITRUST 규정에 따라 계정에 PHI 데이터를 저장하기 위한 서명된 비즈니스 제휴 계약이 있습니다. 하지만 Business Critical(또는 그 이상) 계정인지 여부와 관계없이, 복제가 승인된 하나 이상의 계정에 대해 이러한 계약이 마련되어 있지 않습니다.
이 시나리오는 기본적으로 금지됩니다.
대상 계정
secondary_name
장애 조치 그룹의 식별자를 지정합니다.
REFRESH
원본 계정에서 대상(현재) 계정의 오브젝트를 새로 고칩니다.
PRIMARY
보조 장애 조치 그룹, 그리고 대상(현재) 계정의 지정된 오브젝트를 기본(장애 조치의 경우)으로 승격합니다.
SUSPEND
보조 장애 조치 그룹의 예약된 새로 고침을 일시 중단합니다(
REPLICATION_SCHEDULE
속성을 사용하여 예약된 새로 고침이 기본 장애 조치 그룹에 있는 경우).RESUME
보조 장애 조치 그룹의 예약된 새로 고침을 재개합니다(
REPLICATION_SCHEDULE
속성을 사용하여 예약된 새로 고침이 기본 장애 조치 그룹에 있는 경우).
사용법 노트¶
다음과 같은 최소 권한이 필요합니다.
ALTER FAILOVER GROUP … REFRESH를 사용하여 보조 장애 조치 그룹을 새로 고치려면 역할에 장애 조치 그룹에 대한 OWNERSHIP 또는 REPLICATE 권한이 있어야 합니다.
ALTER FAILOVER GROUP … PRIMARY를 사용하여 보조 장애 조치 그룹을 장애 조치하려면 역할에는 장애 조치 그룹에 대한 OWNERSHIP 또는 FAILOVER 권한이 있어야 합니다.
장애 조치 그룹에 다른 변경 사항을 적용하려면, 그룹에 대한 OWNERSHIP 권한이 있는 역할만 이 SQL 명령을 실행할 수 있습니다.
장애 조치 그룹에 데이터베이스를 추가하려면 활성 역할에 데이터베이스에 대한 MONITOR 권한이 있어야 합니다.
장애 조치 그룹에 공유를 추가하려면 활성 역할에 공유에 대한 OWNERSHIP 권한이 있어야 합니다.
계정의 장애 조치 그룹 및 복제 그룹에 대한 식별자는 고유해야 합니다.
데이터베이스 및 공유 이외의 오브젝트는 동일한 장애 조치 그룹에 있어야 합니다.
데이터베이스는 하나의 장애 조치 그룹에만 추가할 수 있습니다.
새로 고침이 진행 중인 경우, 보조 장애 조치 그룹을 기본으로 승격(장애 조치의 경우)하는 데 실패합니다.
복제 일정이 업데이트될 때 새로 고침이 진행 중인 경우, 완료될 때까지 새로 고침이 계속되고, 다음 새로 고침은 새 일정을 사용합니다.
장애 조치 시, 모든 보조 장애 조치 그룹의 예약된 새로 고침이 일시 중단됩니다. 자동 새로 고침을 재개하려면 각 보조에서
ALTER FAILOVER GROUP ... RESUME
을 실행해야 합니다.한 장애 조치 그룹(이동 출처 그룹)에서 다른 장애 조치 그룹(이동 대상 그룹)으로 데이터베이스 또는 공유를 이동하려면:
두 그룹은 같은 유형, 즉 FAILOVER GROUP이어야 합니다.
이동 출처 그룹의 마지막 데이터베이스가 다른 그룹으로 이동되면 이동 출처 그룹의
allowed_databases
속성이 NULL로 설정됩니다. 동일한 동작이 공유에도 적용됩니다.object_types
목록에서 이동 중인 오브젝트 유형(databases
또는shares
)이 이동 대상 그룹에 없는 경우, 오브젝트를 이동하기 전에 해당 유형을 이동 대상 그룹에 명시적으로 추가해야 합니다.
복제가 활성화된 조직의 계정 목록을 검색하려면 SHOW REPLICATION ACCOUNTS 명령을 사용하십시오.
조직의 장애 조치 그룹 목록을 검색하려면 SHOW FAILOVER GROUPS 항목을 사용하십시오.
메타데이터 관련:
주의
고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.
예¶
원본 계정에서 실행됨¶
지정된 오브젝트의 복제, 그리고 원본 계정에서의 장애 조치가 활성화된 대상 계정 목록에 myorg.myaccount3
를 추가합니다.
ALTER FAILOVER GROUP myfg ADD myorg.myaccount3 TO ALLOWED_ACCOUNTS;
원본 계정에서 복제할 오브젝트 유형 목록을 재설정하고 데이터베이스 db1
추가:
ALTER FAILOVER GROUP myfg SET
OBJECT_TYPES = USERS, ROLES, WAREHOUSES, RESOURCE MONITORS, DATABASES
ALLOWED_DATABASES = db1;
데이터베이스 목록에 데이터베이스 db2
및 db3
추가:
ALTER FAILOVER GROUP myfg
ADD db2, db3 TO ALLOWED_DATABASES;
데이터베이스 db3
을 다른 장애 조치 그룹 myfg2
로 이동:
ALTER FAILOVER GROUP myfg
MOVE DATABASES db3 TO FAILOVER GROUP myfg2;
myfg
의 데이터베이스 db2
를 현재 데이터베이스가 없는 다른 장애 조치 그룹 myfg3
로 이동:
먼저
object_types
에databases
추가:ALTER FAILOVER GROUP myfg3 SET OBJECT_TYPES = DATABASES, SHARES;
db2
를myfg3
로 이동:ALTER FAILOVER GROUP myfg MOVE DATABASES db2 TO FAILOVER GROUP myfg3;
복제 및 장애 조치를 위해 원본 계정의 데이터베이스 목록에서 모든 데이터베이스를 제거합니다.
ALTER FAILOVER GROUP myfg
SET ALLOWED_DATABASES = NULL;
참고
위의 문을 실행하면, 복제할 데이터베이스 목록에서 모든 데이터베이스가 제거되지만, 복제 및 장애 조치를 위해 지정된 오브젝트 유형 목록에서 데이터베이스 오브젝트가 제거되지는 않습니다.
모든 데이터베이스의 복제 및 장애 조치를 비활성화하고 지정된 오브젝트 유형 목록에서 데이터베이스를 제거하려면 다음을 수행합니다.
ALTER FAILOVER GROUP myfg
REMOVE databases FROM OBJECT_TYPES;
자동으로 예약된 새로 고침 간격을 추가(또는 수정):
ALTER FAILOVER GROUP myfg
SET REPLICATION_SCHEDULE = '15 MINUTE';
대상 계정에서 실행됨¶
대상 계정의 장애 조치 그룹 myfg
에 있는 오브젝트 새로 고치기:
ALTER FAILOVER GROUP myfg REFRESH;
현재 대상 계정의 보조 장애 조치 그룹을 기본으로 승격:
ALTER FAILOVER GROUP myfg PRIMARY;
자동 새로 고침을 일시 중단:
ALTER FAILOVER GROUP myfg SUSPEND;