首页 数据湖构建 API参考指南 API目录 元数据 表 ListTables - 获取元数据表列表

ListTables - 获取元数据表列表

获取数据湖元数据表列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用背景高亮的方式表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
dlf:ListTablesLIST
  • DataLake
    acs:dlf:{#regionId}:{#accountId}:*
    无
无

请求参数

名称类型必填描述示例值
CatalogIdstring否

数据库分类命名空间，默认填写主账号Uid

1344371
TableNamePatternstring否

元数据表名称，正则表达式匹配

.*
NextPageTokenstring否

翻页token，从返回结果返回，无则传空字符串或''

''
PageSizeinteger否

每页大小

10
DatabaseNamestring否

元数据库名称

database_test
TableTypestring否

元数据表的类型：例如MANAGED_TABLE，EXTERNAL_TABLE，VIRTUAL_VIEW，INDEX_TABLE，MATERIALIZED_VIEW

MANAGED_TABLE

返回参数

名称类型描述示例值
object

返回结果体

Codestring

状态码描述

OK
Messagestring

提示相关错误信息

.
NextPageTokenstring

翻页token

2cb472ec1bf84f8d92f9c4baa0d21c19aa
RequestIdstring

请求ID

B7F4B621-E41E-4C84-B97F-42B5380A32BB
Successboolean

是否成功

true
Tablesarray

元数据表列表

Table

元数据表详细信息

Code错误码说明
InternalError：其他类型错误，请参考Message提示

示例

正常返回示例

JSON格式

{
  "Success": true,
  "Code": "OK",
  "Message": "",
  "HttpStatusCode": 200,
  "NextPageToken": "2cb472ec1bf84f8d92f9c4baa0d21c19aa",
  "RequestId": "B7F4B621-E41E-4C84-B97F-42B5380A32BB",
  "Tables": [
    {
      "Cascade": false,
      "TableName": "test_table_20200715162543389",
      "DatabaseName": "hivedb",
      "TableType": "MANAGED_TABLE",
      "Description": "",
      "Retention": 365,
      "Sd": {
        "Cols": [
          {
            "Comment": "user_name",
            "Name": "name",
            "Type": "string",
            "Parameters": {}
          }
        ],
        "Compressed": false,
        "InputFormat": "input",
        "Location": "",
        "NumBuckets": 5,
        "OutputFormat": "output",
        "Parameters": {},
        "SerDeInfo": {
          "Name": "",
          "SerializationLib": "",
          "Parameters": {}
        },
        "SkewedInfo": {
          "SkewedColNames": [],
          "SkewedColValues": [],
          "SkewedColValueLocationMaps": {}
        },
        "BucketCols": [
          "col1"
        ],
        "SortCols": [
          {
            "Order": 0,
            "Col": "col"
          }
        ],
        "StoredAsSubDirectories": false
      },
      "PartitionKeys": [
        {
          "Comment": "comment_day",
          "Name": "day",
          "Type": "int",
          "Parameters": {}
        }
      ],
      "Parameters": {},
      "ViewOriginalText": "",
      "ViewExpandedText": "",
      "CreatedBy": "",
      "Privileges": {},
      "RewriteEnabled": true,
      "Temporary": false,
      "OwnerType": {},
      "CreateTime": 0,
      "UpdateTime": 0,
      "LastAccessTime": 0,
      "LastAnalyzedTime": 0
    }
  ]
}

错误码

访问错误中心查看更多错误码。
阿里云首页 数据湖构建 相关技术圈