SHOW FAILOVER GROUPS

SHOW FAILOVER GROUPS

SHOW FAILOVER GROUPS 명령은 계정의 기본(primary)·보조(secondary) 장애 조치 그룹(failover group) 및 계정과 연결된 다른 계정의 장애 조치 그룹을 나열하는 명령이에요.

출처: 문서

본문

이 명령은 계정의 기본·보조 장애 조치 그룹과, 계정과 연결된 다른 계정의 장애 조치 그룹을 나열해요. 다른 계정에 대해서는:

  • 이 계정으로 복제·장애 조치(failover)가 활성화된 기본 장애 조치 그룹을 나열해요.
  • 이 계정의 그룹에 연결된 보조 장애 조치 그룹을 나열해요.

기능 상태: Business Critical 기능. Business Critical Edition 이상이 필요해요. 업그레이드 문의는 Snowflake 지원에 연락해요.

관련 명령: CREATE FAILOVER GROUP, ALTER FAILOVER GROUP, DROP FAILOVER GROUP.

구문 (Syntax)

SHOW FAILOVER GROUPS [ IN ACCOUNT <account> ]

파라미터 (Parameters)

출력 (Output)

명령은 다음 컬럼을 반환해요:

  • region_group — 계정이 위치한 리전 그룹. 참고: 여러 리전 그룹에 걸친 조직에서만 표시돼요.
  • snowflake_region — 계정이 위치한 Snowflake 리전.
  • created_on — 장애 조치 그룹이 생성된 날짜·시간.
  • account_name — 계정 이름.
  • name — 장애 조치 그룹 이름.
  • type — 그룹 유형. 유효한 값은 FAILOVER.
  • comment — 주석 문자열.
  • is_primary — 장애 조치 그룹이 기본 그룹인지 여부.
  • primary — 기본 그룹 이름.
  • object_types — 복제·장애 조치가 활성화된 지정 객체 유형 목록.
  • allowed_integration_types — 복제가 활성화된 통합 유형 목록. CREATE/ALTER FAILOVER GROUP 명령에서 통합을 지정하지 않았어도 출력에 항상 포함돼요.
  • allowed_accounts — 복제·장애 조치가 활성화된 계정 목록.
  • organization_name — Snowflake 조직 이름.
  • account_locator — 리전 내 계정 로케이터.
  • replication_schedule — 새로고침 예약 간격. 복제 일정이 설정되지 않았으면 NULL.
  • secondary_state — 예약된 새로고침의 현재 상태. 유효한 값은 started 또는 suspended. 복제 일정이 설정되지 않았으면 NULL.
  • next_scheduled_refresh — 다음 예약 새로고침 날짜·시간.
  • owner — 장애 조치 그룹에 OWNERSHIP 권한이 있는 역할 이름. 그룹이 다른 리전에 있으면 NULL.
  • is_listing_auto_fulfillment_group — 복제 그룹이 Cross-Cloud Auto-Fulfillment에 사용되면 TRUE, 아니면 FALSE.
  • is_optimized_refresh_enabled — 장애 조치 그룹에 최적화 새로고침(optimized refresh)이 활성화되어 있으면 TRUE, 아니면 FALSE. TRUE면 이후 새로고침이 최적화 새로고침으로, FALSE면 Replication Classic으로 실행돼요.

사용 참고 사항 (Usage notes)

  • 이 명령을 실행하려면 장애 조치 그룹에 다음 권한 중 하나가 있는 역할이 필요해요: FAILOVER, MONITOR, OWNERSHIP, REPLICATE.
  • SHOW FAILOVER GROUPS의 출력에는 type이 account인 그룹만 포함돼요.
  • 실행에 실행 중인 웨어하우스를 요구하지 않아요.
  • 현재 역할에 하나 이상의 접근 권한이 부여된 객체만 반환해요.
  • MANAGE GRANTS 권한은 보유자가 계정의 모든 객체를 볼 수 있게 해줘요. 기본적으로 ACCOUNTADMIN과 SECURITYADMIN 역할만 이 권한을 가져요.
  • 출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요. 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표로 감싸서 사용해요.

예제 (Examples)

myaccount1 계정의 장애 조치 그룹을 나열해요:

SHOW FAILOVER GROUPS IN ACCOUNT myaccount1;

더 알아보기 (Learn more)