Query global table information using Tablestore Java SDK - Tablestore: Central de Documentação do Alibaba Cloud

Pré-requisito

Método

public DescribeGlobalTableResponse describeGlobalTable(DescribeGlobalTableRequest request) throws TableStoreException, ClientException

Parâmetros de DescribeGlobalTableRequest

globalTableId (Obrigatório) String: ID da tabela global.

Nota
Se você não tiver o ID da tabela global, chame a operação DescribeTable para consultar os detalhes de uma réplica de tabela. Caso a réplica faça parte de uma tabela global, a resposta conterá o ID correspondente.
globalTableName (Obrigatório) String: Nome da tabela global. Deve ser idêntico ao nome da tabela base.
returnRpo (Opcional) boolean: Define se o Recovery Point Objective (RPO) deve ser retornado. O valor padrão é false. Como a obtenção do RPO consome tempo, ative este parâmetro apenas quando necessário.

phyTable (Opcional) GlobalTableTypes.PhyTable: Condições para filtrar tabelas físicas. Este parâmetro contém os seguintes membros:

Parâmetro	Tipo	Descrição
regionId (Opcional)	String	ID da região onde a tabela física está localizada.
instanceName (Opcional)	String	Nome da instância onde a tabela física está localizada.

Valores de retorno de DescribeGlobalTableResponse

globalTableId (Obrigatório) String: ID da tabela global.

status (Obrigatório) GlobalTableTypes.GlobalTableStatus: Status da tabela global. Valores válidos:

Status	Descrição
INIT	Inicializando. A tabela global entra neste estado após a criação.
RE_CONF	Reconfigurando. Todas ou algumas réplicas da tabela global estão em configuração. Isso pode ocorrer devido à criação da tabela, sincronização de dados históricos ou associação/desassociação de membros da tabela global.
ACTIVE	Ativa.

phyTables (Obrigatório) List<PhyTable>: Lista de tabelas físicas. Cada objeto na lista contém os seguintes membros:

Parâmetro	Tipo	Descrição
regionId (Obrigatório)	String	ID da região onde a tabela física está localizada.
instanceName (Obrigatório)	String	Nome da instância onde a tabela física está localizada.
tableName (Obrigatório)	String	Nome da tabela física.
status (Obrigatório)	PhyTableStatus	Status da tabela física. Valores válidos: PENDING: Na fila. O sistema aguarda a configuração de outras tabelas de réplica. INIT: Inicializando. A tabela de réplica está sendo criada ou configurada. SYNCDATA: Sincronizando. Dados históricos estão sendo sincronizados e a sincronização incremental de dados está ativada. READY: Pronta. A sincronização de dados históricos foi concluída e o túnel incremental está ativado. A tabela não permite gravação. ACTIVE: Ativa e sincronizando. A tabela de réplica permite leitura e gravação. UNBINDING: Desassociando. A tabela de réplica está sendo desassociada da tabela global. Nem a réplica nem seus dados são excluídos durante esse processo. UNBOUND: Desassociada. A tabela de réplica foi desassociada da tabela global. Nem a réplica nem seus dados foram excluídos durante esse processo.
statusTimestamp (Opcional)	long	Timestamp da última atualização de status. Unidade: milissegundos.
writable (Obrigatório)	boolean	Indica se a tabela permite gravação.
role (Opcional)	String	Função da tabela física no modelo de serviço.
rpo (Opcional)	Instant	RPO dos dados na tabela física.
tableId (Opcional)	String	ID da tabela física.
stage (Opcional)	SyncStage	Etapa de sincronização de dados.
isFailed (Obrigatório)	boolean	Indica se a tabela está em estado de falha.
message (Opcional)	String	Informações adicionais sobre o status da tabela física, como a causa de uma falha. Se a criação de uma tabela global ou a associação/desassociação de um relacionamento de sincronização falhar, `isFailed` será true e este parâmetro exibirá o motivo.

Exemplo

private static void describeGlobalTableExample(SyncClient client) {
    // Construct the request.
    DescribeGlobalTableRequest req = new DescribeGlobalTableRequest(
        // The global table ID.
        "gt-ee1b54db-f5d9-43f3-ad36-ec44********",
        // The name of the global table.
        "t-gt-test-1"
    );

    // Send the request.
    DescribeGlobalTableResponse descResp = client.describeGlobalTable(req);

    // Print the basic information of the global table.
    System.out.println("Status: " + descResp.getStatus());
    System.out.println("Global Table ID: " + descResp.getGlobalTableId());

    // Print the replica deployment information (Placement).
    List<GlobalTableTypes.PhyTable> placements = descResp.getPhyTables();
    for (GlobalTableTypes.PhyTable p : placements) {
        System.out.println("Replica in " + p.getRegionId() +
                ", Instance: " + p.getInstanceName() +
                ", Writable: " + p.isWritable());
    }
}