SHOW REPLICATION GROUPS
SHOW REPLICATION GROUPS
복제 그룹(replication group)과 장애 조치 그룹(failover group)에 대한 정보를 표시하는 명령이에요.
출처: 문서
본문
Standard & Business Critical 기능: 데이터베이스와 공유(share) 복제는 모든 계정에서 사용할 수 있어요. 다른 계정 객체의 복제 및 장애 조치/복귀(failback)에는 Business Critical Edition(또는 그 이상)이 필요해요. 업그레이드 문의는 Snowflake 지원팀에 연락해요.
복제 그룹과 장애 조치 그룹에 대한 정보를 표시해요.
- 이 계정의 각 기본 또는 보조 복제/장애 조치 그룹을 나열해요.
- 이 계정으로의 복제가 활성화된 다른 계정의 기본 복제 및 장애 조치 그룹을 나열해요.
- 이 계정의 그룹에 연결된 다른 계정의 보조 복제 및 장애 조치 그룹을 나열해요.
구문
SHOW REPLICATION GROUPS [ IN ACCOUNT <account> ]
매개변수
account
계정의 식별자를 지정해요.
출력
명령은 다음 컬럼을 반환해요:
| 컬럼 | 설명 |
|---|---|
| region_group | 계정이 위치한 리전 그룹이에요. 참고: 이 컬럼은 여러 리전 그룹에 걸친 조직에서만 볼 수 있어요. |
| snowflake_region | 계정이 위치한 Snowflake Region이에요. Snowflake Region은 클라우드 플랫폼 리전 내의 고유한 위치로, 다른 Snowflake Region과 격리되어 있어요. 멀티 테넌트 또는(Virtual Private Snowflake 계정의 경우) 단일 테넌트일 수 있어요. |
| created_on | 복제 또는 장애 조치 그룹이 생성된 날짜와 시각이에요. |
| account_name | 계정의 이름이에요. |
| name | 복제 또는 장애 조치 그룹의 이름이에요. |
| type | 그룹의 유형이에요. 유효한 값은 REPLICATION 또는 FAILOVER예요. |
| comment | 주석 문자열이에요. |
| is_primary | 복제 또는 장애 조치 그룹이 기본 그룹인지 여부를 나타내요. |
| primary | 기본 그룹의 이름이에요. |
| object_types | 복제(FAILOVER 그룹의 경우 장애 조치도)가 활성화된 지정 객체 유형의 목록이에요. |
| allowed_integration_types | 복제가 활성화된 통합(integration) 유형의 목록이에요. Snowflake는 CREATE |
| allowed_accounts | 복제와 장애 조치가 활성화된 계정 목록이에요. |
| organization_name | Snowflake 조직의 이름이에요. |
| account_locator | 한 리전 안의 계정 로케이터예요. |
| replication_schedule | 새로 고침(refresh)을 위한 예약 간격이에요. 복제 일정이 설정되지 않았으면 NULL이에요. |
| secondary_state | 예약된 새로 고침의 현재 상태예요. 유효한 값은 started 또는 suspended예요. 복제 일정이 설정되지 않았으면 NULL이에요. |
| next_scheduled_refresh | 다음 예약된 새로 고침의 날짜와 시각이에요. |
| owner | 복제 또는 장애 조치 그룹에 대한 OWNERSHIP 권한이 있는 역할의 이름이에요. 복제 또는 장애 조치 그룹이 다른 리전에 있으면 NULL이에요. |
| is_listing_auto_fulfillment_group | 복제 그룹이 Cross-Cloud Auto-Fulfillment에 사용되면 TRUE, 그렇지 않으면 FALSE예요. |
사용 메모
- 이 명령을 실행하려면 복제 그룹에 대한 다음 권한 중 하나를 가진 역할이 필요해요:
MONITOROWNERSHIPREPLICATE
- SHOW REPLICATION GROUPS의 출력에는 FAILOVER 및 REPLICATION 유형의 그룹이 포함돼요.
- 이 명령은 실행에 웨어하우스가 필요하지 않아요.
- 이 명령은 현재 사용자의 현재 역할에 액세스 권한이 하나 이상 부여된 객체만 반환해요.
MANAGE GRANTS액세스 권한은 보유자에게 계정의 모든 객체를 볼 수 있는 권한을 암묵적으로 부여해요. 기본적으로 계정 관리자(ACCOUNTADMIN 역할)와 보안 관리자(SECURITYADMIN 역할)만MANAGE GRANTS권한을 가져요.- 이 명령의 출력을 후처리하려면 파이프 연산자(
->>)나RESULT_SCAN함수를 사용할 수 있어요. 두 구성 모두 출력을 쿼리할 수 있는 결과 집합으로 취급해요. 예를 들어 SHOW 명령 출력에서 특정 컬럼을 선택하거나 행을 필터링할 수 있어요. - 출력 컬럼을 참조할 때는 큰따옴표로 묶은 식별자를 사용해요. 예를 들어
type출력 컬럼을 선택하려면SELECT "type"이라고 지정해요. SHOW 명령의 출력 컬럼 이름은 소문자이므로 큰따옴표로 묶은 식별자를 사용해야 해요.
예제
myaccount1의 복제 그룹 나열:
SHOW REPLICATION GROUPS IN ACCOUNT myaccount1;
+------------------+-------------------------------+--------------+------+----------+---------+------------+-----------------------+---------------------------------------------+---------------------------+----------------------------------------------+-------------------+-------------------+----------------------+-----------------+-------------------------------+---------+-----------------------------------+
| snowflake_region | created_on | account_name | name | type | comment | is_primary | primary | object_types | allowed_integration_types | allowed_accounts | organization_name | account_locator | replication_schedule | secondary_state | next_scheduled_refresh | owner | is_listing_auto_fulfillment_group |
+------------------+-------------------------------+--------------+------+----------+---------+------------+-----------------------+---------------------------------------------+---------------------------+----------------------------------------------+-------------------+-------------------+----------------------+-----------------+-------------------------------+---------+-----------------------------------+
| AWS_US_EAST_1 | 2021-10-25 19:08:15.209 -0700 | MYACCOUNT1 | MYFG | FAILOVER | | true | MYORG.MYACCOUNT1.MYFG | DATABASES, ROLES, USERS, WAREHOUSES, SHARES | | MYORG.MYACCOUNT1.MYFG,MYORG.MYACCOUNT2.MYFG | MYORG | MYACCOUNT1LOCATOR | 10 MINUTE | | | MYROLE | false |
+------------------+-------------------------------+--------------+------+----------+---------+------------+-----------------------+---------------------------------------------+---------------------------+----------------------------------------------+-------------------+-------------------+----------------------+-----------------+-------------------------------+---------+-----------------------------------+
| AWS_US_WEST_2 | 2021-10-25 19:08:15.209 -0700 | MYACCOUNT2 | MYFG | FAILOVER | | false | MYORG.MYACCOUNT1.MYFG | | | | MYORG | MYACCOUNT2LOCATOR | 10 MINUTE | STARTED | 2022-03-06 12:10:35.280 -0800 | NULL | false |
+------------------+-------------------------------+--------------+------+----------+---------+------------+-----------------------+---------------------------------------------+---------------------------+----------------------------------------------+-------------------+-------------------+----------------------+-----------------+-------------------------------+---------+-----------------------------------+