Queries the lineage of a table.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | GetMetaTableLineage |
The operation that you want to perform. |
Direction | String | Yes | up |
Upstream and downstream direction of the field: up indicates upstream, down indicates downstream. |
RegionId | String | Yes | cn-shanghai |
The ID of the region where your project resides. |
TableGuid | String | Yes | odps.engine_name.table_name |
The globally unique identifier (GUID) of the table. |
NextPrimaryKey | String | No | odps.engine_name.table_name1 |
The paging logic. Set this parameter based on the return parameters HasNext=true and key. |
PageSize | Integer | No | 10 |
The number of entries to return on each page. Default value: 10. Maximum value: 100. |
ClusterId | String | No | abc |
The ID of the e-MapReduce cluster. |
DatabaseName | String | No | abc |
The name of the database. |
TableName | String | No | abc |
The name of the table. |
DataSourceType | String | No | emr |
The data type. Valid values: maxcompute and emr. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
Data | Struct |
Business data. |
|
DataEntityList | Array of DataEntityList |
The information about the table. |
|
TableGuid | String | odps.tt.name |
The globally unique identifier (GUID) of the table. |
TableName | String | name |
The name of the table. |
HasNext | Boolean | true |
Whether there is still a next page. |
NextPrimaryKey | String | odps.tt.2 |
The paging logic. Set this parameter based on the return parameters HasNext=true and key. |
ErrorCode | String | Invalid.Tenant.ConnectionNotExists |
The error code. |
ErrorMessage | String | The connection does not exist. |
The error message. |
HttpStatusCode | Integer | 200 |
The HTTP status code. |
RequestId | String | 0bc1ec92159376 |
The ID of the request. |
Success | Boolean | true |
Indicates whether the request is successful. |
Examples
Sample requests
http(s)://[Endpoint]/? Action=GetMetaTableLineage &Direction=up &RegionId=cn-shanghai &TableGuid=odps.engine_name.table_name &<common request parameters>
Sample success responses
XML
format
<RequestId>0bc1ec92159376</RequestId> <HttpStatusCode>200</HttpStatusCode> <Data> <DataEntityList> <TableName>1</TableName> <TableGuid>odps.tt.name</TableGuid> </DataEntityList> <HasNext>true</HasNext> <NextPrimaryKey>odps.tt.name</NextPrimaryKey> </Data> <ErrorCode>Invalid.Tenant.ConnectionNotExists</ErrorCode> <ErrorMessage>The connection does not exist. </ErrorMessage> <Success>true</Success>
JSON
Format
{ "RequestId": "0bc1ec92159376", "HttpStatusCode": 200, "Data": { "DataEntityList": { "TableName": 1, "TableGuid": "odps.tt.name" }, "HasNext": true, "NextPrimaryKey": "odps.tt.name" }, "ErrorCode": "Invalid.Tenant.ConnectionNotExists", "ErrorMessage": "The connection does not exist.", "Success": true }
Error codes
HttpCode | Error codes | Error message | Description |
---|---|---|---|
403 | Forbidden.Access | Access is forbidden. Activate DataWorks first. | You have restricted access. Please activate DataWorks Enterprise Edition or above. |
500 | InternalError.System | An internal system error occurred. Try again later. | An internal system error occurred. Please try again later. |
500 | InternalError.UserId.Missing | An internal system error occurred. Try again later. | An internal system error occurred. Please try again later. |
403 | ResourceNotAuthorized.Api | You are not authorized to access the resources. | You cannot access resources without authorization. |
429 | Throttling.Api | The request for this resource has exceeded your available limit. | The request for the resource exceeds your available upper limit. |
429 | Throttling.Api.Risk | The request for this resource has exceeded your daily available limit. | The request for the resource has exceeded your daily availability limit. |
429 | Throttling.System | The DataWorks system is busy. Try again later. | DataWorks the system is busy, please try again later. |
429 | Throttling.User | Your request is too frequent. Try again later. | Your request is too frequent, please try to slow down the request speed. |
403 | Forbidden.Meta.NoTenant | The user is not the owner of any tenants. | The current user is not the owner of any of the tenants. |
500 | InternalError.Meta.NoCalcEngine | An error occurred while retrieving the compute engine based on the MaxCompute project. | Failed to get compute engine based on maxcompute project {0}. |
500 | InternalError.Meta.TenantTimeOut | Failed to connect to the interface network. | The interface network is disconnected. |
500 | InternalError.Meta.Unknown | An unknown error occurred while processing your request. | Resolve the error based on the error message. |
400 | Invalid.Meta.TableNotExist | The table does not exist. | The error message returned because |
400 | InvalidParameter.Meta.CommonError | The specified parameter is invalid. | The error message returned because one or more request parameters are invalid. |
400 | InvalidParameter.Meta.GuidFormat | The GUID format is invalid. | Bad Guid information. |
400 | InvalidParameter.Meta.Illegal | The app guid parameter is invalid. | The error message returned because the App parameter is invalid. |
400 | InvalidParameter.Meta.IllegalDate | The date format is invalid. | Date format error. |
400 | InvalidParameter.Meta.IllegalPageError | The parameter for paging is invalid. | The pagination information is incorrect. |
400 | InvalidParameter.Meta.NotExist | The object does not exist. | Data does not exist. |
Go to the Error CenterFor more information, see error codes.