SHOW REPLICATION DATABASES

SHOW REPLICATION DATABASES

계정의 모든 기본(primary) 및 보조(secondary) 데이터베이스(즉, 복제가 활성화된 모든 데이터베이스)를 나열하고 각 데이터베이스가 위치한 리전을 표시하는 명령이에요.

출처: 문서

본문

계정의 모든 기본 및 보조 데이터베이스(즉, 복제가 활성화된 모든 데이터베이스)를 나열하고 각 데이터베이스가 위치한 리전을 표시해요.

구문

SHOW REPLICATION DATABASES [ LIKE '<pattern>' ]
                           [ WITH PRIMARY <account_identifier>.<primary_db_name> ]

매개변수

LIKE 'pattern'

선택적으로 객체 이름으로 명령 출력을 필터링해요. 필터는 SQL 와일드카드 문자(%와 _)를 지원하며 대소문자를 구분하지 않는 패턴 매칭을 사용해요. 예를 들어 다음 패턴들은 같은 결과를 반환해요:

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

기본값: 값 없음(출력에 필터링이 적용되지 않음).

WITH PRIMARY {account_identifier}.{primary_db_name}

명령의 범위를 지정해요. 지정된 기본 데이터베이스에 대한 레코드만 나열할지 여부가 결정돼요. account_identifier는 org_name.account_name 또는 snowflake_region.account_locator 형태일 수 있어요. 자세한 내용은 복제·장애 조치용 계정 식별자(Account identifiers for replication and failover)를 참고해요.

출력

명령 출력은 기본 및 보조 데이터베이스 속성과 메타데이터를 다음 컬럼으로 제공해요. 여러 리전 그룹에 걸친 조직의 명령 출력에는 추가 region_group 컬럼이 포함돼요.

컬럼 설명
region_group 계정이 위치한 리전 그룹이에요. 참고: 이 컬럼은 여러 리전 그룹에 걸친 조직에만 표시돼요.
snowflake_region 데이터베이스를 저장한 계정이 위치한 Snowflake Region이에요. Snowflake Region은 클라우드 플랫폼 리전 내의 고유한 위치로, 다른 Snowflake Region과 격리되어 있어요. 멀티 테넌트 또는(Virtual Private Snowflake 계정의 경우) 단일 테넌트일 수 있어요.
created_on 데이터베이스가 생성된 날짜와 시각이에요.
account_name 데이터베이스를 저장한 계정의 이름이에요.
name 데이터베이스의 이름이에요.
comment 데이터베이스에 대한 주석이에요.
is_primary 데이터베이스가 기본 데이터베이스인지 여부이고, 그렇지 않으면 보조 데이터베이스예요.
primary 리전, 계정, 데이터베이스 이름을 포함한 기본 데이터베이스의 정규화된 이름이에요.
replication_allowed_to_accounts IS_PRIMARY가 TRUE인 경우, 이 기본 데이터베이스에 복제가 활성화된 계정의 정규화된 이름을 보여 줘요. 이 각 계정에 보조 데이터베이스를 만들 수 있어요.
failover_allowed_to_accounts IS_PRIMARY가 TRUE인 경우, 이 기본 데이터베이스에 장애 조치(failover)가 활성화된 계정의 정규화된 이름을 보여 줘요. 비즈니스 연속성과 재해 복구를 위해 이 각 계정에 보조 데이터베이스를 만들 수 있어요.
organization_name Snowflake 조직의 이름이에요.
account_locator 한 리전 안의 계정 로케이터예요.

사용 메모

  • 데이터베이스에 대한 권한(예: USAGE 또는 MONITOR)이 있는 역할에 대해 결과를 반환해요.
  • 이 명령은 실행에 웨어하우스가 필요하지 않아요.
  • 이 명령은 현재 사용자의 현재 역할에 액세스 권한이 하나 이상 부여된 객체만 반환해요.
  • MANAGE GRANTS 액세스 권한은 보유자에게 계정의 모든 객체를 볼 수 있는 권한을 암묵적으로 부여해요. 기본적으로 계정 관리자(ACCOUNTADMIN 역할)와 보안 관리자(SECURITYADMIN 역할)만 MANAGE GRANTS 권한을 가져요.
  • 이 명령의 출력을 후처리하려면 파이프 연산자(->>)나 RESULT_SCAN 함수를 사용할 수 있어요. 두 구성 모두 출력을 쿼리할 수 있는 결과 집합으로 취급해요. 예를 들어 SHOW 명령 출력에서 특정 컬럼을 선택하거나 행을 필터링할 수 있어요.
  • 출력 컬럼을 참조할 때는 큰따옴표로 묶은 식별자를 사용해요. 예를 들어 type 출력 컬럼을 선택하려면 SELECT "type"이라고 지정해요. SHOW 명령의 출력 컬럼 이름은 소문자이므로 큰따옴표로 묶은 식별자를 사용해야 해요.
  • 이 명령은 명령을 실행하는 역할의 액세스 권한에 따라 지정한 객체 유형에 대해 최대 1만 개의 레코드를 반환해요. 1만 개 제한을 초과하는 레코드는 필터가 적용돼도 반환되지 않아요. 1만 개를 초과하는 결과를 보려면 Snowflake 정보 스키마의 해당 뷰(존재하는 경우)를 쿼리해요.

예제

mydb로 시작하는 이름을 가진 모든 복제 데이터베이스 표시:

SHOW REPLICATION DATABASES LIKE 'mydb%';

각각 org, account, 기본 데이터베이스인 myorg.account1.mydb1의 모든 보조 데이터베이스 표시:

SHOW REPLICATION DATABASES WITH PRIMARY myorg.account1.mydb1;

더 알아보기 (Learn more)