Checks whether a partition in a MaxCompute metatable exists.
Debugging
Request parameters
Parameter |
Type |
Required |
Example |
Description |
Action | String | Yes | CheckMetaPartition | The operation that you want to perform. Set the value to CheckMetaPartition. |
TableGuid | String | Yes | odps.engine_name.table_name | The GUID of the MaxCompute metatable. |
Partition | String | Yes | ds=202005 | The name of the partition in the MaxCompute metatable. |
ClusterId | String | No | abc | The ID of the E-MapReduce (EMR) cluster. This parameter is deprecated. |
DatabaseName | String | No | abc | The name of the metadatabase. |
TableName | String | No | abc | The name of the metatable. |
DataSourceType | String | No | odps | The type of the data source. Set the value to odps. |
Response parameters
Parameter |
Type |
Example |
Description |
HttpStatusCode | Integer | 200 | The HTTP status code. |
Data | Boolean | true | Indicates whether the partition in the MaxCompute metatable exists.
|
RequestId | String | 0bc1ec92159376 | The request ID. You can locate logs and troubleshoot issues based on the ID. |
ErrorMessage | String | The connection does not exist. | The error message. |
ErrorCode | String | Invalid.Tenant.ConnectionNotExists | The error code. |
Success | Boolean | true | Indicates whether the request was successful. Valid values:
|
Examples
Sample requests
http(s)://[Endpoint]/?Action=CheckMetaPartition
&TableGuid=odps.engine_name.table_name
&Partition=ds=202005
&ClusterId=abc
&DatabaseName=abc
&TableName=abc
&DataSourceType=odps
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<CheckMetaPartitionResponse>
<HttpStatusCode>200</HttpStatusCode>
<Data>true</Data>
<RequestId>0bc1ec92159376</RequestId>
<ErrorMessage>The connection does not exist.</ErrorMessage>
<ErrorCode>Invalid.Tenant.ConnectionNotExists</ErrorCode>
<Success>true</Success>
</CheckMetaPartitionResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"HttpStatusCode" : 200,
"Data" : true,
"RequestId" : "0bc1ec92159376",
"ErrorMessage" : "The connection does not exist.",
"ErrorCode" : "Invalid.Tenant.ConnectionNotExists",
"Success" : true
}
Error codes
HTTP status code |
Error code |
Error message |
Description |
400 | Invalid.Meta.TableNotExist | The table does not exist. | The metatable does not exist. |
400 | InvalidParameter.Meta.CommonError | The specified parameter is invalid. | The values specified for one or more request parameters are invalid. |
400 | InvalidParameter.Meta.Illegal | The app guid parameter is invalid. | The values specified for one or more parameters of the application are invalid. |
400 | InvalidParameter.Meta.NotExist | The object does not exist. | The object you query does not exist. |
400 | InternalError.UserId.Missing | An internal system error occurred. Try again later. | An internal error has occurred. Try again later. |
400 | InternalError.Meta.NoCalcEngine | An error occurred while retrieving the compute engine based on the MaxCompute project. | The compute engine instance failed to be obtained based on the MaxCompute project {0}. |
403 | Forbidden.Meta.NoTenant | The user is not the owner of any tenants. | The current user is not a tenant owner. |
429 | Throttling.Api | The request for this resource has exceeded your available limit. | The number of requests for the resource has exceeded the upper limit. |
429 | Throttling.Api.Risk | The request for this resource has exceeded your daily available limit. | The number of requests per day for the resource has exceeded the upper limit. |
429 | Throttling.System | The DataWorks system is busy. Try again later. | The DataWorks system is busy. Try again later. |
429 | Throttling.User | Your request is too frequent. Try again later. | Excessive requests have been submitted within a short period of time. Try again later. |
500 | InternalError.System | An internal system error occurred. Try again later. | An internal error has occurred. Try again later. |
500 | InternalError.Meta.TenantTimeOut | Failed to connect to the interface network. | The network cannot be connected. |
500 | InternalError.Meta.Unknown | An unknown error occurred while processing your request. | An unknown error has occurred. |
For a list of error codes, see Service error codes.
For more information about the example on how to use the CheckMetaPartition operation, see Examples of DataWorks API operations.