幫助中心
首頁 DataWorks 開發參考 API參考（2024-05-18） 數據結構 Table

Table

更新時間：
Copy as MD
產品

名稱

類型

描述

樣本值

object

資料表物件。

Id

string

ID，可參考中繼資料實體相關概念說明。

格式為${EntityType}:${執行個體 ID 或轉義後的 URL}:${資料目錄標識}:${資料庫名稱}:${模式名稱}:${資料表名稱}，對於不存在的層級使用空字元佔位。

說明

對於 maxcompute 和 dlf 類型，執行個體 ID 使用空字元佔位。對於 maxcompute 類型，資料庫名稱即為 maxcompute 專案名稱，開啟三層模型的專案需要提供模式名稱，未開啟的專案模式名稱處使用空字元佔位。

說明

starrocks 類型的資料目錄標識為目錄名稱，dlf 類型的資料目錄標識為目錄 ID，其他類型不支援目錄層級，可用空字元佔位。

幾種常用類型的 ID 格式如下

maxcompute-table:::project_name:[schema_name]:table_name。

dlf-table::catalog_id:database_name::table_name

hms-table:instance_id::database_name::table_name

holo-table:instance_id::database_name:schema_name:table_name

mysql-table:(instance_id|encoded_jdbc_url)::database_name::table_name

說明

其中
instance_id：執行個體 ID，對應資料來源以執行個體模式註冊時需要提供
encoded_jdbc_url：JDBC 連線串的 URLEncode 編碼，對應資料來源以連線串方式註冊時需要提供
catalog_id：dlf 目錄 ID
project_name：maxcompute 專案名稱
database_name：資料庫名稱
schema_name：schema 名稱，對於 maxcompute 類型，僅所屬專案開啟三層模型後需要提供。若未開啟則使用空字元佔位
table_name：表名稱

dlf-table::catalog_id:database_name::table_name
Name

string

名稱。

table_name
Comment

string

註釋。

测试表
TableType

string

表類型，取值與中繼資料採集器類型相關。

TABLE
PartitionKeys

array

分區鍵列表，非分區表時為空。

string

分區鍵。

ds
ParentMetaEntityId

string

父層級中繼資料實體 ID，可參考中繼資料實體相關概念說明。

  • 對於支援 schema 的類型（maxcompute/holo/postgresql/sqlserver/hybriddb_for_postgresql/oracle，其中 maxcompute 類型需要所屬專案開啟三層模型），ParentMetaEntityId 為表所屬資料庫模式，格式為${EntityType}:${執行個體 ID 或轉義後的 URL}:${資料目錄標識}:${資料庫名稱}:${模式名稱}，對於不存在的層級空字元佔位。

  • 其他類型時，ParentMetaEntityId 為表所屬資料庫，格式為${EntityType}:${執行個體 ID 或轉義後的 URL}:${資料目錄標識}:${資料庫名稱}，對於不存在的層級空字元佔位。

說明

對於 maxcompute 和 dlf 類型，執行個體 ID 使用空字元佔位。對於 maxcompute 類型，資料庫名稱即為 maxcompute 專案名稱。

說明

starrocks 類型的資料目錄標識為目錄名稱，dlf 類型的資料目錄標識為目錄 ID，其他類型不支援目錄層級，可用空字元佔位。

幾種常用類型的 ParentMetaEntityId 格式參考如下

maxcompute-project:::project_name

maxcompute-schema:::project_name:schema_name（僅專案開啟三層模型時）

dlf-database::catalog_id:database_name

hms-database:instance_id::database_name

holo-schema:instance_id::database_name:schema_name

mysql-database:(instance_id|encoded_jdbc_url)::database_name

說明

其中
instance_id：執行個體 ID，對應資料來源以執行個體模式註冊時需要提供
encoded_jdbc_url：JDBC 連線串的 URLEncode 編碼，對應資料來源以連線串方式註冊時需要提供
catalog_id：dlf 目錄 ID
project_name：maxcompute 專案名稱
database_name：資料庫名稱
schema_name：schema 名稱

dlf-database::catalog_id:database_name
CreateTime

integer

建立時間（毫秒級時間戳記）。

1736852168000
ModifyTime

integer

修改時間（毫秒級時間戳記）。

1736852168000
TechnicalMetadata

object

技術中繼資料。

Owner

string

負責人。

test_user
Location

string

儲存位置。

oss://test-bucket/test_tbl
Compressed

boolean

是否為壓縮表。

false
InputFormat

string

輸入格式。

org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat
OutputFormat

string

輸出格式。

org.apache.hadoop.hive.ql.io.parquet.MapredParquetOutputFormat
SerializationLibrary

string

SerDe 使用的類別。

org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe
Parameters

object

參數資訊。

string

參數資訊。

value
BusinessMetadata

object

業務中繼資料，DataWorks 相關，包含使用說明、標籤、類目、上游產出任務以及擴充資訊。

Readme

string

使用說明。

## 使用说明
CustomAttributes

object

自訂屬性值，key 為自訂屬性標識，value 為屬性值列表。

array

屬性值列表。

string

屬性值。

张三
Tags

array

標籤列表。

object

標籤資訊。

Key

string

標籤鍵，非空。

tag_key
Value

string

標籤值，可為空白。

tag_value
Categories

array

所屬類目列表。

array

單一類目的層級列表（多級類目）。

object

類目資訊。

Id

string

類目 ID。

CATEGORY.456
Name

string

名稱。

测试类目
ParentId

string

父類目 ID，可為空白。

CATEGORY.123
UpstreamTasks

array

上游產出任務列表。

object

上游產出任務。

Id

integer

任務 ID。

123456
Name

string

任務名稱。

test_task
Extension

object

擴充資訊，目前僅 MaxCompute 類型支援。

ProjectId

integer

工作空間 ID。

234
EnvType

string

環境類型，枚舉值，取值範圍

  • Prod：生產環境。

  • Dev：開發環境。

Dev
ViewCount

integer

瀏覽次數。

0
ReadCount

integer

讀取次數。

0
FavorCount

integer

收藏次數。

0
StatisticsInfos

object

string

上一篇：MetaEntityAttributeDef下一篇：MetaEntityDef