Tablestore Java SDK Bind Global Table - Tablestore: Central de Documentação do Alibaba Cloud

Observações de uso

A operação de vinculação é assíncrona. Após a conclusão da chamada, o sistema sincroniza os dados com as novas réplicas em segundo plano. Chame DescribeGlobalTable para verificar o progresso. A réplica estará pronta quando o status retornar active.

Pré-requisitos

Antes de começar, verifique se você:

Inicializou o cliente

Método

public BindGlobalTableResponse bindGlobalTable(BindGlobalTableRequest request) throws TableStoreException, ClientException

Parâmetros de BindGlobalTableRequest

globalTableId String: ID da tabela global.

Nota
Para obter o ID da tabela global, chame DescribeTable e consulte os detalhes da réplica. Se a réplica pertencer a uma tabela global, a resposta incluirá o ID correspondente.
globalTableName String: Nome da tabela global. Deve corresponder ao nome da tabela base.

placements List<Placement>: Réplicas a adicionar. Cada entrada configura uma réplica:

Parâmetro	Tipo	Descrição
regionId	String	Região de implantação da réplica.
instanceName	String	Nome da instância da réplica.
writable	boolean	Indica se a réplica aceita gravações. Padrão: `false`. Defina como `true` para réplicas no modo multi-ativo; mantenha `false` para o modo ativo-passivo.

Exemplo

O exemplo a seguir adiciona duas réplicas a uma tabela global existente: uma na China (Hangzhou) no modo ativo-passivo e outra na China (Shanghai) no modo multi-ativo.

private static void bindGlobalTableExample(SyncClient client) {
    BindGlobalTableRequest request = new BindGlobalTableRequest(
            "gt-ee1b54db-f5d9-43f3-ad36-ec44********",
            "my-global-table"
    );

    List<GlobalTableTypes.Placement> placements = new ArrayList<>();

    // Active-passive mode: read-only replica, writable = false
    GlobalTableTypes.Placement hangzhouReplica = new GlobalTableTypes.Placement(
            "cn-hangzhou",
            "instance-replica-hz",
            false
    );

    // Multi-active mode: read/write replica, writable = true
    GlobalTableTypes.Placement shanghaiReplica = new GlobalTableTypes.Placement(
            "cn-shanghai",
            "instance-replica-sh",
            true
    );

    placements.add(hangzhouReplica);
    placements.add(shanghaiReplica);
    request.setPlacements(placements);

    BindGlobalTableResponse response = client.bindGlobalTable(request);
    System.out.println("Bind succeeded. Request ID: " + response.getRequestId());
}