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

ID。リソース名。形式: projects/{project_id_or_number}/catalogs/{catalogId}

description

string

省略可。カタログの説明を保存します。最大文字数は 4,000 文字です。

locationUri

string

必須。カタログが存在する Cloud Storage のロケーション パス。形式: gs://bucket/path/to/catalog 最大長は 4,000 文字です。

replicas[]

object (Replica)

出力専用。カタログ メタデータのレプリカ。

createTime

string (Timestamp format)

出力専用。カタログの作成日時。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

updateTime

string (Timestamp format)

出力専用。カタログの更新日時。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「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)

出力専用。レプリカの現在の状態。

状態

カタログが複数のリージョンに複製されている場合、この列挙型はレプリカの現在の状態を表します。

列挙型
STATE_UNSPECIFIED レプリカの状態が不明です。
STATE_PRIMARY レプリカが書き込み可能なプライマリであることを示します。
STATE_PRIMARY_IN_PROGRESS レプリカが最近プライマリとして割り当てられたが、まだすべてのデータベースが書き込み可能になっていないことを示します。
STATE_SECONDARY レプリカが読み取り専用のセカンダリ レプリカであることを示します。

メソッド

create

新しい Hive カタログを作成します。

delete

カタログ ID で指定された既存のカタログを削除します。

failover

カタログを新しいプライマリ レプリカ リージョンにフェイルオーバーします。

get

リソース名で指定されたカタログを取得します。

list

指定したプロジェクトのすべてのカタログを一覧表示します。

patch

既存のカタログを更新します。