文档首页/湖仓构建 LakeFormation/API参考/API/LakeCat类API/数据表统计/更新表的列统计信息 - SetTableColumnStatistics

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

更新表的列统计信息 - SetTableColumnStatistics

功能介绍

更新表的列统计信息。

调试

您可以在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}/column-statistics

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

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	Array of strings	租户token

表3 请求Body参数
参数	是否必选	参数类型	描述
merge	否	Boolean	是否是对统计信息的合并操作。默认为false。
table_column_statistics	是	TableColumnStatistics object	表列统计信息。

表4 TableColumnStatistics
参数	是否必选	参数类型	描述
column_statistics_desc	是	TableColumnStatisticsDescription object	表列统计信息描述。
column_statistics_objects	是	Array of ColumnStatisticsObj objects	列统计信息。

表5 TableColumnStatisticsDescription
参数	是否必选	参数类型	描述
last_analyzed_time	否	String	最后统计时间。

表6 ColumnStatisticsObj
参数	是否必选	参数类型	描述
column_name	是	String	列名称。只能包含中文、字母、数字和_-+*(), 特殊字符，且长度为1~767个字符。
column_type	是	String	数据类型，字段类型包括array bigint binary boolean char date decimal double float int interval map set smallint string struct timestamp tinyint union varchar
data_type	是	String	统计信息类型：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	列中字节数组的最大值。
average_length	是	Double	列中字节数组的平均长度。
number_of_null	是	Long	列中空值个数。
mcv	否	String	mcv值
mcv_frequency	否	String	mcv值对应的频率
histogram	否	String	直方图

表8 LongColumnStatisticsData
参数	是否必选	参数类型	描述
minimum_value	否	Long	列中长整数最小值。
maximum_value	否	Long	列中长整数最大值。
number_of_null	是	Long	列中空值个数。
number_of_distinct_value	是	Long	列中去重后的长整数个数。
bit_vector	否	String	估算唯一值使用的位图。
mcv	否	String	mcv值
mcv_frequency	否	String	mcv值对应的频率
histogram	否	String	直方图

表9 DecimalColumnStatisticsData
参数	是否必选	参数类型	描述
minimum_value	否	Decimal object	列中小数最小值。
maximum_value	否	Decimal object	列中小数最大值。
number_of_null	是	Long	列中空值个数。
number_of_distinct_value	是	Long	列中去重后的小数个数。
bit_vector	否	String	估算唯一值使用的位图。
mcv	否	String	mcv值
mcv_frequency	否	String	mcv值对应的频率
histogram	否	String	直方图

**表10** Decimal
参数	是否必选	参数类型	描述
scale	否	Integer	整数部分。
unscaled	否	String	小数部分。

**表11** StringColumnStatisticsData
参数	是否必选	参数类型	描述
average_length	是	Double	列中字符串平均长度。
maximum_length	是	Long	列中字符串最长长度。
number_of_null	是	Long	列中空值个数。
number_of_distinct_value	是	Long	列中去重后字符串个数。
bit_vector	否	String	估算唯一值使用的位图。
mcv	否	String	mcv值
mcv_frequency	否	String	mcv值对应的频率
histogram	否	String	直方图

**表12** DoubleColumnStatisticsData
参数	是否必选	参数类型	描述
minimum_value	否	Double	列中浮点数最小值。
maximum_value	否	Double	列中浮点数最大值。
number_of_null	是	Long	列中空值个数。
number_of_distinct_value	是	Long	列中去重后浮点数个数。
bit_vector	否	String	估算唯一值使用的位图。
mcv	否	String	mcv值
mcv_frequency	否	String	mcv值对应的频率
histogram	否	String	直方图

**表13** DateColumnStatisticsData
参数	是否必选	参数类型	描述
minimum_value	否	String	列中的最小时间戳。
maximum_value	否	String	列中的最大时间戳。
number_of_null	是	Long	列中空值个数。
number_of_distinct_value	是	Long	列中去重后的时间戳个数。
bit_vector	否	String	估算唯一值使用的位图。
mcv	否	String	mcv值
mcv_frequency	否	String	mcv值对应的频率
histogram	否	String	直方图

**表14** BooleanColumnStatisticsData
参数	是否必选	参数类型	描述
number_of_true	是	Long	列中为真的数量。
number_of_false	是	Long	列中为假的数量。
number_of_null	是	Long	列中为空的数量。
mcv	否	String	mcv值
mcv_frequency	否	String	mcv值对应的频率
histogram	否	String	直方图

响应参数

状态码：200

**表15** 响应Body参数
参数	参数类型	描述
column_statistics_desc	TableColumnStatisticsDescription object	表列统计信息描述。
column_statistics_objects	Array of ColumnStatisticsObj objects	列统计信息。

