GetTableInfo - 获取表信息

更新时间:
复制 MD 格式

查看MaxCompute内部表、视图、外部表、聚簇表或Transactional表的信息。

调试

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

调试

授权信息

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

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

odps:GetTableInfo

get

*Project

acs:odps:{#regionId}:{#accountId}:projects/{#ProjectName}

无 无

请求语法

GET /api/v1/projects/{projectName}/tables/{tableName} HTTP/1.1

路径参数

名称

类型

必填

描述

示例值

projectName

string

是

待查看表或视图的所属项目名称。

odps_project

tableName

string

是

待查看表或视图的名称。

sale_detail

请求参数

名称

类型

必填

描述

示例值

schemaName

string

否

待查看表或视图的所属 Schema 名称。

default

type

string

否

待查看表或视图的类型。取值:

  • internal:内部表。

  • external:外部表。

  • view:视图。

  • materializedView:物化视图 。

internal

返回参数

名称

类型

描述

示例值

object

请求返回参数。

requestId

string

请求 ID。

0a06dd4516687375802853481ec9fd

data

object

请求返回结果。

name

string

表或视图名称。

sale_detail

owner

string

表或视图的所有者账号信息。

ALIYUN$odps****@aliyunid.com

type

string

表或视图类型。取值:

  • internal:内部表。

  • external:外部表。

  • view:视图。

  • materializedView:物化视图 。

internal

schema

string

表或视图的所属 Schema 名称。

default

creationTime

integer

创建时间。

1782409156000

viewText

string

生成视图的语句,当类型为视图时有此返回值。

select shop_name, sum(total_price) from sale_detail group by shop_name

displayName

string

展示名称。

odps_project.default.sale_detail

projectName

string

表或视图的所属项目名称。

odps_project

lastDDLTime

integer

表或视图的 DDL 最后变更时间。

1782409157000

lastModifiedTime

integer

表或视图的数据最后变更时间。

1782409156000

lastAccessTime

integer

表或视图的数据最后访问时间,当表为非分区表时有此返回值。

说明

该数据从 2023 年 7 月陆续升级采集,在升级后没有被访问过或者通过 ALGO 作业、Hologres 直读方式访问的无法采集到 last_access_time。

1782409157000

lifecycle

string

生命周期(天)。

-1

isExternalTable

boolean

是否为外部表,当类型为表时有此返回值。

false

size

integer

如果表为非分区表,值为表的数据量大小。如果表为分区表,系统不会计算表的数据量大小,值为 NULL。PARTITIONS 视图中包含分区表各个分区的数据量大小。单位:字节(Byte)。

5372

comment

string

表注释。

sale_detail

tableLabel

string

表的敏感等级标签。更多信息请参见Label 权限控制 。

0

createTableDDL

string

创建表的 DDL 语句。

create table if not exists sale_detail( shop_name STRING, customer_id STRING, total_price DOUBLE) partitioned by (sale_date STRING, region STRING);

nativeColumns

array<object>

字段信息。

object

字段信息。

name

string

列名。

shop_name

type

string

数据类型。

STRING

label

string

列的敏感等级标签。更多信息请参见Label 权限控制 。

0

comment

string

列注释。

商店名称

partitionColumns

array<object>

分区列信息,分区表才有此返回值。

object

分区列信息。

name

string

分区名。

ds='20190130'

type

string

数据类型。

STRING

label

string

列的敏感等级标签。更多信息请参见Label 权限控制 。

0

comment

string

分区列注释。

销售日期

materializedView

boolean

是否为物化视图 。

false

rewriteEnabled

boolean

是否允许通过物化视图执行查询改写操作,当类型为物化视图时有此返回值。

false

autoRefreshEnabled

boolean

是否开启自动刷新物化视图,当类型为物化视图时有此返回值。

false

isOutdated

boolean

是否因为源表数据有变化,导致物化视图数据无效,当类型为物化视图时有此返回值。

false

physicalSize

integer

物理大小。

2763

fileNum

integer

文件数量。

200

storageHandler

string

外部表解析器,当类型为外部表时有此返回值。

com.aliyun.odps.CsvStorageHandler

location

string

外部表地址,当类型为外部表时有此返回值。

oss://oss-cn-hangzhou-internal.aliyuncs.com/oss-mc-test/Demo1/

odpsPropertiesRolearn

string

RAM 中 AliyunODPSDefaultRole 的 ARN 信息,当类型为外部表时有此返回值。

acs:ram::xxxxx:role/aliyunodpsdefaultrole

tablestoreColumnsMapping

string

描述 MaxCompute 将访问的 Tablestore 表的列,包括主键和属性列,当类型为外部表时有此返回值。

o_orderkey,o_orderdate,o_custkey,o_orderstatus,o_totalprice

tablesotreTableName

string

需要访问的 Tablestore 表名称,当类型为外部表时有此返回值。

ots_tpch_orders

odpsSqlTextOptionFlushHeader

boolean

是否忽略表头,当类型为外部表时有此返回值。

true

odpsTextOptionHeaderLinesCount

integer

忽略表头前 N 行,当类型为外部表时有此返回值。

1

clusterInfo

object

聚簇属性,当表类型为聚簇表时有此返回值。

clusterType

string

表的聚簇(Clustering)类型,MaxCompute 当前支持Hash Clustering 和 Range Clustering 两种类型。

Hash

clusterCols

array

聚簇字段(Cluster Key)。

string

聚簇字段(Cluster Key)。

col_1

sortCols

array<object>

排序字段。

object

排序字段。

name

string

排序字段名称。

col_2

order

string

排序方式。

DESC

bucketNum

integer

可选字段,Cluster 表的 Bucket 数目,0 表示作业执行时动态决定。

1024

示例

正常返回示例

JSON格式

{
  "requestId": "0a06dd4516687375802853481ec9fd",
  "data": {
    "name": "sale_detail",
    "owner": "ALIYUN$odps****@aliyunid.com",
    "type": "internal",
    "schema": "default",
    "creationTime": 1782409156000,
    "viewText": "select shop_name, sum(total_price) from sale_detail group by shop_name",
    "displayName": "odps_project.default.sale_detail",
    "projectName": "odps_project",
    "lastDDLTime": 1782409157000,
    "lastModifiedTime": 1782409156000,
    "lastAccessTime": 1782409157000,
    "lifecycle": "-1",
    "isExternalTable": false,
    "size": 5372,
    "comment": "sale_detail",
    "tableLabel": "0",
    "createTableDDL": "create table if not exists sale_detail( shop_name STRING, customer_id STRING, total_price DOUBLE) partitioned by (sale_date STRING, region STRING);",
    "nativeColumns": [
      {
        "name": "shop_name",
        "type": "STRING",
        "label": "0",
        "comment": "商店名称"
      }
    ],
    "partitionColumns": [
      {
        "name": "ds='20190130'",
        "type": "STRING",
        "label": "0",
        "comment": "销售日期"
      }
    ],
    "materializedView": false,
    "rewriteEnabled": false,
    "autoRefreshEnabled": false,
    "isOutdated": false,
    "physicalSize": 2763,
    "fileNum": 200,
    "storageHandler": "com.aliyun.odps.CsvStorageHandler",
    "location": "oss://oss-cn-hangzhou-internal.aliyuncs.com/oss-mc-test/Demo1/",
    "odpsPropertiesRolearn": "acs:ram::xxxxx:role/aliyunodpsdefaultrole",
    "tablestoreColumnsMapping": "o_orderkey,o_orderdate,o_custkey,o_orderstatus,o_totalprice",
    "tablesotreTableName": "ots_tpch_orders",
    "odpsSqlTextOptionFlushHeader": true,
    "odpsTextOptionHeaderLinesCount": 1,
    "clusterInfo": {
      "clusterType": "Hash",
      "clusterCols": [
        "col_1"
      ],
      "sortCols": [
        {
          "name": "col_2",
          "order": "DESC"
        }
      ],
      "bucketNum": 1024
    }
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。