All Products
Search
Document Center

DataWorks:GetPartition

Last Updated:Jan 12, 2026

Retrieves partition details for a data map table. Currently supports MaxCompute and HMS (EMR cluster) types only.

Operation description

  1. This API operation is available for all DataWorks editions.
  2. This operation supports MaxCompute and HMS (EMR cluster) tables only.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
TableIdstringYes

The table ID. You can refer to the result returned by the ListTables operation and Concepts related to metadata entities.

maxcompute-column:11075xxxx::test_project:test_schema:test_table
NamestringYes

The partition name.

ds=20250101

Response parameters

ParameterTypeDescriptionExample
object

The response.

RequestIdstring

The request ID.

D1E2E5BC-xxxx-xxxx-xxxx-xxxxxx
Successboolean

Indicates whether the request was successful.

true
PartitionPartition

Partition details.

Examples

Sample success responses

JSONformat

{
  "RequestId": "D1E2E5BC-xxxx-xxxx-xxxx-xxxxxx",
  "Success": true,
  "Partition": {
    "TableId": "maxcompute-table:accountId::project::table",
    "Name": "ds=20250101",
    "CreateTime": 1700192563000,
    "ModifyTime": 1700192563000,
    "RecordCount": 1000000,
    "DataSize": 4096
  }
}

Error codes

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