UpdateMetaTable

Updated at:

Updates the metadata of a table.

Operation description

Only MaxCompute tables are supported.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

ProjectId

integer

No

The DataWorks workspace ID.

101

TableName

string

No

The name of the table.

table1

EnvType

integer

No

The environment of the DataWorks workspace. Valid values: 0 (development) and 1 (production).

1

TableGuid

string

No

The GUID of the table, in the format of odps.{projectName}.{tableName}.

odps.test.table1

NewOwnerId

string

No

The new owner ID. If not specified, the owner ID remains unchanged.

12345

AddedLabels

string

No

The labels to add, separated by commas (,).

a,b,c

RemovedLabels

string

No

The labels to remove, separated by commas (,).

a,b,c

CategoryId

integer

No

The ID of the category to associate.

101

Visibility

integer

No

The visibility scope of the table. Valid values: 0 (invisible to all members), 1 (visible to all members), and 2 (visible to workspace members only).

1

Caption

string

No

The display name of the table.

Display name

Schema

string

No

The schema of the table. Required if the three-layer model of MaxCompute is enabled.

default

Response elements

Element

Type

Description

Example

object

UpdateResult

boolean

Indicates whether the table metadata was updated.

true

RequestId

string

The request ID.

abcde

Examples

Success response

JSON format

{
  "UpdateResult": true,
  "RequestId": "abcde"
}

Error codes

HTTP status code

Error code

Error message

Description

500 InternalError.System An internal system error occurred. Try again later.
500 InternalError.UserId.Missing An internal system error occurred. Try again later.
403 Forbidden.Access Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition. No permission, please authorize
429 Throttling.Api The request for this resource has exceeded your available limit.
429 Throttling.Api.Risk The request for this resource has exceeded your daily available limit.
429 Throttling.System The DataWorks system is busy. Try again later.
429 Throttling.User Your request is too frequent. Try again later.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.