REST Resource: hive.v1.projects.catalogs

리소스: HiveCatalog

HiveCatalog에는 BigLake Metastore의 Spark/Hive 데이터베이스와 테이블이 포함되어 있습니다. 카탈로그에서 리소스를 만들 때 스토리지 버킷 위치, Spark / Hive 엔진 위치 또는 기타 컴퓨팅 위치가 일치하는 것이 좋습니다. 카탈로그는 온프레미스 Hive 메타스토어를 GCP로 마이그레이션하기 위한 대상으로 볼 수 있습니다.

JSON 표현 
{
  "name": string,
  "description": string,
  "locationUri": string,
  "replicas": [
    {
      object (Replica)
    }
  ],
  "createTime": string,
  "updateTime": string
}
필드
name

string

식별자. 리소스 이름입니다. 형식: projects/{project_id_or_number}/catalogs/{catalogId}
description

string

(선택사항) 카탈로그 설명을 저장합니다. 최대 길이는 4,000자입니다.
locationUri

string

필수 항목입니다. 카탈로그가 있는 Cloud Storage 위치 경로입니다. 형식: gs://버킷/카탈로그/경로 최대 길이는 4,000자입니다.
replicas[]

object (Replica)

출력 전용입니다. 카탈로그 메타데이터의 복제본입니다.
createTime

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"입니다.
updateTime

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"입니다.

복제본

카탈로그의 복제본입니다.

JSON 표현 
{
  "region": string,
  "state": enum (State)
}
필드
region

string

출력 전용입니다. 복제본의 리전입니다. 예를 들면 us-east1입니다.
state

enum (State)

출력 전용입니다. 복제본의 현재 상태입니다.

주

카탈로그가 여러 리전에 복제된 경우 이 enum은 복제본의 현재 상태를 설명합니다.

열거형
STATE_UNSPECIFIED 복제본 상태를 알 수 없습니다.
STATE_PRIMARY 복제본이 쓰기 가능한 기본 복제본임을 나타냅니다.
STATE_PRIMARY_IN_PROGRESS 복제본이 최근에 기본으로 할당되었지만 아직 일부 데이터베이스는 쓰기 가능하지 않음을 나타냅니다.
STATE_SECONDARY 복제본이 읽기 전용 보조 복제본임을 나타냅니다.

메서드

create

 새 Hive 카탈로그를 만듭니다.

delete

 카탈로그 ID로 지정된 기존 카탈로그를 삭제합니다.

failover

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

get

 리소스 이름으로 지정된 카탈로그를 가져옵니다.

list

 지정된 프로젝트의 모든 카탈로그를 나열합니다.

patch

 기존 카탈로그를 업데이트합니다.