全部產品
Search
文件中心

:GetColumn - 擷取資料地圖資料表欄位資訊

更新時間:Mar 21, 2026

擷取資料地圖資料表給定欄位的詳細資料。

介面說明

  1. 需要購買 DataWorks 基礎版及以上版本才能使用。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

Id

string

ID,可參考 ListColumns 介面返回結果,以及中繼資料實體相關概念說明

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

說明

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

說明

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

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

maxcompute-column:::project_name:[schema_name]:table_name:column_name

dlf-column::catalog_id:database_name::table_name:column_name

hms-column:instance_id::database_name::table_name:column_name

holo-column:instance_id::database_name:schema_name:table_name:column_name

mysql-column:(instance_id|encoded_jdbc_url)::database_name::table_name:column_name

說明

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







maxcompute-column:::project_name:[schema_name]:table_name:column_name

返回參數

名稱

類型

描述

樣本值

object

返回結果。

RequestId

string

請求 ID。

D1E2E5BC-xxxx-xxxx-xxxx-xxxxxx

Success

boolean

請求是否成功。

true

Column Column

欄位列表。

樣本

正常返回樣本

JSON格式

{
  "RequestId": "D1E2E5BC-xxxx-xxxx-xxxx-xxxxxx",
  "Success": true,
  "Column": {
    "Id": "maxcompute-column:123456::test_project:default:test_tbl:col1",
    "Name": "col1",
    "Comment": "欄位1",
    "TableId": "maxcompute-table:123456::test_project:default:test_tbl",
    "Position": 1,
    "Type": "bigint",
    "PrimaryKey": false,
    "PartitionKey": false,
    "ForeignKey": false,
    "BusinessMetadata": {
      "Description": "欄位1的業務描述"
    }
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情