调用GetPartitions获取表的所有分区信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 GetPartitions

系统规定参数。取值：GetPartitions。
DbName String 是 db001

数据库名称。
TableName String 是 tbl001

表的名称。
MaxParts Integer 否 100

每次最多返回多少个分区。默认为 -1，代表返回所有分区。

返回数据

名称 类型 示例值 描述
Code String NO_SUCH_OBJECT

如果失败，则返回失败的代码。
Message String No such table: db001.tbl001

如果请求失败，返回详细的失败信息。
Partitions Array of PartitionModel

分区列表。
CreateTime Long 20180913

分区创建时间。
DbName String db001

分区所在数据库名称。
Parameters Map

分区属性。
String key001=value001

分区属性。
StorageDescriptorModel Object

分区SD信息。
Cols Array of FieldSchemaModel

分区所在表的列信息。
Comment String this is comment

列注释。
Name String col1

列名称。
Type String string

列类型。
InputFormat String org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat

表的InputFormat。
Location String oss://data/xxx

表的路径。
OutputFormat String org.apache.hadoop.hive.ql.io.parquet.MapredParquetOutputFormat

表的OutputFormat。
Parameters Map

SD属性。
String key001=value001

SD属性。
SerDeInfoModel Object

表的SerDe信息。
Name String serDeName

SerDe的名称。
Parameters Map

SerDe的属性。
String key001=value001

SerDe的属性。
SerializationLib String org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe

处理serDe的类库。
TableName String tbl001

分区所在的表名。
Values Array of String p001

分区的值。
RequestId String 9BEAC206-0795-4DE3-B1FD-964BEF432B23

本次请求的RequestId。
Success Boolean false

本次请求是否成功。

示例

请求示例

http(s)://[Endpoint]/?Action=GetPartitions
&DbName=db001
&TableName=tbl001
&MaxParts=100
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<GetPartitionsResponse>
    <Code>NO_SUCH_OBJECT</Code>
    <Message>No such table: db001.tbl001</Message>
    <Partitions>
        <CreateTime>20180913</CreateTime>
        <DbName>db001</DbName>
        <Parameters>
            <key>key001=value001</key>
        </Parameters>
        <StorageDescriptorModel>
            <Cols>
                <Comment>this is comment</Comment>
                <Name>col1</Name>
                <Type>string</Type>
            </Cols>
            <InputFormat>org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat</InputFormat>
            <Location>oss://data/xxx</Location>
            <OutputFormat>org.apache.hadoop.hive.ql.io.parquet.MapredParquetOutputFormat</OutputFormat>
            <Parameters>
                <key>key001=value001</key>
            </Parameters>
            <SerDeInfoModel>
                <Name>serDeName</Name>
                <Parameters>
                    <key>key001=value001</key>
                </Parameters>
                <SerializationLib>org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe</SerializationLib>
            </SerDeInfoModel>
        </StorageDescriptorModel>
        <TableName>tbl001</TableName>
        <Values>p001</Values>
    </Partitions>
    <RequestId>9BEAC206-0795-4DE3-B1FD-964BEF432B23</RequestId>
    <Success>false</Success>
</GetPartitionsResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Code" : "NO_SUCH_OBJECT",
  "Message" : "No such table: db001.tbl001",
  "Partitions" : [ {
    "CreateTime" : 20180913,
    "DbName" : "db001",
    "Parameters" : {
      "key" : "key001=value001"
    },
    "StorageDescriptorModel" : {
      "Cols" : [ {
        "Comment" : "this is comment",
        "Name" : "col1",
        "Type" : "string"
      } ],
      "InputFormat" : "org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat",
      "Location" : "oss://data/xxx",
      "OutputFormat" : "org.apache.hadoop.hive.ql.io.parquet.MapredParquetOutputFormat",
      "Parameters" : {
        "key" : "key001=value001"
      },
      "SerDeInfoModel" : {
        "Name" : "serDeName",
        "Parameters" : {
          "key" : "key001=value001"
        },
        "SerializationLib" : "org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe"
      }
    },
    "TableName" : "tbl001",
    "Values" : [ "p001" ]
  } ],
  "RequestId" : "9BEAC206-0795-4DE3-B1FD-964BEF432B23",
  "Success" : false
}

错误码

访问错误中心查看更多错误码。