创建全局表

更新时间:
复制 MD 格式

Go SDK 可创建主备或多活模式的全局表,在多个地域的数据表之间同步数据。

前提条件

  • 安装Tablestore Go SDK并初始化客户端。全局表功能需要 1.9.0 及以上版本,建议使用最新版本。

  • 源地域和目标地域均已创建 Tablestore 实例。

  • 源地域中已创建基础表,且数据生命周期(TTL)为 -1、最大版本数为 1、最大版本偏差为 math.MaxInt32、UpdateFullRow 为 true。

功能说明

调用 CreateGlobalTable 方法,以已有数据表为基础创建跨地域全局表。全局表支持主备模式和多活模式。创建时,服务会在目标实例中自动创建与基础表同名的副本表,因此目标实例中不能已有同名数据表。

func (client *TableStoreClient) CreateGlobalTable(request *CreateGlobalTableRequest) (*CreateGlobalTableResponse, error)
说明

CreateGlobalTable 是异步接口。请求成功仅表示创建任务已发起。调用 DescribeGlobalTable 查询状态,当 Status 为 GlobalTableStatus_Active 时,全局表创建完成。

重要

开启整行更新(UpdateFullRow 为 true)后存在以下限制:

  • 单行数据最多支持 256 列。

  • 写入数据时不能手动指定版本号,版本号由服务自动生成。

  • 执行 UpdateRow 操作时,服务会先读取当前行,因此会增加读负载。

多活模式发生写入冲突时,服务按照最后写入者获胜(LWW)原则,以行或列为粒度处理冲突。

以下示例分别创建主备模式和多活模式的全局表。

主备模式

以下示例创建主备模式的全局表。基础表可读写,副本表只读。

request := &tablestore.CreateGlobalTableRequest{
    BaseTable: &tablestore.BaseTable{
        RegionId:     "cn-hangzhou",
        InstanceName: "source-instance",
        TableName:    "example_table",
    },
    Placements: []*tablestore.Placement{
        {
            RegionId:     "cn-beijing",
            InstanceName: "replica-instance",
            Writable:     false,
        },
    },
    SyncMode:  tablestore.SyncMode_Row,
    ServeMode: tablestore.ServeMode_PrimarySecondary,
}

response, err := client.CreateGlobalTable(request)
if err != nil {
    log.Fatalf("CreateGlobalTable failed: %v", err)
}
fmt.Println("GlobalTableId:", response.GlobalTableId)

多活模式

以下示例创建多活模式的全局表。将目标副本设置为可写,并将 ServeMode 设置为 ServeMode_PeerToPeer,使基础表和副本表均可接受写入。

request := &tablestore.CreateGlobalTableRequest{
    BaseTable: &tablestore.BaseTable{
        RegionId:     "cn-hangzhou",
        InstanceName: "source-instance",
        TableName:    "example_table",
    },
    Placements: []*tablestore.Placement{
        {
            RegionId:     "cn-beijing",
            InstanceName: "replica-instance",
            Writable:     true,
        },
    },
    SyncMode:  tablestore.SyncMode_Row,
    ServeMode: tablestore.ServeMode_PeerToPeer,
}

response, err := client.CreateGlobalTable(request)
if err != nil {
    log.Fatalf("CreateGlobalTable failed: %v", err)
}
fmt.Println("GlobalTableId:", response.GlobalTableId)

参数说明

CreateGlobalTableRequest 包含以下参数。

名称

类型

说明

BaseTable(必选)

*BaseTable

基础表信息。基础表是创建全局表时已存在的数据表。

Placements(可选)

[]*Placement

副本位置列表。不设置时,仅将基础表纳入全局表;后续可调用 BindGlobalTable 添加副本。

SyncMode(必选)

SyncMode

数据同步模式。当前仅支持 SyncMode_Row,表示按行同步。

ServeMode(必选)

ServeMode

服务模式。取值为 ServeMode_PrimarySecondary(主备模式)或 ServeMode_PeerToPeer(多活模式)。Go SDK 不提供默认值,必须显式设置。

基础表

BaseTable 的类型为 *BaseTable,包含以下参数。

名称

类型

说明

RegionId(必选)

string

基础表所在地域的 ID,例如 cn-hangzhou。

InstanceName(必选)

string

基础表所属实例的名称。

TableName(必选)

string

基础表名称,也是全局表名称。

副本位置

Placements[] 中每个元素的类型为 *Placement,包含以下参数。

名称

类型

说明

RegionId(必选)

string

副本所在地域的 ID,例如 cn-beijing。

InstanceName(必选)

string

副本所属实例的名称。

Writable(必选)

bool

副本是否接受写操作。主备模式下设置为 false;多活模式下根据该副本是否需要接受写入设置。

返回值

CreateGlobalTableResponse 包含以下与创建结果直接相关的字段。

字段

类型

说明

GlobalTableId

string

全局表 ID。查询、添加、更新或移除全局表副本时需要使用该 ID。