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

Tablestore:定義済み列の操作

最終更新日:Jun 25, 2025

このトピックでは、Go 用 Tablestore SDK を使用してデータテーブルの定義済み列を追加または削除する方法について説明します。

使用方法

  • データテーブルには最大 32 個の定義済み列を指定できます。ビジネス要件がこの制限を超える場合は、チケットを送信してください。

  • 定義済み列がセカンダリインデックスによって参照されている場合は、定義済み列を削除する前に、セカンダリインデックスを削除する必要があります。

前提条件

クライアントが初期化されていること。詳細については、「Tablestore クライアントを初期化する」をご参照ください。

定義済み列を追加する

メソッド

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

AddDefinedColumnRequest パラメーター

  • TableName(必須) string:データテーブルの名前。

  • DefinedColumns(必須) []*DefinedColumnSchema:定義済み列に関する情報。各定義済み列には、次のパラメーターが含まれます。

    パラメーター

    タイプ

    説明

    Name(必須)

    string

    定義済み列の名前。

    ColumnType(必須)

    DefinedColumnType

    定義済み列のデータ型。

    • データ型には、STRING、INTEGER、BINARY、DOUBLE、BOOLEAN が含まれます。

サンプルコード

次のサンプルコードは、String 型の name という名前の定義済み列を test_table テーブルに追加します。

func AddDefinedColumnSample(client *tablestore.TableStoreClient) {
    addDefinedColumnRequest := new(tablestore.AddDefinedColumnRequest)
    addDefinedColumnRequest.AddDefinedColumn("name", tablestore.DefinedColumn_STRING)
    addDefinedColumnRequest.TableName = "test_table"
    _, err := client.AddDefinedColumn(addDefinedColumnRequest)
    if err != nil {
        fmt.Println("Failed to add DefinedColumn with error:", err) // DefinedColumn の追加に失敗しました:
    } else {
        fmt.Println("Add DefinedColumn finished.") // DefinedColumn の追加が完了しました。
    }
}

定義済み列を削除する

メソッド

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

DeleteDefinedColumnRequest パラメーター

  • TableName(必須) string:データテーブルの名前。

  • DefinedColumns(必須) []string:定義済み列に関する情報。

サンプルコード

次のサンプルコードは、test_table テーブルから name という名前の定義済み列を削除します。

func DeleteDefinedColumnSample(client *tablestore.TableStoreClient) {
    deleteDefinedColumnRequest := new(tablestore.DeleteDefinedColumnRequest)
    deleteDefinedColumnRequest.DefinedColumns = []string{"name"}
    deleteDefinedColumnRequest.TableName = "test_table"
    _, err := client.DeleteDefinedColumn(deleteDefinedColumnRequest)
    if err != nil {
        fmt.Println("Failed to delete DefinedColumn with error:", err) // DefinedColumn の削除に失敗しました:
    } else {
        fmt.Println("Delete DefinedColumn finished.") // DefinedColumn の削除が完了しました。
    }
}