**表16** TableColumnStatisticsDescription
参数	参数类型	描述
last_analyzed_time	String	最后统计时间。

**表17** ColumnStatisticsObj
参数	参数类型	描述
column_name	String	列名称。只能包含中文、字母、数字和_-+*(), 特殊字符，且长度为1~767个字符。
column_type	String	数据类型，字段类型包括array bigint binary boolean char date decimal double float int interval map set smallint string struct timestamp tinyint union varchar
data_type	String	统计信息类型：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	布尔类型统计信息。

**表18** BinaryColumnStatisticsData
参数	参数类型	描述
maximum_length	Long	列中字节数组的最大值。
average_length	Double	列中字节数组的平均长度。
number_of_null	Long	列中空值个数。
mcv	String	mcv值
mcv_frequency	String	mcv值对应的频率
histogram	String	直方图

**表19** LongColumnStatisticsData
参数	参数类型	描述
minimum_value	Long	列中长整数最小值。
maximum_value	Long	列中长整数最大值。
number_of_null	Long	列中空值个数。
number_of_distinct_value	Long	列中去重后的长整数个数。
bit_vector	String	估算唯一值使用的位图。
mcv	String	mcv值
mcv_frequency	String	mcv值对应的频率
histogram	String	直方图

**表20** DecimalColumnStatisticsData
参数	参数类型	描述
minimum_value	Decimal object	列中小数最小值。
maximum_value	Decimal object	列中小数最大值。
number_of_null	Long	列中空值个数。
number_of_distinct_value	Long	列中去重后的小数个数。
bit_vector	String	估算唯一值使用的位图。
mcv	String	mcv值
mcv_frequency	String	mcv值对应的频率
histogram	String	直方图

**表21** Decimal
参数	参数类型	描述
scale	Integer	整数部分。
unscaled	String	小数部分。

**表22** StringColumnStatisticsData
参数	参数类型	描述
average_length	Double	列中字符串平均长度。
maximum_length	Long	列中字符串最长长度。
number_of_null	Long	列中空值个数。
number_of_distinct_value	Long	列中去重后字符串个数。
bit_vector	String	估算唯一值使用的位图。
mcv	String	mcv值
mcv_frequency	String	mcv值对应的频率
histogram	String	直方图

**表23** DoubleColumnStatisticsData
参数	参数类型	描述
minimum_value	Double	列中浮点数最小值。
maximum_value	Double	列中浮点数最大值。
number_of_null	Long	列中空值个数。
number_of_distinct_value	Long	列中去重后浮点数个数。
bit_vector	String	估算唯一值使用的位图。
mcv	String	mcv值
mcv_frequency	String	mcv值对应的频率
histogram	String	直方图

**表24** DateColumnStatisticsData
参数	参数类型	描述
minimum_value	String	列中的最小时间戳。
maximum_value	String	列中的最大时间戳。
number_of_null	Long	列中空值个数。
number_of_distinct_value	Long	列中去重后的时间戳个数。
bit_vector	String	估算唯一值使用的位图。
mcv	String	mcv值
mcv_frequency	String	mcv值对应的频率
histogram	String	直方图

**表25** BooleanColumnStatisticsData
参数	参数类型	描述
number_of_true	Long	列中为真的数量。
number_of_false	Long	列中为假的数量。
number_of_null	Long	列中为空的数量。
mcv	String	mcv值
mcv_frequency	String	mcv值对应的频率
histogram	String	直方图

状态码：201

Created

状态码：400

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

状态码：401

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

状态码：403

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

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

状态码：404

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

状态码：408

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

状态码：500

**表32** 响应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}/column-statistics

{
  "merge" : false,
  "table_column_statistics" : {
    "column_statistics_desc" : {
      "last_analyzed_time" : "1970-01-01T00:00:00.100+00:00"
    },
    "column_statistics_objects" : [ {
      "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=="
      }
    } ]
  }
}

响应示例

状态码：200

{
  "column_statistics_desc" : {
    "last_analyzed_time" : "2023-05-31T02:25:35.614+00:00"
  },
  "column_statistics_objects" : [ {
    "column_name" : "1f3cbc18c07434435900b9cc7ba77678e",
    "column_type" : "bigint",
    "data_type" : "longStats",
    "long_statistics_data" : {
      "minimum_value" : -1469440606,
      "maximum_value" : 1927485019,
      "number_of_null" : -762838456,
      "number_of_distinct_value" : 531813078,
      "bit_vector" : "AWioLRcudhP0QQ=="
    }
  } ]
}

状态码：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

错误码

请参见错误码。

父主题：数据表统计

上一篇：获取表的列统计信息 - ListTableColumnStatistics

下一篇：删除表的指定列统计信息 - DeleteTableColumnStatistics

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

云宝助手提问云社区提问