Go SDK 可向已有全局表添加一个或多个跨地域副本。
前提条件
安装Tablestore Go SDK并初始化客户端。全局表功能需要 1.9.0 及以上版本,建议使用最新版本。
目标地域中已创建 Tablestore 实例。
功能说明
调用 BindGlobalTable 方法向已有全局表添加副本。服务会在目标实例中自动创建与基础表同名的副本表,因此目标实例中不能已有同名数据表。
func (client *TableStoreClient) BindGlobalTable(request *BindGlobalTableRequest) (*BindGlobalTableResponse, error)
说明
BindGlobalTable 是异步接口。请求成功仅表示添加副本任务已发起。调用 DescribeGlobalTable 查询状态,当全局表和新增副本的状态均为 active 时,副本添加完成。
以下示例向全局表添加一个只读副本。
request := &tablestore.BindGlobalTableRequest{
GlobalTableId: "gt-01234567-89ab-cdef-0123-456789abcdef",
GlobalTableName: "example_table",
Placements: []*tablestore.Placement{
{
RegionId: "cn-beijing",
InstanceName: "replica-instance",
Writable: false,
},
},
}
response, err := client.BindGlobalTable(request)
if err != nil {
log.Fatalf("BindGlobalTable failed: %v", err)
}
fmt.Println("RequestId:", response.RequestId)
参数说明
BindGlobalTableRequest 包含以下参数。
|
名称 |
类型 |
说明 |
|
GlobalTableId(必选) |
string |
全局表 ID。创建全局表时由 |
|
GlobalTableName(必选) |
string |
全局表名称,必须与基础表名称相同。 |
|
Placements(必选) |
[]*Placement |
要添加的副本位置列表。 |
副本位置
Placements[] 中每个元素的类型为 *Placement,包含以下参数。
|
名称 |
类型 |
说明 |
|
RegionId(必选) |
string |
副本所在地域的 ID,例如 |
|
InstanceName(必选) |
string |
副本所属实例的名称。 |
|
Writable(必选) |
bool |
副本是否接受写操作。主备模式下设置为 |
该文章对您有帮助吗?