# 修改表信息 - UpdateTable #### 功能介绍 修改表信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/LakeFormation/doc?api=UpdateTable)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-lakeformation/abcd.html)。 #### URI PUT /v1/{project_id}/instances/{instance_id}/catalogs/{catalog_name}/databases/{database_name}/tables/{table_name} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释:** 项目编号。获取方法，请参见[获取项目ID](https://support.huaweicloud.com/api-lakeformation/lakeformation_04_0026.html)。 **约束限制:** 长度为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参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | alter_params | 否 | Map\ | **参数解释:** 修改表参数映射信息，支持的参数如下： CASCADE: 级联删除列，如果为true则会把partition中的列也删除；如果为false则不会 DO_NOT_UPDATE_STATS: 不更新文件级别统计信息。true则不更新；false则更新 STATS_GENERATED：记录本次更新的发起者。可填：TASK/UNSET。具体作用未明确 IS_INCREMENTAL_MODIFICATION_WHEN_SET_VERSION：执行版本时是否增量更新，可填：true/false，默认为true **约束限制:** 长度为0\~255个字符 **取值范围:** 长度为0\~255个字符 **默认取值:** 不涉及 | | version_id | 否 | String | **参数解释:** 版本ID **约束限制:** 长度为24个字符 **取值范围:** 长度为24个字符 **默认取值:** 不涉及 | | table | 是 | [UpdateTableInput] object | 表输入模型。 | | is_async | 否 | Boolean | **参数解释:** 是否异步修改，默认为false **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** false | 表4UpdateTableInput | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | table_name | 否 | String | **参数解释:** 表名称。只能包含中文、字母、数字、下划线、中划线，且长度为1\~256个字符 **约束限制:** 长度为1\~256个字符 **取值范围:** 长度为1\~256个字符 **默认取值:** 不涉及 | | table_format | 否 | String | **参数解释:** 表格式。支持{HIVE,ICEBERG,LANCE}，默认值为HIVE **约束限制:** 可选值为：HIVE, ICEBERG, LANCE **取值范围:** 不涉及 **默认取值:** HIVE | | table_type | 否 | String | **参数解释:** 表类型：MANAGED_TABLE-内表、EXTERNAL_TABLE-外表、VIRTUAL_VIEW-视图、MATERIALIZED_VIEW-物化视图、DICTIONARY_TABLE字典表，LAKE_TABLE内表，LAKE_MATERIALIZED_VIEW内部物化视图 **约束限制:** 可选值为：MANAGED_TABLE, EXTERNAL_TABLE, VIRTUAL_VIEW, MATERIALIZED_VIEW, DICTIONARY_TABLE, LAKE_TABLE, LAKE_MATERIALIZED_VIEW **取值范围:** 不涉及 **默认取值:** 不涉及 | | owner | 否 | String | **参数解释:** 表所有者。只能包含字母、数字和下划线，且长度为1\~49个字符 **约束限制:** 长度为1\~49个字符 **取值范围:** 长度为1\~49个字符 **默认取值:** 不涉及 | | owner_type | 否 | String | **参数解释:** 所有者类型：USER-用户、GROUP-组、ROLE-角色 **约束限制:** 可选值为：USER, GROUP, ROLE **取值范围:** 不涉及 **默认取值:** 不涉及 | | create_time | 否 | String | **参数解释:** 表创建时间 **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** 不涉及 | | last_access_time | 否 | String | **参数解释:** 最近一次访问时间 **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** 不涉及 | | last_analyzed_time | 否 | String | **参数解释:** 最近一次分析统计时间 **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** 不涉及 | | partition_keys | 否 | Array of [Column] objects | **参数解释:** 分区列的信息 **约束限制:** 数组元素个数为0\~100 **取值范围:** 数组元素个数为0\~100 **默认取值:** 不涉及 | | retention | 否 | Integer | **参数解释:** 表保留时间 **约束限制:** 取值为0\~2147483647 **取值范围:** 取值为0\~2147483647 **默认取值:** 不涉及 | | storage_descriptor | 否 | [StorageDescriptor] object | **参数解释:** 数据存储 **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** 不涉及 | | parameters | 否 | Map\ | **参数解释:** 表参数信息，键和值为字符串，长度不超过100000 **约束限制:** 长度为0\~100000个字符 **取值范围:** 长度为0\~100000个字符 **默认取值:** 不涉及 | | comments | 否 | String | **参数解释:** 表描述信息。由用户创建表时输入，最大长度为4000个字符 **约束限制:** 长度为0\~4000个字符 **取值范围:** 长度为0\~4000个字符 **默认取值:** 不涉及 | | view_expanded_text | 否 | String | **参数解释:** 如果表是视图，则为视图的扩展文本 **约束限制:** 长度为0\~409600个字符 **取值范围:** 长度为0\~409600个字符 **默认取值:** 不涉及 | | view_original_text | 否 | String | **参数解释:** 如果表是视图，则为视图的原始文本 **约束限制:** 长度为0\~409600个字符 **取值范围:** 长度为0\~409600个字符 **默认取值:** 不涉及 | | ignore_obs_checked | 否 | Boolean | **参数解释:** 是否忽略内表建表时对Obs路径的限制 **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** false | | external_table_id | 否 | String | **参数解释:** 用户端表id，创建时指定，不可修改 **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** 不涉及 | | data_statistic_enable | 否 | Boolean | **参数解释:** 数据概况统计开关。默认状态为开，修改table开关状态后，还需检查所属database的开关状态。例如：table与所属database开关同时打开，则数据概况统计开启。否则关闭 **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** 不涉及 | | version_id | 否 | String | **参数解释:** 版本ID，可在修改时传入，默认为最新版本 **约束限制:** 长度为24个字符 **取值范围:** 长度为24个字符 **默认取值:** 不涉及 | 表5StorageDescriptor | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | columns | 是 | Array of [Column] objects | **参数解释:** 分区列以外的所有字段 **约束限制:** 数组元素个数为0\~10000 **取值范围:** 数组元素个数为0\~10000 **默认取值:** 不涉及 | | location | 否 | String | **参数解释:** 路径地址。例如obs://location/uri/ **约束限制:** 最大长度为4000 **取值范围:** 最大长度为4000 **默认取值:** 不涉及 | | compressed | 是 | Boolean | **参数解释:** 是否启用数据压缩。默认为false **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** false | | input_format | 否 | String | **参数解释:** 输入格式 **约束限制:** 长度为0\~128个字符 **取值范围:** 长度为0\~128个字符 **默认取值:** 不涉及 | | output_format | 否 | String | **参数解释:** 输出格式 **约束限制:** 长度为0\~128个字符 **取值范围:** 长度为0\~128个字符 **默认取值:** 不涉及 | | number_of_buckets | 否 | Integer | **参数解释:** 分桶的桶数量。默认值为0 **约束限制:** 取值为-1\~2147483647 **取值范围:** 取值为-1\~2147483647 **默认取值:** 0 | | bucket_columns | 否 | Array of strings | **参数解释:** 分桶字段 **约束限制:** 数组元素个数为0\~200 **取值范围:** 长度为1\~255个字符，数组元素个数为0\~200 **默认取值:** 不涉及 | | sort_columns | 否 | Array of [Order] objects | **参数解释:** 指定表中的每个存储桶的排序顺序的列表 **约束限制:** 数组元素个数为0\~10000 **取值范围:** 数组元素个数为0\~10000 **默认取值:** 不涉及 | | serde_info | 是 | [SerDeInfo] object | **参数解释:** 序列化/反序列化信息 **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** 不涉及 | | parameters | 是 | Map\ | **参数解释:** 存储描述符的参数，键和值为字符串，长度不超过100000 **约束限制:** 长度为0\~100000个字符 **取值范围:** 长度为0\~100000个字符 **默认取值:** 不涉及 | | skewed_info | 否 | [SkewedInfo] object | **参数解释:** 有关在列中经常出现的值（偏斜值）的信息 **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** 不涉及 | | stored_as_sub_directories | 否 | Boolean | **参数解释:** 数据是否会存放在子目录中 **约束限制:** 不涉及 **取值范围:** 不涉及 **默认取值:** false | 表6Column | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | column_type | 是 | String | **参数解释:** 列类型。 **约束限制:** 长度为1\~65535个字符 列类型，包括array bigint binary boolean char date decimal double float int interval map set smallint string struct timestamp tinyint union varchar **取值范围:** 长度为1\~65535个字符 **默认取值:** 不涉及 | | column_name | 是 | String | **参数解释:** 列名称。只能包含中文、字母、数字和_-+\*(), 特殊字符，且长度为1\~767个字符 **约束限制:** 长度为1\~767个字符 **取值范围:** 长度为1\~767个字符 **默认取值:** 不涉及 | | comment | 否 | String | **参数解释:** 列描述信息。最大长度为4000个字符 **约束限制:** 长度为0\~4000个字符 **取值范围:** 长度为0\~4000个字符 **默认取值:** 不涉及 | | advance_column_type | 否 | String | **参数解释:** 用户自定义类型名称，当且仅当column_type为struct，字段可填写。该字段存在值时，表示用户自定义的高阶类型 **约束限制:** 长度为0\~64个字符 **取值范围:** 长度为0\~64个字符 **默认取值:** 不涉及 | 表7Order | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | column | 否 | String | **参数解释:** 列名称。只能包含中文、字母、数字和_-+\*(), 特殊字符，且长度为1\~767个字符 **约束限制:** 长度为1\~767个字符 **取值范围:** 长度为1\~767个字符 **默认取值:** 不涉及 | | sort_order | 否 | Integer | **参数解释:** 指示是按升序 (== 1) 还是降序 (==0) 对列进行排序 **约束限制:** 取值为0\~1 **取值范围:** 取值为0\~1 **默认取值:** 不涉及 | 表8SerDeInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 否 | String | **参数解释:** 名称信息 **约束限制:** 长度为0\~256个字符 **取值范围:** 长度为0\~256个字符 **默认取值:** 不涉及 | | serialization_library | 否 | String | **参数解释:** 实现序列化/反序列化的类 **约束限制:** 长度为0\~256个字符 **取值范围:** 长度为0\~256个字符 **默认取值:** 不涉及 | | parameters | 否 | Map\ | **参数解释:** 参数数组，键和值为字符串，长度不超过100000 **约束限制:** 长度为0\~100000个字符 **取值范围:** 长度为0\~100000个字符 **默认取值:** 不涉及 | 表9SkewedInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | skewed_column_names | 是 | Array of strings | **参数解释:** 数据偏移列的列表 **约束限制:** 数组元素个数为0\~100000 **取值范围:** 长度为1\~256个字符，数组元素个数为0\~100000 **默认取值:** 不涉及 | | skewed_column_value_location_maps | 是 | Map\ | **参数解释:** 偏斜值和地址的映射关系 **约束限制:** 长度为0\~65534个字符 **取值范围:** 长度为0\~65534个字符 **默认取值:** 不涉及 | | skewed_column_values | 是 | Array\\> | **参数解释:** 偏斜值的列表 **约束限制:** 数组元素个数为0\~100000 **取值范围:** 长度为0\~65534个字符，数组元素个数为0\~100000 **默认取值:** 不涉及 | #### 响应参数 **状态码：200** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | catalog_name | String | **参数解释:** catalog名称 | | catalog_id | String | **参数解释:** catalogID | | database_name | String | **参数解释:** 数据库名称 | | database_id | String | **参数解释:** 数据库ID | | table_name | String | **参数解释:** 表名称 | | table_id | String | **参数解释:** 表ID | | table_status | Integer | **参数解释:** 表状态，0表示正常，1表示删除中，2表示已删除，3表示恢复中，4表示清除中 | | external_table_id | String | **参数解释:** 用户端表id，创建时指定，不可修改 | | create_time | String | **参数解释:** 表创建时间 | | last_access_time | String | **参数解释:** 最后访问时间 | | update_time | String | **参数解释:** 表元数据最后一次修改时间 | | last_analyzed_time | String | **参数解释:** 上一次做列级别的统计信息计算的时间 | | owner | String | **参数解释:** 用户信息 | | owner_type | String | **参数解释:** 用户类型，USER-用户，GROUP-组，ROLE-角色 | | parameters | Map\ | **参数解释:** 参数 | | partition_keys | Array of [Column] objects | **参数解释:** 表分区列的列表 | | retention | Integer | **参数解释:** 表保留时间 | | storage_descriptor | [StorageDescriptor] object | **参数解释:** 数据存储 | | table_format | String | **参数解释:** 表格式。支持{HIVE,ICEBERG,LANCE}，默认值为HIVE | | table_type | String | **参数解释:** 表类型，MANAGED_TABLE-内表，EXTERNAL_TABLE-外表，VIRTUAL_VIEW-视图，MATERIALIZED_VIEW-物化视图，DICTIONARY_TABLE字典表，LAKE_TABLE内表，LAKE_MATERIALIZED_VIEW-内部物化视图 | | comments | String | **参数解释:** 表描述信息 | | view_expanded_text | String | **参数解释:** 如果表是视图，则为视图的扩展文本 | | view_original_text | String | **参数解释:** 如果表是视图，则为视图的原始文本 | | data_statistic_enable | Boolean | **参数解释:** 数据概况统计开关。默认状态为开，修改table开关状态后，还需检查所属database的开关状态。例如：table与所属database开关同时打开，则数据概况统计开启。否则关闭 | | version_id | String | **参数解释:** 版本ID | 表11StorageDescriptor | 参数 | 参数类型 | 描述 | |:---|:---|:---| | columns | Array of [Column] objects | **参数解释:** 分区列以外的所有字段 **取值范围:** 数组元素个数为0\~10000 | | location | String | **参数解释:** 路径地址。例如obs://location/uri/ **取值范围:** 最大长度为4000 | | compressed | Boolean | **参数解释:** 是否启用数据压缩。默认为false **取值范围:** 不涉及 | | input_format | String | **参数解释:** 输入格式 **取值范围:** 长度为0\~128个字符 | | output_format | String | **参数解释:** 输出格式 **取值范围:** 长度为0\~128个字符 | | number_of_buckets | Integer | **参数解释:** 分桶的桶数量。默认值为0 **取值范围:** 取值为-1\~2147483647 | | bucket_columns | Array of strings | **参数解释:** 分桶字段 **取值范围:** 长度为1\~255个字符，数组元素个数为0\~200 | | sort_columns | Array of [Order] objects | **参数解释:** 指定表中的每个存储桶的排序顺序的列表 **取值范围:** 数组元素个数为0\~10000 | | serde_info | [SerDeInfo] object | **参数解释:** 序列化/反序列化信息 **取值范围:** 不涉及 | | parameters | Map\ | **参数解释:** 存储描述符的参数，键和值为字符串，长度不超过100000 **取值范围:** 长度为0\~100000个字符 | | skewed_info | [SkewedInfo] object | **参数解释:** 有关在列中经常出现的值（偏斜值）的信息 **取值范围:** 不涉及 | | stored_as_sub_directories | Boolean | **参数解释:** 数据是否会存放在子目录中 **取值范围:** 不涉及 | 表12Column | 参数 | 参数类型 | 描述 | |:---|:---|:---| | column_type | String | **参数解释:** 列类型。 **取值范围:** 长度为1\~65535个字符 | | column_name | String | **参数解释:** 列名称。只能包含中文、字母、数字和_-+\*(), 特殊字符，且长度为1\~767个字符 **取值范围:** 长度为1\~767个字符 | | comment | String | **参数解释:** 列描述信息。最大长度为4000个字符 **取值范围:** 长度为0\~4000个字符 | | advance_column_type | String | **参数解释:** 用户自定义类型名称，当且仅当column_type为struct，字段可填写。该字段存在值时，表示用户自定义的高阶类型 **取值范围:** 长度为0\~64个字符 | 表13Order | 参数 | 参数类型 | 描述 | |:---|:---|:---| | column | String | **参数解释:** 列名称。只能包含中文、字母、数字和_-+\*(), 特殊字符，且长度为1\~767个字符 **取值范围:** 长度为1\~767个字符 | | sort_order | Integer | **参数解释:** 指示是按升序 (== 1) 还是降序 (==0) 对列进行排序 **取值范围:** 取值为0\~1 | 表14SerDeInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释:** 名称信息 **取值范围:** 长度为0\~256个字符 | | serialization_library | String | **参数解释:** 实现序列化/反序列化的类 **取值范围:** 长度为0\~256个字符 | | parameters | Map\ | **参数解释:** 参数数组，键和值为字符串，长度不超过100000 **取值范围:** 长度为0\~100000个字符 | 表15SkewedInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | skewed_column_names | Array of strings | **参数解释:** 数据偏移列的列表 **取值范围:** 长度为1\~256个字符，数组元素个数为0\~100000 | | skewed_column_value_location_maps | Map\ | **参数解释:** 偏斜值和地址的映射关系 **取值范围:** 长度为0\~65534个字符 | | skewed_column_values | Array\\> | **参数解释:** 偏斜值的列表 **取值范围:** 长度为0\~65534个字符，数组元素个数为0\~100000 | **状态码：201** Created **状态码：400** 表16响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | solution_msg | String | **参数解释:** 解决方案描述 | **状态码：401** 表17响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | solution_msg | String | **参数解释:** 解决方案描述 | **状态码：403** 表18响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [Error] object | **参数解释:** 错误信息 | | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | title | String | **参数解释:** 标题 | 表19Error | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | title | String | **参数解释:** 标题 | | message | String | **参数解释:** 错误信息 | | code | String | **参数解释:** 状态码 | **状态码：404** 表20响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | solution_msg | String | **参数解释:** 解决方案描述 | **状态码：408** 表21响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | solution_msg | String | **参数解释:** 解决方案描述 | **状态码：500** 表22响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | solution_msg | String | **参数解释:** 解决方案描述 | #### 请求示例 ``` PUT https://{endpoint}/v1/{project_id}/instances/{instance_id}/catalogs/{catalog_name}/databases/{database_name}/tables/{table_name} { "alter_params" : { "CASCADE" : "TRUE" }, "table" : { "table_name" : "tbl08e39978e97b4266a7074fd92127e032", "table_format" : "HIVE", "table_type" : "EXTERNAL_TABLE", "owner" : "onebox", "owner_type" : "USER", "create_time" : "2023-05-31T02:06:58.000+00:00", "last_access_time" : "2023-05-31T02:06:58.000+00:00", "last_analyzed_time" : "2023-05-31T02:06:58.000+00:00", "partition_keys" : [ { "column_type" : "string", "column_name" : "column_prefix0", "comment" : "372f0f259ed049f5876050dcd13df630" }, { "column_type" : "string", "column_name" : "column_prefix1", "comment" : "6bb9dd73db49498d9aaabd343bfad689" } ], "retention" : 1000, "storage_descriptor" : { "columns" : [ { "column_type" : "string", "column_name" : "column_prefix0", "comment" : "4a4eca73554c4117b480fd73d8d6697b" }, { "column_type" : "string", "column_name" : "column_prefix1", "comment" : "5dc9df8676324e989440b0e6669d9338" }, { "column_type" : "string", "column_name" : "column_prefix2", "comment" : "b73c6fdb55594366bcd25c45ffbbee47" }, { "column_type" : "string", "column_name" : "column_prefix3", "comment" : "74fe507023414e2ba6137aaee059c3f9" }, { "column_type" : "string", "column_name" : "column_prefix4", "comment" : "4bd450c11ea24884875cd62e9d3e42dc" }, { "column_type" : "string", "column_name" : "column_prefix5", "comment" : "2457eea4a38e4ead8bbc065985279544" }, { "column_type" : "string", "column_name" : "column_prefix6", "comment" : "39b5869cea974e1488a47584acf4c313" }, { "column_type" : "string", "column_name" : "column_prefix7", "comment" : "90928727a6bb4c6ca2e3497ea9b31bf8" }, { "column_type" : "string", "column_name" : "column_prefix8", "comment" : "90d6544f85004c58a056891f7d00fbb2" }, { "column_type" : "string", "column_name" : "column_prefix9", "comment" : "8e993211dcad4adbacc360c9e5d0bbd9" } ], "location" : "obs://location/test/database/7b2fad385fd8434cbb8e759094a068cf", "compressed" : false, "input_format" : "9ea8ec4fc8dc4faaa8e5d1ed1e2db776", "output_format" : "ce56f7ea7a754a14a5c4525b296cc6f1", "number_of_buckets" : 0, "bucket_columns" : [ ], "sort_columns" : [ ], "serde_info" : { "name" : "f69aa43399ec498dbc42290d8e26ac6d", "serialization_library" : "fe216304f4f84411ba2d52b32688bfe6", "parameters" : { "f2d383124614470895a0ce2619bf3a32" : "69ee824ac98944d78f321af7a6edd538" } }, "parameters" : { "dbc72b6d947e4d6f9a4b5ec081ebd07a" : "e5f22c513e984e3cb279ba5e40a2f69a", "64eb05edecae4722befd2e3575d3cbe8" : "656c632c586940649fcc1a4e62c8c0a1" }, "skewed_info" : { "skewed_column_names" : [ ], "skewed_column_value_location_maps" : { }, "skewed_column_values" : [ ] }, "stored_as_sub_directories" : false }, "parameters" : { "key1" : "value1", "transient_lastDdlTime" : "120", "classification" : "other" }, "comments" : "comment info" } } ``` #### 响应示例 **状态码：200** OK ``` { "catalog_name" : "hive", "database_name" : "dba", "table_name" : "www", "create_time" : "2022-11-19T03:10:14.000+00:00", "last_access_time" : "2022-12-31T23:59:59.000+00:00", "update_time" : null, "last_analyzed_time" : null, "owner" : "lakeformation", "owner_type" : "USER", "parameters" : { "ww" : "ww", "transient_lastDdlTime" : "1668827414", "classification" : "avro", "www" : "ww", "wwww" : "ww" }, "partition_keys" : [ ], "retention" : 0, "storage_descriptor" : { "columns" : [ { "column_type" : "tinyint", "column_name" : "ww", "comment" : null } ], "location" : "obs://lakeformation/test", "compressed" : true, "input_format" : "org.apache.hadoop.hive.ql.io.avro.AvroContainerInputFormat", "output_format" : "org.apache.hadoop.hive.ql.io.avro.AvroContainerOutputFormat", "number_of_buckets" : 0, "bucket_columns" : [ ], "sort_columns" : [ ], "serde_info" : { "name" : "name", "serialization_library" : "org.apache.hadoop.hive.serde2.avro.AvroSerDe", "parameters" : { "serialization.format" : "1" } }, "parameters" : { }, "skewed_info" : { "skewed_column_names" : [ ], "skewed_column_value_location_maps" : { }, "skewed_column_values" : [ ] }, "stored_as_sub_directories" : false }, "table_type" : "MANAGED_TABLE", "comments" : "", "view_expanded_text" : "", "view_original_text" : "" } ``` **状态码：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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-lakeformation/ErrorCode.html)。