Todos os produtos
Search
Central de documentação

Tablestore:Consultar informações de todos os túneis de uma tabela de dados

Última atualização: Jul 03, 2026

Após criar um túnel, chame a operação ListTunnel para consultar informações sobre todos os túneis de uma tabela, incluindo nome, tipo, ID e estágio do túnel, além do status de expiração dos dados.

Pré-requisitos

  • Uma instância TunnelClient inicializada.

  • Um túnel criado para a tabela de dados. Para mais informações, consulte Crie um túnel.

Parâmetros

Parâmetros de solicitação

Parâmetro

Descrição

TableName

Nome da tabela de dados cujas informações de túnel você deseja consultar.

Parâmetros de resposta

Parâmetro

Descrição

List<TunnelInfo>

Informações sobre os túneis. A resposta inclui os seguintes dados:

  • TunnelId: ID do túnel.

  • TunnelType: tipo do túnel. Valores válidos: BaseData, Stream e BaseAndStream. O tipo BaseData indica que o túnel consome dados completos da tabela. O tipo Stream sinaliza o consumo de dados incrementais. O tipo BaseAndStream refere-se ao consumo de dados diferenciais da tabela.

  • TableName: nome da tabela de dados associada ao túnel.

  • InstanceName: nome da instância onde o túnel está localizado.

  • Stage: estágio atual do túnel. Valores válidos: InitBaseDataAndStreamShard, ProcessBaseData e ProcessStream. O estágio InitBaseDataAndStreamShard indica que o túnel está em inicialização. O estágio ProcessBaseData significa que o túnel consome dados completos. O estágio ProcessStream mostra que o túnel processa dados incrementais.

  • Expired: indica se os dados expiraram.

    Se retornar true, entre em contato com o suporte técnico do Tablestore via DingTalk o mais rápido possível.

RequestId

ID da solicitação.

Exemplos

O código abaixo demonstra como consultar as informações de todos os túneis de uma tabela:

private static void listTunnel(TunnelClient client, String tableName) {
    ListTunnelRequest request = new ListTunnelRequest(tableName);
    ListTunnelResponse resp = client.listTunnel(request);
    System.out.println("RequestId: " + resp.getRequestId());
    for (TunnelInfo info : resp.getTunnelInfos()) {
        System.out.println("TunnelInfo::::::");
        System.out.println("\tTunnelName: " + info.getTunnelName());
        System.out.println("\tTunnelId: " + info.getTunnelId());
        // The type of the tunnel. Valid values: BaseData, Stream, and BaseAndStream. 
        System.out.println("\tTunnelType: " + info.getTunnelType());
        System.out.println("\tTableName: " + info.getTableName());
        System.out.println("\tInstanceName: " + info.getInstanceName());
        // The stage of the tunnel. Valid values: InitBaseDataAndStreamShard, ProcessBaseData, and ProcessStream. 
        System.out.println("\tStage: " + info.getStage());
        // Indicate whether the data is expired. If true is returned, contact Tablestore technical support by using DingTalk at the earliest opportunity. 
        System.out.println("\tExpired: " + info.isExpired());
    }
}

Referências

  • Para obter informações sobre a operação de API usada para consultar todos os túneis de uma tabela de dados, consulte ListTunnel.

  • Para começar a usar rapidamente o Tunnel Service no consumo de dados, consulte Guia de introdução.

  • Consulte informações específicas de um único túnel. Para mais detalhes, veja Consultar informações de um túnel.

  • Exclua túneis desnecessários. Para instruções, acesse Exclua um túnel.