Method: projects.locations.services.alterTableProperties

更改元数据表属性。

HTTP 请求

POST https://metastore.googleapis.com/v1alpha/{service}:alterTableProperties

路径参数

参数
service

string

必需。用于更改元数据表属性的 Dataproc Metastore 服务的相对资源名称,格式如下:

projects/{projectId}/locations/{locationId}/services/{serviceId}

必须对指定的资源 service 具有以下 IAM 权限才能进行授权:

  • metastore.services.mutateMetadata

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "tableName": string,
  "updateMask": string,
  "properties": {
    string: string,
    ...
  }
}
字段
tableName

string

必需。包含要更改的房源的表的名称,格式如下。

databases/{database_id}/tables/{table_id}

updateMask

string (FieldMask format)

用于指定更新将覆盖的元数据表属性的字段掩码。updateMask 中指定的字段与资源相关,而不是与完整请求相关。如果字段在掩码中,则会被覆盖。

例如,假设目标属性如下:

properties {
  a: 1
  b: 2
}

以及更新属性:

properties {
  a: 2
  b: 3
  c: 4
}

则如果字段掩码为:

paths: ["properties.b", "properties.c"]

则结果将如下所示:

properties {
  a: 1
  b: 3
  c: 4
}

这是完全限定字段名称的逗号分隔列表。示例:"user.displayName,photo"

properties

map (key: string, value: string)

用于描述要更改的所需值的映射。如果 updateMask 为空,则系统不会更新相应媒体资源。否则,这些属性只会更改更新掩码中存在关联路径的值

包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

响应正文

如果成功,则响应正文包含一个 Operation 实例。

授权范围

需要以下 OAuth 范围:

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

如需了解详情,请参阅身份验证概览