This operation updates the metadata of a table.
Operation description
This operation supports only MaxCompute tables.
Try it now
Test
RAM authorization
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 and 1. The value 0 indicates the development environment. The value 1 indicates the production environment. |
1 |
| TableGuid |
string |
No |
The GUID of the table. Specify the GUID in the format of odps.{projectName}.{tableName}. |
odps.test.table1 |
| NewOwnerId |
string |
No |
The new owner ID. If you leave this parameter empty, the owner ID is not updated. |
12345 |
| AddedLabels |
string |
No |
The names of the labels that you want to add. Separate the labels with commas (,). |
a,b,c |
| RemovedLabels |
string |
No |
The names of labels that you want to remove. Separate the labels with commas (,). |
a,b,c |
| CategoryId |
integer |
No |
The ID of the category that you want to associate. |
101 |
| Visibility |
integer |
No |
The scope in which the table is visible. Valid values: 0, 1, and 2. The value 0 indicates that the table is invisible to all members. The value 1 indicates that the table is visible to all members. The value 2 indicates that the table is visible to workspace members. |
1 |
| Caption |
string |
No |
The display name of the table. |
Display name |
| Schema |
string |
No |
The schema information about the table. You must configure this parameter if you enable the three-layer model of MaxCompute. |
default |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| UpdateResult |
boolean |
Indicates whether the metadata information about the table 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.