REST Resource: hive.v1.projects.catalogs

资源:HiveCatalog

HiveCatalog 包含 BigLake Metastore 中的 Spark/Hive 数据库和表。在目录中创建资源时,最好确保存储桶位置、Spark/Hive 引擎位置或任何其他计算位置相匹配。Catalog 可视为将本地 Hive Metastore 迁移到 Google Cloud 的目标位置。

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

可选。存储目录说明。长度上限为 4000 个字符。

locationUri

string

必需。目录所在的 Cloud Storage 位置路径。格式:gs://bucket/path/to/catalog 长度上限为 4,000 个字符。

replicas[]

object (Replica)

仅限输出。目录元数据的副本。

createTime

string (Timestamp format)

仅限输出。目录的创建时间。

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 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 规范化(即转换为 UTC 零时区格式并在末尾附加 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

删除指定的 Hive 目录。

failover

将指定的 Hive 目录故障切换到新的主副本区域。

get

获取指定 Hive 目录的详细信息。

list

列出指定项目中的所有 Hive 目录。

patch

更新指定项目中的现有 Hive 目录。