Method: projects.locations.services.alterTableProperties

メタデータ テーブルのプロパティを変更します。

HTTP リクエスト

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

詳細については、認証の概要をご覧ください。