批量设置分区的统计信息
功能介绍
批量设置分区的统计信息。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v1/{project_id}/instances/{instance_id}/catalogs/{catalog_name}/databases/{database_name}/tables/{table_name}/partitions/column-statistics
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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个字符。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
Array of strings |
租户token。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
need_merge |
是 |
Boolean |
是否合入原有统计信息。 |
statistics |
是 |
Array of PartitionColumnStatistics objects |
分区统计信息的统计列表。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
column_statistics_desc |
是 |
列统计信息描述。 |
|
column_statistics_objects |
是 |
Array of ColumnStatisticsObj objects |
列统计信息。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
partition_values |
否 |
Array of strings |
分区值的列表。 |
last_analyzed_time |
否 |
String |
最后统计时间。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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 |
布尔类型统计信息。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
maximum_length |
是 |
Long |
列中字节数组的最大值。 |
average_length |
是 |
Double |
列中字节数组的平均长度。 |
number_of_null |
是 |
Long |
列中空值个数。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
minimum_value |
否 |
Long |
列中长整数最小值。 |
maximum_value |
否 |
Long |
列中长整数最大值。 |
number_of_null |
是 |
Long |
列中空值个数。 |
number_of_distinct_value |
是 |
Long |
列中去重后的长整数个数。 |
bit_vector |
否 |
String |
估算唯一值使用的位图。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
minimum_value |
否 |
Decimal object |
列中小数最小值。 |
maximum_value |
否 |
Decimal object |
列中小数最大值。 |
number_of_null |
是 |
Long |
列中空值个数。 |
number_of_distinct_value |
是 |
Long |
列中去重后的小数个数。 |
bit_vector |
否 |
String |
估算唯一值使用的位图。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
average_length |
是 |
Double |
列中字符串平均长度。 |
maximum_length |
是 |
Long |
列中字符串最长长度。 |
number_of_null |
是 |
Long |
列中空值个数。 |
number_of_distinct_value |
是 |
Long |
列中去重后字符串个数。 |
bit_vector |
否 |
String |
估算唯一值使用的位图。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
minimum_value |
否 |
Double |
列中浮点数最小值。 |
maximum_value |
否 |
Double |
列中浮点数最大值。 |
number_of_null |
是 |
Long |
列中空值个数。 |
number_of_distinct_value |
是 |
Long |
列中去重后浮点数个数。 |
bit_vector |
否 |
String |
估算唯一值使用的位图。 |
响应参数
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
solution_msg |
String |
解决方案描述。 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
solution_msg |
String |
解决方案描述。 |
状态码:403
参数 |
参数类型 |
描述 |
---|---|---|
error |
Error object |
错误信息。 |
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
title |
String |
标题。 |
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
title |
String |
标题。 |
message |
String |
错误信息。 |
code |
String |
状态码。 |
状态码:404
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
solution_msg |
String |
解决方案描述。 |
状态码:408
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
solution_msg |
String |
解决方案描述。 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
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 |
错误码
请参见错误码。