Checks whether a table 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 table. |
RegionId | String | Yes | cn-shanghai |
The ID of the region. |
ClusterId | String | No | abc |
The ID of the E-MapReduce (EMR) cluster. |
DatabaseName | String | No | abc |
The name of the EMR database. |
TableName | String | No | abc |
The name of the EMR table. |
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 table exists. |
RequestId | String | 0bc1ec92159376 |
The ID of the request. |
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
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | Invalid.Meta.TableNotExist | The table does not exist. | The error message returned because the table does not exist. |
400 | InvalidParameter.Meta.Illegal | The app guid parameter is invalid. | The error message returned because the AppGuid parameter is invalid. |
400 | InvalidParameter.Meta.NotExist | The object does not exist. | The error message returned because the object you query does not exist. |
400 | InternalError.UserId.Missing | An internal system error occurred. Try again later. | The error message returned because 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 error message returned because the system has failed to obtain the compute engine instance based on the specified MaxCompute project. |
403 | Forbidden.Meta.NoTenant | The user is not the owner of any tenants. | The error message returned because the current user is not a tenant owner. |
403 | Forbidden.Access | Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition. | The error message returned because you are not allowed to perform this operation. Activate DataWorks Enterprise Edition or DataWorks Ultimate Edition. |
429 | Throttling.Api | The request for this resource has exceeded your available limit. | The error message returned because 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 error message returned because 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 error message returned because the DataWorks system is busy. Try again later. |
429 | Throttling.User | Your request is too frequent. Try again later. | The error message returned because 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. | The error message returned because an internal error has occurred. Try again later. |
500 | InternalError.Meta.TenantTimeOut | Failed to connect to the interface network. | The error message returned because the network cannot be connected. |
500 | InternalError.Meta.Unknown | An unknown error occurred while processing your request. | The error message returned because an unknown error has occurred. |
For a list of error codes, visit the API Error Center.
For more information about the example on how to use the CheckMetaTable operation, see Examples of DataWorks API operations.