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
}

필드 마스크가 다음과 같은 경우:

경로: ["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

자세한 내용은 인증 개요를 참조하세요.