文档首页/ 湖仓构建 LakeFormation/ API参考/ API/ LakeCat类API/ 分区列统计信息/ 批量设置分区的统计信息 - SetPartitionColumnStatistics

更新时间：2026-08-11 GMT+08:00

批量设置分区的统计信息 - SetPartitionColumnStatistics

功能介绍

批量设置分区的统计信息。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1/{project_id}/instances/{instance_id}/catalogs/{catalog_name}/databases/{database_name}/tables/{table_name}/partitions/column-statistics

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释: 项目编号。获取方法，请参见获取项目ID。约束限制: 长度为1~64个字符取值范围: 长度为1~64个字符默认取值: 不涉及
instance_id	是	String	参数解释: LakeFormation实例ID。创建实例时自动生成。例如：2180518f-42b8-4947-b20b-adfc53981a25。约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
catalog_name	是	String	参数解释: catalog名称。约束限制: 只能包含字母、数字和下划线，且长度为1~256个字符。取值范围: 长度为1~256个字符默认取值: 不涉及
database_name	是	String	参数解释: 数据库名称。约束限制: 只能包含中文、字母、数字、下划线、中划线，且长度为1~128个字符。取值范围: 长度为1~128个字符默认取值: 不涉及
table_name	是	String	参数解释: 表名称。约束限制: 只能包含中文、字母、数字、下划线、中划线，且长度为1~256个字符。取值范围: 长度为1~256个字符默认取值: 不涉及

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	Array of strings	参数解释: 租户token。约束限制: 数组元素个数为1~100 取值范围: 数组元素个数为1~100 默认取值: 不涉及

表3 请求Body参数
参数	是否必选	参数类型	描述
need_merge	是	Boolean	参数解释: 是否合入原有统计信息约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
statistics	是	Array of PartitionColumnStatistics objects	参数解释: 分区统计信息的统计列表约束限制: 数组元素个数为0~2000 取值范围: 数组元素个数为0~2000 默认取值: 不涉及

表4 PartitionColumnStatistics
参数	是否必选	参数类型	描述
column_statistics_desc	是	PartitionColumnStatisticsDescription object	参数解释: 列统计信息描述约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
column_statistics_objects	是	Array of ColumnStatisticsObj objects	参数解释: 列统计信息约束限制: 数组元素个数为0~256 取值范围: 数组元素个数为0~256 默认取值: 不涉及

表5 PartitionColumnStatisticsDescription
参数	是否必选	参数类型	描述
partition_values	否	Array of strings	参数解释: 分区值的列表约束限制: 数组元素个数为0~100 取值范围: 最大长度为256，数组元素个数为0~100 默认取值: 不涉及
last_analyzed_time	否	String	参数解释: 最后统计时间约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及
spec_id	否	String	参数解释: iceberg分区规范id 约束限制: 长度为0~64个字符取值范围: 长度为0~64个字符默认取值: 不涉及

表6 ColumnStatisticsObj
参数	是否必选	参数类型	描述
column_name	是	String	参数解释: 列名称。只能包含中文、字母、数字和_-+(), 特殊字符，且长度为1~767个字符约束限制:* 长度为1~767个字符取值范围: 长度为1~767个字符默认取值: 不涉及
column_type	是	String	参数解释: 说明：约束限制: 长度为1~50个字符数据类型，字段类型包括array bigint binary boolean char date decimal double float int interval map set smallint string struct timestamp tinyint union varchar 取值范围: 长度为1~50个字符默认取值: 不涉及
data_type	是	String	参数解释: 统计信息类型：binaryStats、booleanStats、dateStats、decimalStats、doubleStats、longStats、stringStats 约束限制: 可选值为：binaryStats, booleanStats, dateStats, decimalStats, doubleStats, longStats, stringStats 取值范围: 不涉及默认取值: 不涉及
binary_statistics_data	否	BinaryColumnStatisticsData object	参数解释: 字节数组类型统计信息约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
long_statistics_data	否	LongColumnStatisticsData object	参数解释: 长整数类型统计信息约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
decimal_statistics_data	否	DecimalColumnStatisticsData object	参数解释: 小数类型统计信息约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
string_statistics_data	否	StringColumnStatisticsData object	参数解释: 字符串类型统计信息约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
double_statistics_data	否	DoubleColumnStatisticsData object	参数解释: 浮点数类型统计信息约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
date_statistics_data	否	DateColumnStatisticsData object	参数解释: 日期类型统计信息约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
boolean_statistics_data	否	BooleanColumnStatisticsData object	参数解释: 布尔类型统计信息约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及

