Method: hive.v1.projects.catalogs.failover

카탈로그를 새 기본 복제본 리전으로 장애 조치합니다.

HTTP 요청


POST https://biglake.googleapis.com/hive/v1/{name=projects/*/catalogs/*}:failover

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. 'projects/{projectId}/catalogs/{catalogId}' 형식의 카탈로그 이름

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "primaryReplica": string,
  "validateOnly": boolean,
  "conditionalFailoverReplicationTime": string
}
필드
primaryReplica

string

필수 항목입니다. 새 기본 복제본 리전으로 할당되는 리전입니다. 예: 'us-east1' 카탈로그의 복제본 목록에서 '보조'로 표시된 복제본 리전 중 하나여야 합니다.
validateOnly

boolean

(선택사항) 설정한 경우 요청만 검증하고 업데이트를 실행하지는 않습니다. 이는 장애 조치를 수행하기 전 등 언제든지 replicationTime을 검사하는 데 사용할 수 있습니다.
conditionalFailoverReplicationTime

string (Timestamp format)

(선택사항) 설정되지 않은 경우 데이터 손실 없이 소스 리전의 모든 데이터가 새 기본 리전으로 복제될 때까지 기다린 후 장애 조치를 완료합니다('소프트 장애 조치'라고도 함). 설정된 경우 이 타임스탬프 이후에 소스 리전에서 커밋되었지만 아직 복제되지 않은 데이터의 손실을 수용하면서 즉시 장애 조치합니다. 이 시간 전에 커밋된 데이터가 복제되지 않은 경우 장애 조치가 실행되지 않고 오류가 반환됩니다('강제 장애 조치'라고도 함).

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

응답 본문

catalogs.failover의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "replicationTime": string
}
필드
replicationTime

string (Timestamp format)

출력 전용입니다. 모든 네임스페이스와 테이블 메타데이터가 new primaryReplica로 지정된 리전에 복제된 최소 타임스탬프입니다. 일부 리소스는 이 타임스탬프보다 최근에 복제되었을 수 있습니다. 비어 있으면 복제본이 방금 생성되었으며 아직 완전히 초기화되지 않은 것입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.