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> , ... ] ]
  [ ALLOWED_DATABASES = <db_name> [ , <db_name> , ... ] ]
  [ ALLOWED_SHARES = <share_name> [ , <share_name> , ... ] ]
  [ REPLICATION_SCHEDULE = '{ <num> MINUTE | USING CRON <expr> <time_zone> }' ]
  [ ENABLE_ETL_REPLICATION = { TRUE | FALSE } ]

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 ...

장애 조치 그룹에 대해 설정할 속성을 지정합니다(공백, 쉼표 또는 새 줄로 구분).

OBJECT_TYPES = object_type [ , object_type , ... ]

원본 계정에서 대상 계정으로 복제 및 장애 조치를 활성화하는 오브젝트 유형의 목록을 재설정합니다.

참고

데이터베이스 및 공유 오브젝트:

• DATABASES 또는 SHARES가 OBJECT_TYPES 목록에 포함되어 있고 목록이 재설정된 후에도 OBJECT_TYPES 목록에 남아 있는 경우 허용되는 각 오브젝트 목록(ALLOWED_DATABASES 또는 ALLOWED_SHARES)은 변경되지 않은 상태로 남습니다.

• DATABASES를 추가하거나 제거하도록 OBJECT_TYPES 목록이 재설정되면 ALLOWED_DATABASES 목록이 NULL로 설정됩니다.

• SHARES를 추가하거나 제거하도록 OBJECT_TYPES 목록이 재설정되면 ALLOWED_SHARES 목록이 NULL로 설정됩니다.

• 허용된 데이터베이스 또는 공유 오브젝트 목록을 수정하려면 ADD, MOVE 및 REMOVE 절을 사용하십시오.

다음 오브젝트 유형이 지원됩니다.

ACCOUNT PARAMETERS

모든 계정 수준 매개 변수. 여기에는 계정 매개 변수, 그리고 귀하의 계정에 대해 설정 할 수 있는 매개 변수가 포함됩니다.

DATABASES

오브젝트 유형 목록에 데이터베이스 오브젝트를 추가합니다. 데이터베이스 오브젝트가 지정된 오브젝트 유형 목록에 이미 포함된 경우 ALLOWED_DATABASES 목록은 변경되지 않은 상태로 유지됩니다. 데이터베이스 목록을 수정하려면 ADD, MOVE 또는 REMOVE 절을 사용하십시오.

INTEGRATIONS

현재는 보안, API, 저장소, 특정 유형의 알림 통합만 지원됩니다. 자세한 내용은 통합 복제 섹션을 참조하십시오.

통합 오브젝트가 지정 오브젝트 유형 목록에 포함된 경우 ALLOWED_INTEGRATION_TYPES 매개 변수를 설정해야 합니다.

NETWORK POLICIES

원본 계정의 모든 네트워크 정책.

RESOURCE MONITORS

원본 계정의 모든 리소스 모니터.

ROLES

원본 계정의 모든 역할. 역할 복제에는 복제 그룹에 포함된 오브젝트 유형에 대한 모든 권한 부여가 암시적으로 포함됩니다. 예를 들어 ROLES 항목이 복제되는 유일한 오브젝트 유형인 경우, 역할 계층 구조(즉, 다른 역할에 부여된 역할)만 대상 계정에 복제됩니다. USERS 오브젝트 유형도 포함된 경우, 그러면 사용자에게 부여된 역할도 복제됩니다.

SHARES

오브젝트 유형 목록에 공유 오브젝트를 추가합니다. 공유 오브젝트가 지정된 오브젝트 유형 목록에 이미 포함된 경우 ALLOWED_SHARES 목록은 변경되지 않은 상태로 유지됩니다. 공유 목록을 수정하려면 ADD, MOVE 또는 REMOVE 절을 사용하십시오.

USERS

원본 계정의 모든 사용자.

WAREHOUSES

원본 계정의 모든 웨어하우스.

ALLOWED_DATABASES = db_name [ , db_name , ... ]

