All Products
Search
Document Center

DataWorks:GetMetaTableChangeLog

Last Updated:Sep 03, 2024

Queries the change logs of a metatable.

Operation description

Note This operation will be replaced soon. We recommend that you do not call this operation.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
PageNumberintegerNo

The page number.

1
PageSizeintegerNo

The number of entries per page. Default value: 10. Maximum value: 100.

10
TableGuidstringYes

The GUID of the table. Specify the GUID in the odps.projectName.tableName format. You can call the GetMetaDBTableList operation to query the GUID.

Note To query the change logs of a MaxCompute table, you must call the GetMetaTableChangeLog operation.
odps.engine_name.table_name
ChangeTypestringNo

The type of the change. Valid values: CREATE_TABLE, ALTER_TABLE, DROP_TABLE, ADD_PARTITION, and DROP_PARTITION.

ALTER_TABLE
ObjectTypestringNo

The entity on which the change is made. Valid values: TABLE and PARTITION.

TABLE
StartDatestringNo

The beginning of the time range to query. Specify the time in the yyyy-MM-dd HH:mm:ss format.

  • By default, the system uses the current time as the value of this parameter if the time that you specify is invalid.
  • If both the values of the StartDate and EndDate parameters are invalid, the system automatically queries the change logs that are generated within the last 30 days.
2020-06-01 00:00:00
EndDatestringNo

The end of the time range to query. Specify the time in the yyyy-MM-dd HH:mm:ss format.

  • By default, the system uses the current time as the value of this parameter if the time that you specify is invalid.
  • If both the values of the StartDate and EndDate parameters are invalid, the system automatically queries the change logs that are generated within the last 30 days.
2020-06-02 00:00:00

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

HttpStatusCodeinteger

The HTTP status code.

200
ErrorMessagestring

The error message.

The connection does not exist.
RequestIdstring

The request ID.

0bc1ec92159376
Successboolean

Indicates whether the request was successful.

true
ErrorCodestring

The error code.

Invalid.Tenant.ConnectionNotExists
Dataobject

The business data.

PageNumberinteger

The page number.

10
PageSizeinteger

The number of entries per page. Default value: 10. Maximum value: 100.

1
TotalCountlong

The total number of metatables.

10
DataEntityListarray<object>

The list of instances.

object
ObjectTypestring

The entity on which the change was made. Valid values: TABLE and PARTITION.

TABLE
ModifiedTimelong

The time when the metatable was modified.

1590722845000
CreateTimelong

The time when the metatable was created.

1590722845000
ChangeContentstring

The content of the change.

"[{\"action\":\"ADD_COLUMN\",\"value\":[{\"originName\":\"\",\"originType\":\"\",\"originComment\":\"\",\"name\":\"id\",\"type\":\"struct<name:string>\",\"comment\":\"\"}]}]",
Operatorstring

The name of the operator.

abc
ChangeTypestring

The type of the change.

CREATE_TABLE

Examples

Sample success responses

JSONformat

{
  "HttpStatusCode": 200,
  "ErrorMessage": "The connection does not exist.",
  "RequestId": "0bc1ec92159376",
  "Success": true,
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Data": {
    "PageNumber": 10,
    "PageSize": 1,
    "TotalCount": 10,
    "DataEntityList": [
      {
        "ObjectType": "TABLE",
        "ModifiedTime": 1590722845000,
        "CreateTime": 1590722845000,
        "ChangeContent": "\"[{\\\"action\\\":\\\"ADD_COLUMN\\\",\\\"value\\\":[{\\\"originName\\\":\\\"\\\",\\\"originType\\\":\\\"\\\",\\\"originComment\\\":\\\"\\\",\\\"name\\\":\\\"id\\\",\\\"type\\\":\\\"struct<name:string>\\\",\\\"comment\\\":\\\"\\\"}]}]\",",
        "Operator": "abc",
        "ChangeType": "CREATE_TABLE"
      }
    ]
  }
}

Error codes

HTTP status codeError codeError messageDescription
400InvalidParameter.Meta.CommonErrorThe specified parameter is invalid.The request parameter is invalid.
400InvalidParameter.Meta.IllegalThe app guid parameter is invalid.The app guid parameter is invalid.
400InvalidParameter.Meta.IllegalDateThe date format is invalid.The date format is invalid.
400InvalidParameter.Meta.IllegalPageErrorThe parameter for paging is invalid.The parameter for paging is invalid.
400InvalidParameter.Meta.NotExistThe object does not exist.-
403Forbidden.Meta.NoTenantThe user is not the owner of any tenants.The user is not the owner of any tenants.
403Forbidden.AccessAccess is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition.No permission, please authorize
429Throttling.ApiThe request for this resource has exceeded your available limit.-
429Throttling.Api.RiskThe request for this resource has exceeded your daily available limit.-
429Throttling.SystemThe DataWorks system is busy. Try again later.-
429Throttling.UserYour request is too frequent. Try again later.-
500InternalError.SystemAn internal system error occurred. Try again later.-
500InternalError.UserId.MissingAn internal system error occurred. Try again later.-
500InternalError.Meta.NoCalcEngineAn error occurred while retrieving the compute engine based on the MaxCompute project.Incorrect project entered by user
500InternalError.Meta.TenantTimeOutFailed to connect to the interface network.Failed to connect to the interface network.
500InternalError.Meta.UnknownAn unknown error occurred while processing your request.An unknown error occurred while processing your request.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history