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 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 bigquery.reservations.listFailoverDatasets 권한이 포함되어 있습니다. INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION 뷰를 쿼리하는 데 필요합니다.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

스키마

INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION 뷰에는 다음과 같은 스키마가 있습니다.
열 유형 설명
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

replication_time 값은 데이터 세트의 비활성 상태를 나타냅니다.

복제본의 일부 테이블이 이 타임스탬프보다 이전일 수 있습니다. 이 값은 보조 리전에서만 표시됩니다.

데이터 세트에 스트리밍 데이터가 있는 테이블이 포함된 경우 replication_time 값이 정확하지 않습니다.
sync_status JSON 리전 간 복제 및 재해 복구 데이터 세트를 위한 기본 복제본과 보조 복제본 간 동기화 상태입니다. 복제본이 기본 복제본이거나 데이터 세트에서 복제를 사용하지 않는 경우 NULL을 반환합니다.
replica_primary_assignment_time TIMESTAMP 복제본으로의 기본 전환이 트리거된 시간입니다.
replica_primary_assignment_completion_time TIMESTAMP 복제본으로의 기본 전환이 완료된 시간입니다.

안정성을 위해 와일드 카드 (SELECT *)를 사용하는 대신 정보 스키마 쿼리에 열을 명시적으로 나열하는 것이 좋습니다. 열을 명시적으로 나열하면 기본 스키마가 변경될 때 쿼리가 중단되지 않습니다.

범위 및 구문

이 뷰에 대한 쿼리에는 리전 한정자가 있어야 합니다. 다음 표에는 이 뷰의 리전 범위가 나와 있습니다.

뷰 이름 리소스 범위 리전 범위
[RESERVATION_PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION[_BY_PROJECT] 프로젝트 수준 REGION
다음을 바꿉니다.
  • 선택사항: PROJECT_ID: Google Cloud 프로젝트의 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} |
+--------------+--------------+--------------+----------+--------------------------+-------------------------------------+---------------------+-------------------+---------------------+---------------------------------+---------------------------+-------------------------------------------------------------------------------+