원본 계정에서 대상 계정으로 복제 및 장애 조치를 활성화하는 데이터베이스 또는 데이터베이스 목록을 지정합니다. 이 매개 변수를 설정하려면 OBJECT_TYPES 목록에 DATABASES 가 포함되어야 합니다.

db_name

데이터베이스의 식별자를 지정합니다.

ALLOWED_SHARES = share_name [ , share_name , ... ]

원본 계정에서 대상 계정으로 복제 및 장애 조치를 활성화하는 공유 또는 공유 목록을 지정합니다. 이 매개 변수를 설정하려면 OBJECT_TYPES 목록에 SHARES 가 포함되어야 합니다.

share_name

공유의 식별자를 지정합니다.

참고

ALLOWED_DATABASES 또는 ALLOWED_SHARES 목록이 수정되면 이전에 목록에 있었지만 제거된 오브젝트가 전부 다음 새로 고침 작업 발생 시 연결된 보조 장애 조치 그룹이 있는 대상 계정에서 삭제됩니다.

ALLOWED_INTEGRATION_TYPES = integration_type_name [ , integration_type_name , ... ]

원본 계정에서 대상 계정으로 복제 및 장애 조치를 활성화하는 통합 유형(들)입니다.

이 속성은 이 매개 변수를 설정하기 위해 OBJECT_TYPES 목록에 INTEGRATIONS 항목을 포함할 것을 요구합니다.

다음 통합 유형이 지원됩니다.

SECURITY INTEGRATIONS

보안 통합을 지정합니다.

이 속성은 OBJECT_TYPES 목록에 ROLES 항목을 포함할 것을 요구합니다.

API INTEGRATIONS

API 통합을 지정합니다.

API 통합 복제는 API 통합이 대상 계정에 복제된 후 추가 설정이 필요합니다. 자세한 내용은 API 통합을 위해 원격 서비스 업데이트하기 섹션을 참조하십시오.

NOTIFICATION INTEGRATIONS

알림 통합을 지정합니다.

일부 유형의 알림 통합만 복제됩니다. 자세한 내용은 통합 복제 섹션을 참조하십시오.

STORAGE INTEGRATIONS

저장소 통합을 지정합니다.

REPLICATION_SCHEDULE ...

보조 장애 조치 그룹을 새로 고치는 일정을 지정합니다.

• USING CRON expr time_zone

  보조 그룹 새로 고침에 대한 cron 식 및 타임존을 지정합니다. 표준 cron 유틸리티 구문의 서브세트를 지원합니다.

  타임존 목록은 (Wikipedia에서) tz 데이터베이스 타임존 목록 을 참조하십시오.

  cron 식은 다음 필드로 구성됩니다.

  # __________ minute (0-59)
  # | ________ hour (0-23)
  # | | ______ day of month (1-31, or L)
  # | | | ____ month (1-12, JAN-DEC)
  # | | | | __ day of week (0-6, SUN-SAT, or L)
  # | | | | |
  # | | | | |
    * * * * *
  

  다음 특수 문자가 지원됩니다.

  *

  와일드카드. 필드의 모든 발생을 지정합니다.

  L

  《last(마지막)》를 의미합니다. day-of-month(요일) 필드에 사용하면 해당 월의 《마지막 금요일》(《5L》)과 같은 구문을 지정할 수 있습니다. day-of-month 필드에서는 해당 월의 마지막 요일을 지정합니다.

  /n

  주어진 시간 단위의 n번째 인스턴스를 나타냅니다. 시간의 각 양은 독립적으로 계산됩니다. 예를 들어, 월 필드에 4/3 이 지정된 경우 새로 고침은 4월, 7월, 10월로 예약됩니다(즉, 해당 연도의 4번째 달부터 3개월마다). 다음 해에도 동일한 일정이 유지됩니다. 즉, 새로 고침은 1월(10월 실행 후 3개월)에 실행되도록 예약되지 않습니다.

  참고

  • cron 식은 현재 지정된 타임존에 대해서만 계산됩니다. 계정에 대한 TIMEZONE 매개 변수 값을 변경하는 것(또는 사용자 또는 세션 수준에서 값을 설정)은 새로 고침의 타임존을 변경하지는 않습니다.

  • cron 식은 새로 고침에 대한 모든 유효한 실행 시간을 정의합니다. Snowflake는 이 일정에 따라 보조 그룹을 새로 고치려고 시도합니다. 그러나 다음 유효한 실행 시간이 시작되기 전에 이전 실행이 완료되지 않은 경우, 유효한 실행 시간을 건너뜁니다.

  • 특정 일자와 요일이 cron 식에 포함된 경우, 일자 또는 요일 중 하나를 만족하는 날짜에 새로 고침이 예약됩니다. 예를 들어, SCHEDULE = 'USING CRON 0 0 10-20 * TUE,THU UTC' 는 해당 월의 10일에서 20일 사이에서 0AM에 새로 고침을 예약하고 해당 날짜 이외의 모든 화요일이나 목요일에도 작업을 예약합니다.

