表格存储 Java SDK解绑全局表 - 表格存储

注意事项

解绑操作仅移除副本表与全局表的关联，副本表及其数据均会保留。如需删除副本表，请单独调用 DeleteTable 接口。
解绑请求为异步发起，完成解绑需要一段时间。可通过查询全局表信息查询全局表状态，当状态返回为 active 时，表示解绑成功。

前提条件

方法说明

public UnbindGlobalTableResponse unbindGlobalTable(UnbindGlobalTableRequest request) throws TableStoreException, ClientException

UnbindGlobalTableRequest 参数说明

globalTableId（必选）String：全局表 ID。

说明
如需获取全局表 ID，可调用 DescribeTable 接口查询副本表的详细信息。若该副本表属于某个全局表，返回结果中会包含对应的全局表 ID。
globalTableName（必选）String：全局表名称，须与基础表名称保持一致。

Removals（必选）List<Removal>：待移除的分布位置列表。每个 Removal 对象包含以下参数：

名称	类型	说明
regionId（必选）	String	地域 ID。
instanceName（必选）	String	实例名称。

示例

private static void unbindGlobalTableExample(SyncClient client) {
    // 构造请求
    UnbindGlobalTableRequest request = new UnbindGlobalTableRequest(
                // 全局表 ID
                "gt-ee1b54db-f5d9-43f3-ad36-ec44********",
                // 全局表名称
                "my-global-table"
    );
                
    // 构建待移除的副本列表（Removals）
    List<GlobalTableTypes.Removal> removals = new ArrayList<>();

    // 移除华东1（杭州）地域的副本
    GlobalTableTypes.Removal hangzhouRemoval = new GlobalTableTypes.Removal(
                // 副本所在地域 ID
                "cn-hangzhou",
                // 副本所属实例名称
                "instance-replica-hz"
    );

    // 移除华东2（上海）地域的副本
    GlobalTableTypes.Removal shanghaiRemoval = new GlobalTableTypes.Removal(
                // 副本所在地域 ID
                "cn-shanghai",
                // 副本所属实例名称
                "instance-replica-sh"
    );
    
    removals.add(hangzhouRemoval);
    removals.add(shanghaiRemoval);
    request.setRemovals(removals);

    // 发起请求
    UnbindGlobalTableResponse response = client.unbindGlobalTable(request);
    System.out.println("Unbind start. Request ID: " + response.getRequestId());
}