Updates the metadata information about a table.
Debugging
Authorization information
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| ProjectId | long | Yes | The DataWorks workspace ID. | 101 |
| TableName | string | Yes | The name of the table. | table1 |
| EnvType | integer | Yes | 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 | long | 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. | test |
| 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 parameters
Examples
Sample success responses
JSONformat
{
"UpdateResult": true,
"RequestId": "abcde"
}Error codes
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 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. | - |
| 500 | InternalError.System | An internal system error occurred. Try again later. | - |
| 500 | InternalError.UserId.Missing | An internal system error occurred. Try again later. | - |
For a list of error codes, visit the Service error codes.
Change history
| Change time | Summary of changes | Operation |
|---|