Todos os produtos
Search
Central de documentação

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

Última atualização: Oct 09, 2026

Após criar um túnel, você pode chamar a operação ListTunnel para consultar as informações de todos os túneis de uma tabela, incluindo o nome, o tipo, o ID, o estágio e se os dados expiraram.

Pré-requisitos

  • Uma instância do TunnelClient deve ser inicializada.

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

Parâmetros

Parâmetros de requisição

Parâmetro

Descrição

TableName

Nome da tabela de dados cujas informações do túnel 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 indica o consumo de dados incrementais. O tipo BaseAndStream indica o consumo de dados diferenciais da tabela.

  • TableName: nome da tabela de dados para a qual o túnel foi criado.

  • InstanceName: nome da instância que contém o túnel.

  • Stage: estágio do túnel. Valores válidos: InitBaseDataAndStreamShard, ProcessBaseData e ProcessStream. O estágio InitBaseDataAndStreamShard indica que o túnel está sendo inicializado. O estágio ProcessBaseData indica que o túnel está consumindo dados completos, e o estágio ProcessStream indica o consumo de dados incrementais.

  • Expired: indica se os dados expiraram.

    Se o valor retornado for true, entre em contato com o suporte técnico do Tablestore pelo DingTalk o mais rápido possível.

ResponseInfo

Outros campos retornados na requisição, incluindo o campo RequestId. O RequestId identifica exclusivamente a requisição.

Exemplos

O código de exemplo a seguir mostra como consultar as informações de todos os túneis de uma tabela:

req := &tunnel.ListTunnelRequest{
    TableName: "<TABLE_NAME>",
}
resp, err := tunnelClient.ListTunnel(req)
if err != nil {
    log.Fatal("List tunnel failed", err)
} else {
    for i := 0; i < len(resp.Tunnels); i++ {
        log.Println(resp.Tunnels[i].TableName, resp.Tunnels[i].TunnelName, resp.Tunnels[i].TunnelId)
    }
}

Referências

  • Para obter informações sobre a operação da API que você pode chamar para consultar as informações de todos os túneis de uma tabela de dados, consulte ListTunnel.

  • Se você quiser usar rapidamente o Tunnel Service para consumir dados, consulte Getting started.

  • Você pode consultar as informações de um túnel. Para mais informações, consulte Query information about a tunnel.

  • Você pode excluir um túnel que não seja mais necessário. Para mais informações, consulte Exclua um túnel.