GetPartition API Reference & Partition Metadata - DataWorks - Alibaba Cloud - DataWorks

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

Operation description

DataWorks Basic Edition or a higher edition is required.
Only MaxCompute and HMS (EMR cluster) table types are supported.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
TableId	string	Yes	The table ID. You can refer to the result returned by the ListTables operation and Concepts related to metadata entities.	maxcompute-table:::project_name:[schema_name]:table_name
Name	string	Yes	The partition name.	ds=20250101

Response elements

Element	Type	Description	Example
	object	The response.
RequestId	string	The request ID.	D1E2E5BC-xxxx-xxxx-xxxx-xxxxxx
Success	boolean	Indicates whether the request was successful.	true
Partition	Partition	Partition details.

Examples

Success response

JSON format

{
  "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

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.