# 根据表名列举表信息 - ListTablesByName #### 功能介绍 根据表名查询数据库下的表信息列表。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/LakeFormation/doc?api=ListTablesByName)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-lakeformation/abcd.html)。 #### URI POST /v1/{project_id}/instances/{instance_id}/catalogs/{catalog_name}/databases/{database_name}/tables/list-by-names 表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个字符 **默认取值:** 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | Array of strings | **参数解释:** 租户token。 **约束限制:** 数组元素个数为1\~100 **取值范围:** 数组元素个数为1\~100 **默认取值:** 不涉及 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | table_names | 是 | Array of strings | **参数解释:** 被查询表的名称列表。最小元素数为1，最大元素数为1000 **约束限制:** 数组元素个数为1\~1000 **取值范围:** 长度为1\~256个字符，数组元素个数为1\~1000 **默认取值:** 不涉及 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | \[数组元素\] | Array of [Table] objects | table | 表5Table | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 表6StorageDescriptor | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | **参数解释:** 数据是否会存放在子目录中 **取值范围:** 不涉及 | 表7Column | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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个字符 | 表8Order | 参数 | 参数类型 | 描述 | |:---|:---|:---| | column | String | **参数解释:** 列名称。只能包含中文、字母、数字和_-+\*(), 特殊字符，且长度为1\~767个字符 **取值范围:** 长度为1\~767个字符 | | sort_order | Integer | **参数解释:** 指示是按升序 (== 1) 还是降序 (==0) 对列进行排序 **取值范围:** 取值为0\~1 | 表9SerDeInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释:** 名称信息 **取值范围:** 长度为0\~256个字符 | | serialization_library | String | **参数解释:** 实现序列化/反序列化的类 **取值范围:** 长度为0\~256个字符 | | parameters | Map\ | **参数解释:** 参数数组，键和值为字符串，长度不超过100000 **取值范围:** 长度为0\~100000个字符 | 表10SkewedInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | solution_msg | String | **参数解释:** 解决方案描述 | **状态码：401** 表12响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | solution_msg | String | **参数解释:** 解决方案描述 | **状态码：403** 表13响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [Error] object | **参数解释:** 错误信息 | | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | title | String | **参数解释:** 标题 | 表14Error | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | title | String | **参数解释:** 标题 | | message | String | **参数解释:** 错误信息 | | code | String | **参数解释:** 状态码 | **状态码：404** 表15响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | solution_msg | String | **参数解释:** 解决方案描述 | **状态码：408** 表16响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释:** 错误码 | | error_msg | String | **参数解释:** 错误描述 | | solution_msg | String | **参数解释:** 解决方案描述 | **状态码：500** 表17响应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/list-by-names { "table_names" : [ "testtable" ] } ``` #### 响应示例 **状态码：200** OK ``` [ { "catalog_name" : "hive", "database_name" : "dba", "table_name" : "aa", "create_time" : "2022-11-23T02:34:23.000+00:00", "last_access_time" : "2022-12-31T23:59:59.000+00:00", "update_time" : null, "last_analyzed_time" : null, "owner" : "owner", "owner_type" : "USER", "parameters" : { "transient_lastDdlTime" : "1669170863", "classification" : "avro" }, "partition_keys" : [ ], "retention" : 0, "storage_descriptor" : { "columns" : [ { "column_type" : "int", "column_name" : "a", "comment" : "a" } ], "location" : "obs://lakeformation-test/test/aa", "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" : "" } ] ``` **状态码：201** Created ``` { "tables" : [ { "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" : "" } ], "page_info" : { "current_count" : 1, "next_marker" : null, "previous_marker" : null } } ``` **状态码：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)。