• num MINUTE

  새로 고침 사이의 대기 시간 간격(분)을 지정합니다. 양의 정수만 허용합니다.

  또한 num M 구문을 지원합니다.

  모호성을 피하기 위해 다음과 같은 경우에 기본 간격 시간 이 설정됩니다.

  • (CREATE <오브젝트>를 사용하여) 오브젝트를 생성할 때 또는

  • (ALTER <오브젝트> … SET REPLICATION_SCHEDULE을 사용하여) 다른 간격을 설정할 때

  기본 간격 시간은 현재 시계 시간부터 간격 카운터를 시작합니다. 예를 들어, 10 의 INTERVAL 값이 설정되고, 예약된 새로 고침이 오전 9:03에 활성화된 경우 새로 고침은 오전 9:13, 오전 9:23와 같은 방식으로 실행됩니다. 당사는 절대 정밀도를 보장하기 위해 최선을 다하지만, 설정된 간격이 발생하기 전에 새로 고침이 실행되지 않는다는 것만 보장합니다(예: 현재 예에서 새로 고침은 오전 9:14에 처음 실행될 수 있지만, 오전 9:12에는 확실히 실행되지 않음).

  참고

  지원되는 최대값은 11520 (8일)입니다. 복제 일정이 더 큰 num MINUTE 값을 가질 경우 새로 고침 작업이 실행되지 않습니다.

ENABLE_ETL_REPLICATION = { TRUE | FALSE }

이 복제 그룹에 대해 스테이지, 파이프 및 로드 기록 복제 를 활성화해야 할지 여부를 지정합니다.

• TRUE 를 지정하면 스테이지, 파이프 및 로드 기록에 대한 복제가 활성화됩니다.

• FALSE 를 지정하면 스테이지, 파이프 및 로드 기록에 대한 복제가 차단됩니다.

기본값: FALSE.

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(또는 그 이상) 계정인지 여부와 관계없이, 복제가 승인된 하나 이상의 계정에 대해 이러한 계약이 마련되어 있지 않습니다.

이 시나리오는 기본적으로 금지됩니다.

대상 계정

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)이 이동 대상 그룹에 없는 경우, 오브젝트를 이동하기 전에 해당 유형을 이동 대상 그룹에 명시적으로 추가해야 합니다.

• (ALLOWED_DATABASES 또는 ALLOWED_SHARES 목록 수정을 위해 REMOVE 매개 변수 또는 SET 매개 변수를 사용하여) 기본 장애 조치 그룹에서 데이터베이스 또는 공유 오브젝트를 제거하면 다음 새로 고침 작업 발생 시 해당 오브젝트가 모든 대상 계정에서 삭제됩니다.

  다음에 수정된 기본 장애 조치 그룹이 대상 계정에 복제되기 전에 보조 장애 조치 그룹을 삭제하면 대상 계정에서 이러한 오브젝트의 삭제를 방지할 수 있습니다.

• 복제가 활성화된 조직의 계정 목록을 검색하려면 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;