Checks whether a metatable exists.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
Action | String | Yes | CheckMetaTable | The operation that you want to perform. Set the value to CheckMetaTable. |
TableGuid | String | Yes | odps.engine_name.table_name | The GUID of the metatable. |
ClusterId | String | No | abc | The E-MapReduce (EMR) cluster ID. |
DatabaseName | String | No | abc | The name of the metadatabase of the EMR cluster. |
TableName | String | No | abc | The name of the EMR metatable. |
DataSourceType | String | No | emr | The type of the data source. Valid values: odps and emr. |
Response parameters
Parameter | Type | Example | Description |
Data | Boolean | true | Indicates whether the metatable exists. |
RequestId | String | 0bc1ec92159376 | The request ID. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=CheckMetaTable
&TableGuid=odps.engine_name.table_name
&ClusterId=abc
&DatabaseName=abc
&TableName=abc
&DataSourceType=emr
&<Common request parameters>Sample success responses
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<CheckMetaTableResponse>
<Data>true</Data>
<RequestId>0bc1ec92159376</RequestId>
</CheckMetaTableResponse>JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"Data" : true,
"RequestId" : "0bc1ec92159376"
}Error codes
HTTP status code | Error code | Error message | Description |
400 | Invalid.Meta.TableNotExist | The table does not exist. | The metatable is not found. |
400 | InvalidParameter.Meta.Illegal | The app guid parameter is invalid. | The values specified for one or more parameters of the application are invalid. |
400 | InternalError.UserId.Missing | An internal system error occurred. Try again later. | An internal error occurred. Try again later. |
400 | InternalError.Meta.NoCalcEngine | An error occurred while retrieving the compute engine based on the MaxCompute project. | The project specified by the user is invalid. |
403 | Forbidden.Meta.NoTenant | The user is not the owner of any tenants. | The current user is not a tenant owner. |
403 | Forbidden.Access | Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition. | No permissions. |
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 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 occurred. |
For a list of error codes, see Service error codes.
For information about the example on how to use the CheckMetaTable operation, see Examples of DataWorks API operations.