全部產品
Search
文件中心

Tablestore:管理預定義列

更新時間:Aug 12, 2026

Go SDK 可為已有寬表模型資料表添加或刪除預定義列。

前提條件

安裝Tablestore Go SDK並初始化用戶端。

功能說明

添加預定義列

調用 AddDefinedColumn 向指定資料表添加一個或多個預定義列。

重要

單個資料表預設最多可添加 32 個預定義列。如需超過該限制,請提交工單

func (tableStoreClient *TableStoreClient) AddDefinedColumn(request *AddDefinedColumnRequest) (*AddDefinedColumnResponse, error)

以下樣本向 example_table 添加 scorestatus 兩個預定義列。

request := &tablestore.AddDefinedColumnRequest{
    TableName: "example_table",
}
request.AddDefinedColumn("score", tablestore.DefinedColumn_INTEGER)
request.AddDefinedColumn("status", tablestore.DefinedColumn_STRING)

_, err := client.AddDefinedColumn(request)
if err != nil {
    log.Fatal(err)
}

刪除預定義列

調用 DeleteDefinedColumn 從指定資料表中刪除一個或多個預定義列。

重要

如果預定義列被二級索引引用,必須先刪除對應的二級索引,然後才能刪除該預定義列。

func (tableStoreClient *TableStoreClient) DeleteDefinedColumn(request *DeleteDefinedColumnRequest) (*DeleteDefinedColumnResponse, error)

以下樣本從 example_table 中刪除 status 預定義列。

request := &tablestore.DeleteDefinedColumnRequest{
    TableName:      "example_table",
    DefinedColumns: []string{"status"},
}

_, err := client.DeleteDefinedColumn(request)
if err != nil {
    log.Fatal(err)
}

參數說明

添加預定義列請求

AddDefinedColumnRequest 包含以下參數。

名稱

類型

說明

TableName(必選)

string

資料表名稱。

DefinedColumns(必選)

[]*DefinedColumnSchema

要添加的預定義列列表。

預定義列

DefinedColumns[] 的類型為 DefinedColumnSchema,包含以下參數。

名稱

類型

說明

Name(必選)

string

預定義列名稱。

ColumnType(必選)

DefinedColumnType

預定義列資料類型。支援 DefinedColumn_STRINGDefinedColumn_INTEGERDefinedColumn_BINARYDefinedColumn_DOUBLEDefinedColumn_BOOLEAN

刪除預定義列請求

DeleteDefinedColumnRequest 包含以下參數。

名稱

類型

說明

TableName(必選)

string

資料表名稱。

DefinedColumns(必選)

[]string

要刪除的預定義列名稱列表。