表7 BinaryColumnStatisticsData
参数	是否必选	参数类型	描述
maximum_length	是	Long	参数解释: 列中字节数组的最大值约束限制: 不涉及取值范围: 不涉及默认取值: 0
average_length	是	Double	参数解释: 列中字节数组的平均长度约束限制: 不涉及取值范围: 不涉及默认取值: 0
number_of_null	是	Long	参数解释: 列中空值个数约束限制: 不涉及取值范围: 不涉及默认取值: 0
mcv	否	String	参数解释: mcv值约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及
mcv_frequency	否	String	参数解释: mcv值对应的频率约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及
histogram	否	String	参数解释: 直方图约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及

表8 LongColumnStatisticsData
参数	是否必选	参数类型	描述
minimum_value	否	Long	参数解释: 列中长整数最小值约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
maximum_value	否	Long	参数解释: 列中长整数最大值约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
number_of_null	是	Long	参数解释: 列中空值个数约束限制: 不涉及取值范围: 不涉及默认取值: 0
number_of_distinct_value	是	Long	参数解释: 列中去重后的长整数个数约束限制: 不涉及取值范围: 不涉及默认取值: 0
bit_vector	否	String	参数解释: 估算唯一值使用的位图约束限制: 最大长度为66560 取值范围: 最大长度为66560 默认取值: 不涉及
mcv	否	String	参数解释: mcv值约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及
mcv_frequency	否	String	参数解释: mcv值对应的频率约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及
histogram	否	String	参数解释: 直方图约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及

表9 DecimalColumnStatisticsData
参数	是否必选	参数类型	描述
minimum_value	否	Decimal object	参数解释: 列中小数最小值约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
maximum_value	否	Decimal object	参数解释: 列中小数最大值约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
number_of_null	是	Long	参数解释: 列中空值个数约束限制: 不涉及取值范围: 不涉及默认取值: 0
number_of_distinct_value	是	Long	参数解释: 列中去重后的小数个数约束限制: 不涉及取值范围: 不涉及默认取值: 0
bit_vector	否	String	参数解释: 估算唯一值使用的位图约束限制: 最大长度为66560 取值范围: 最大长度为66560 默认取值: 不涉及
mcv	否	String	参数解释: mcv值约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及
mcv_frequency	否	String	参数解释: mcv值对应的频率约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及
histogram	否	String	参数解释: 直方图约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及

**表10** Decimal
参数	是否必选	参数类型	描述
scale	否	Integer	参数解释: 整数部分约束限制: 取值为-2147483646~2147483647 取值范围: 取值为-2147483646~2147483647 默认取值: 不涉及
unscaled	否	String	参数解释: 小数部分约束限制: 最大长度为125 取值范围: 最大长度为125 默认取值: 不涉及

**表11** StringColumnStatisticsData
参数	是否必选	参数类型	描述
average_length	是	Double	参数解释: 列中字符串平均长度约束限制: 不涉及取值范围: 不涉及默认取值: 0
maximum_length	是	Long	参数解释: 列中字符串最长长度约束限制: 不涉及取值范围: 不涉及默认取值: 0
number_of_null	是	Long	参数解释: 列中空值个数约束限制: 不涉及取值范围: 不涉及默认取值: 0
number_of_distinct_value	是	Long	参数解释: 列中去重后字符串个数约束限制: 不涉及取值范围: 不涉及默认取值: 0
bit_vector	否	String	参数解释: 估算唯一值使用的位图约束限制: 最大长度为66560 取值范围: 最大长度为66560 默认取值: 不涉及
mcv	否	String	参数解释: mcv值约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
mcv_frequency	否	String	参数解释: mcv值对应的频率约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
histogram	否	String	参数解释: 直方图约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及

**表12** DoubleColumnStatisticsData
参数	是否必选	参数类型	描述
minimum_value	否	Double	参数解释: 列中浮点数最小值约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
maximum_value	否	Double	参数解释: 列中浮点数最大值约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
number_of_null	是	Long	参数解释: 列中空值个数约束限制: 不涉及取值范围: 不涉及默认取值: 0
number_of_distinct_value	是	Long	参数解释: 列中去重后浮点数个数约束限制: 不涉及取值范围: 不涉及默认取值: 0
bit_vector	否	String	参数解释: 估算唯一值使用的位图约束限制: 最大长度为66560 取值范围: 最大长度为66560 默认取值: 不涉及
mcv	否	String	参数解释: mcv值约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及
mcv_frequency	否	String	参数解释: mcv值对应的频率约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及
histogram	否	String	参数解释: 直方图约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及

