すべてのプロダクト
Search
ドキュメントセンター

Tablestore:事前定義列の管理

最終更新日:Aug 12, 2026

Tablestore SDK for Go を使用して、既存の Wide Column モデルのテーブルに事前定義列を追加または削除します。

前提条件

Tablestore SDK for Go をインストールし、クライアントを初期化します。

説明

事前定義列の追加

AddDefinedColumn を呼び出して、テーブルに 1 つ以上の事前定義列を追加します。

重要

デフォルトでは、テーブルに最大 32 個の事前定義列を追加できます。この上限を引き上げるには、チケットを送信

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

次のサンプルでは、example_table テーブルに事前定義列 score および status を追加します。

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 を呼び出して、テーブルから 1 つ以上の事前定義列を削除します。

重要

事前定義列がセカンダリインデックスから参照されている場合は、事前定義列を削除する前に、対応するセカンダリインデックスを削除する必要があります。

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

削除する事前定義列の名前。