ALTER FAILOVER GROUP¶

구문¶

원본 계정

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_accounts 목록에 나열된 동일 계정이 있어야 합니다.

  • 이동 출처 그룹의 마지막 데이터베이스가 다른 그룹으로 이동되면 이동 출처 그룹의 allowed_databases 속성이 NULL로 설정됩니다. 동일한 동작이 공유에도 적용됩니다.

  • object_types 목록에서 이동 중인 오브젝트 유형(databases 또는 shares)이 이동 대상 그룹에 없는 경우, 오브젝트를 이동하기 전에 해당 유형을 이동 대상 그룹에 명시적으로 추가해야 합니다.

• 복제가 활성화된 조직의 계정 목록을 검색하려면 SHOW REPLICATION ACCOUNTS 명령을 사용하십시오.

• 조직의 장애 조치 그룹 목록을 검색하려면 SHOW FAILOVER GROUPS 항목을 사용하십시오.

• 메타데이터 관련:

  주의

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

예¶

ALTER FAILOVER GROUP myfg ADD myorg.myaccount3 TO ALLOWED_ACCOUNTS;

ALTER FAILOVER GROUP myfg SET
  OBJECT_TYPES = USERS, ROLES, WAREHOUSES, RESOURCE MONITORS, DATABASES
  ALLOWED_DATABASES = db1;

ALTER FAILOVER GROUP myfg
  ADD db2, db3 TO ALLOWED_DATABASES;

ALTER FAILOVER GROUP myfg
  MOVE DATABASES db3 TO FAILOVER GROUP myfg2;

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';

ALTER FAILOVER GROUP myfg REFRESH;

ALTER FAILOVER GROUP myfg PRIMARY;

ALTER FAILOVER GROUP myfg SUSPEND;