**表13** DateColumnStatisticsData
参数	是否必选	参数类型	描述
minimum_value	否	String	参数解释: 列中的最小时间戳约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
maximum_value	否	String	参数解释: 列中的最大时间戳约束限制: 不涉及取值范围: 不涉及默认取值: 不涉及
number_of_null	是	Long	参数解释: 列中空值个数约束限制: 不涉及取值范围: 不涉及默认取值: 0
number_of_distinct_value	是	Long	参数解释: 列中去重后的时间戳个数约束限制: 不涉及取值范围: 不涉及默认取值: 0
bit_vector	否	String	参数解释: 估算唯一值使用的位图约束限制: 最大长度为66560 取值范围: 最大长度为66560 默认取值: 不涉及
mcv	否	String	参数解释: mcv值约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及
mcv_frequency	否	String	参数解释: mcv值对应的频率约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及
histogram	否	String	参数解释: 直方图约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及

**表14** BooleanColumnStatisticsData
参数	是否必选	参数类型	描述
number_of_true	是	Long	参数解释: 列中为真的数量约束限制: 不涉及取值范围: 不涉及默认取值: 0
number_of_false	是	Long	参数解释: 列中为假的数量约束限制: 不涉及取值范围: 不涉及默认取值: 0
number_of_null	是	Long	参数解释: 列中为空的数量约束限制: 不涉及取值范围: 不涉及默认取值: 0
mcv	否	String	参数解释: mcv值约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及
mcv_frequency	否	String	参数解释: mcv值对应的频率约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及
histogram	否	String	参数解释: 直方图约束限制: 最小长度为0 取值范围: 最小长度为0 默认取值: 不涉及

响应参数

状态码：200

状态码：201

Created

状态码：400

**表15** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 错误码
error_msg	String	参数解释: 错误描述
solution_msg	String	参数解释: 解决方案描述

状态码：401

**表16** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 错误码
error_msg	String	参数解释: 错误描述
solution_msg	String	参数解释: 解决方案描述

状态码：403

**表17** 响应Body参数
参数	参数类型	描述
error	Error object	参数解释: 错误信息
error_code	String	参数解释: 错误码
error_msg	String	参数解释: 错误描述
title	String	参数解释: 标题

**表18** Error
参数	参数类型	描述
error_code	String	参数解释: 错误码
error_msg	String	参数解释: 错误描述
title	String	参数解释: 标题
message	String	参数解释: 错误信息
code	String	参数解释: 状态码

状态码：404

**表19** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 错误码
error_msg	String	参数解释: 错误描述
solution_msg	String	参数解释: 解决方案描述

状态码：408

**表20** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 错误码
error_msg	String	参数解释: 错误描述
solution_msg	String	参数解释: 解决方案描述

状态码：500

**表21** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 错误码
error_msg	String	参数解释: 错误描述
solution_msg	String	参数解释: 解决方案描述

请求示例

POST https://{endpoint} /v1/{project_id}/instances/{instance_id}/catalogs/{catalog_name}/databases/{database_name}/tables/{table_name}/partitions/column-statistics

