Method: projects.locations.services.alterTableProperties

變更中繼資料表屬性。

HTTP 要求

POST https://metastore.googleapis.com/v1beta/{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

詳情請參閱驗證總覽一文。