添加全局表副本

更新时间:
复制 MD 格式

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。创建全局表时由 CreateGlobalTableResponse.GlobalTableId 返回。

GlobalTableName(必选)

string

全局表名称,必须与基础表名称相同。

Placements(必选)

[]*Placement

要添加的副本位置列表。

副本位置

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

名称

类型

说明

RegionId(必选)

string

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

InstanceName(必选)

string

副本所属实例的名称。

Writable(必选)

bool

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