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 |
副本位置列表。不设置时,仅将基础表纳入全局表;后续可调用 |
|
SyncMode(必选) |
SyncMode |
数据同步模式。当前仅支持 |
|
ServeMode(必选) |
ServeMode |
服务模式。取值为 |
基础表
BaseTable 的类型为 *BaseTable,包含以下参数。
|
名称 |
类型 |
说明 |
|
RegionId(必选) |
string |
基础表所在地域的 ID,例如 |
|
InstanceName(必选) |
string |
基础表所属实例的名称。 |
|
TableName(必选) |
string |
基础表名称,也是全局表名称。 |
副本位置
Placements[] 中每个元素的类型为 *Placement,包含以下参数。
|
名称 |
类型 |
说明 |
|
RegionId(必选) |
string |
副本所在地域的 ID,例如 |
|
InstanceName(必选) |
string |
副本所属实例的名称。 |
|
Writable(必选) |
bool |
副本是否接受写操作。主备模式下设置为 |
返回值
CreateGlobalTableResponse 包含以下与创建结果直接相关的字段。
|
字段 |
类型 |
说明 |
|
GlobalTableId |
string |
全局表 ID。查询、添加、更新或移除全局表副本时需要使用该 ID。 |