{
  "need_merge" : false,
  "statistics" : [ {
    "column_statistics_desc" : {
      "partition_values" : [ "value1", "value2" ],
      "last_analyzed_time" : "2023-05-31T02:52:16.137Z"
    },
    "column_statistics_objects" : [ {
      "column_name" : "column_prefix0",
      "column_type" : "string",
      "data_type" : "stringStats",
      "string_statistics_data" : {
        "average_length" : 10,
        "maximum_length" : 100,
        "number_of_null" : 30,
        "number_of_distinct_value" : 20,
        "bit_vector" : "FwAAAAAAAAAAAA=="
      }
    }, {
      "column_name" : "column_prefix1",
      "column_type" : "string",
      "data_type" : "stringStats",
      "string_statistics_data" : {
        "average_length" : 10,
        "maximum_length" : 100,
        "number_of_null" : 30,
        "number_of_distinct_value" : 20,
        "bit_vector" : "FwAAAAAAAAAAAA=="
      }
    }, {
      "column_name" : "column_prefix2",
      "column_type" : "string",
      "data_type" : "stringStats",
      "string_statistics_data" : {
        "average_length" : 10,
        "maximum_length" : 100,
        "number_of_null" : 30,
        "number_of_distinct_value" : 20,
        "bit_vector" : "FwAAAAAAAAAAAA=="
      }
    }, {
      "column_name" : "column_prefix3",
      "column_type" : "string",
      "data_type" : "stringStats",
      "string_statistics_data" : {
        "average_length" : 10,
        "maximum_length" : 100,
        "number_of_null" : 30,
        "number_of_distinct_value" : 20,
        "bit_vector" : "FwAAAAAAAAAAAA=="
      }
    }, {
      "column_name" : "column_prefix4",
      "column_type" : "string",
      "data_type" : "stringStats",
      "string_statistics_data" : {
        "average_length" : 10,
        "maximum_length" : 100,
        "number_of_null" : 30,
        "number_of_distinct_value" : 20,
        "bit_vector" : "FwAAAAAAAAAAAA=="
      }
    }, {
      "column_name" : "column_prefix5",
      "column_type" : "string",
      "data_type" : "stringStats",
      "string_statistics_data" : {
        "average_length" : 10,
        "maximum_length" : 100,
        "number_of_null" : 30,
        "number_of_distinct_value" : 20,
        "bit_vector" : "FwAAAAAAAAAAAA=="
      }
    }, {
      "column_name" : "column_prefix6",
      "column_type" : "string",
      "data_type" : "stringStats",
      "string_statistics_data" : {
        "average_length" : 10,
        "maximum_length" : 100,
        "number_of_null" : 30,
        "number_of_distinct_value" : 20,
        "bit_vector" : "FwAAAAAAAAAAAA=="
      }
    }, {
      "column_name" : "column_prefix7",
      "column_type" : "string",
      "data_type" : "stringStats",
      "string_statistics_data" : {
        "average_length" : 10,
        "maximum_length" : 100,
        "number_of_null" : 30,
        "number_of_distinct_value" : 20,
        "bit_vector" : "FwAAAAAAAAAAAA=="
      }
    }, {
      "column_name" : "column_prefix8",
      "column_type" : "string",
      "data_type" : "stringStats",
      "string_statistics_data" : {
        "average_length" : 10,
        "maximum_length" : 100,
        "number_of_null" : 30,
        "number_of_distinct_value" : 20,
        "bit_vector" : "FwAAAAAAAAAAAA=="
      }
    }, {
      "column_name" : "column_prefix9",
      "column_type" : "string",
      "data_type" : "stringStats",
      "string_statistics_data" : {
        "average_length" : 10,
        "maximum_length" : 100,
        "number_of_null" : 30,
        "number_of_distinct_value" : 20,
        "bit_vector" : "FwAAAAAAAAAAAA=="
      }
    } ]
  } ]
}

响应示例

状态码：400

Bad Request

{
  "error_code" : "common.01000001",
  "error_msg" : "failed to read http request, please check your input, code: 400, reason: Type mismatch., cause: TypeMismatchException"
}

状态码：401

Unauthorized

{
  "error_code" : "APIG.1002",
  "error_msg" : "Incorrect token or token resolution failed"
}

状态码：403

Forbidden

{
  "error" : {
    "code" : "403",
    "message" : "X-Auth-Token is invalid in the request",
    "error_code" : null,
    "error_msg" : null,
    "title" : "Forbidden"
  },
  "error_code" : "403",
  "error_msg" : "X-Auth-Token is invalid in the request",
  "title" : "Forbidden"
}

状态码：404

Not Found

{
  "error_code" : "common.01000001",
  "error_msg" : "response status exception, code: 404"
}

状态码：408

Request Timeout

{
  "error_code" : "common.00000408",
  "error_msg" : "timeout exception occurred"
}

状态码：500

Internal Server Error

{
  "error_code" : "common.00000500",
  "error_msg" : "internal error"
}

状态码

状态码	描述
200	OK
201	Created
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
408	Request Timeout
500	Internal Server Error

错误码

请参见错误码。

父主题： 分区列统计信息

上一篇：批量获取分区的列统计信息 - BatchShowPartitionColumnStatistics

下一篇：删除分区列的统计信息 - DeletePartitionColumnStatistics