SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION 뷰
INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION 뷰에는 장애 조치 예약과 연결된 스키마 복제본에 관한 정보가 포함됩니다. INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION 뷰는 데이터 세트가 포함된 프로젝트로 범위가 지정되는 INFORMATION_SCHEMA.SCHEMATA_REPLICAS 뷰와 달리 페일오버 예약의 프로젝트로 범위가 지정됩니다.
필요한 역할
INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION 뷰를 쿼리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 BigQuery 리소스 뷰어 (roles/bigquery.resourceViewer) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
스키마
INFORMATION_SCHEMA.SCHEMATA_REPLICAS 뷰에는 데이터 세트 복제본에 대한 정보가 포함됩니다.
INFORMATION_SCHEMA.SCHEMATA_REPLICAS 뷰에는 다음과 같은 스키마가 있습니다.
| 열 | 유형 | 설명 |
|---|---|---|
failover_reservation_project_id |
STRING |
복제본과 연결된 경우 페일오버 예약 관리 프로젝트의 프로젝트 ID입니다. |
failover_reservation_name |
STRING |
복제본과 연결된 경우 페일오버 예약의 이름입니다. |
catalog_name |
STRING |
데이터 세트가 포함된 프로젝트의 프로젝트 ID |
schema_name |
STRING |
데이터 세트의 데이터 세트 ID입니다. |
replica_name |
STRING |
복제본의 이름입니다. |
location |
STRING |
복제본이 생성된 리전 또는 멀티 리전입니다. |
replica_primary_assigned |
BOOL |
값이 TRUE이면 복제본에 기본 할당이 있는 것입니다. |
replica_primary_assignment_complete |
BOOL |
값이 TRUE이면 기본 할당이 완료된 것입니다.
값이 FALSE이면 replica_primary_assigned가 TRUE와 동일하더라도 복제본이 기본 복제본이 (아직) 아닙니다. |
creation_time |
TIMESTAMP |
복제본 생성 시간입니다. 복제본이 처음 생성될 때는 creation_complete가 TRUE가 될 때까지 기본 복제본과 완전히 동기화되지 않습니다. creation_time 값은 creation_complete가 TRUE가 되기 전에 설정됩니다. |
creation_complete |
BOOL |
값이 TRUE이면 보조 복제본에 대한 기본 복제본의 초기 전체 동기화가 완료된 것입니다. |
replication_time |
TIMESTAMP |
복제본의 일부 테이블이 이 타임스탬프보다 이전일 수 있습니다. 이 값은 보조 리전에서만 표시됩니다. 데이터 세트에 스트리밍 데이터가 있는 테이블이 포함된 경우 |
sync_status |
JSON |
기본 복제본과 보조 복제본 간의 동기화 상태입니다. 복제본이 기본 복제본인 경우 NULL를 반환합니다. |
범위 및 구문
이 뷰에 대한 쿼리에는 리전 한정자가 있어야 합니다. 다음 표에는 이 뷰의 리전 범위가 나와 있습니다.
| 뷰 이름 | 리소스 범위 | 리전 범위 |
|---|---|---|
[RESERVATION_PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION[_BY_PROJECT] |
프로젝트 수준 | REGION |
선택사항:
RESERVATION_PROJECT_ID: 예약의 관리 프로젝트 ID입니다. 지정하지 않으면 기본 프로젝트가 사용됩니다.REGION: 모든 데이터 세트 리전 이름입니다. 예를 들면`region-us`입니다.
예시
이 섹션에는 INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION 뷰의 쿼리 예시가 나열됩니다.
예시: 한 리전의 모든 복제된 데이터 세트 나열
다음 예시는 US 리전에 있는 모든 복제된 데이터 세트를 나열합니다.
SELECT * FROM `region-us`.INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION WHERE failover_reservation_name = "failover_reservation";
결과는 다음과 비슷합니다.
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+
| catalog_name | schema_name | replica_name | location | replica_primary_assigned | replica_primary_assignment_complete | creation_time | creation_complete | replication_time | failover_reservation_project_id | failover_reservation_name | sync_status |
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+
| project2 | test_dataset | us-east4 | us-east4 | true | true | 2024-05-09 20:34:06 | true | NULL | project1 | failover_reservation | NULL |
| project2 | test_dataset | us | US | false | false | 2024-05-09 20:34:05 | true | 2024-05-10 18:31:06 | project1 | failover_reservation | {"last_completion_time":"2024-06-06 18:31:06","error_time":null,"error":null} |
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+