Todos os produtos
Search

Este produto

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

    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. A resposta inclui nome, tipo, ID e estágio do túnel, além de indicar se os dados estão expirados.

    Pré-requisitos

    • Uma instância TunnelClient inicializada.

    • Um túnel criado para a tabela de dados. Para mais detalhes, consulte Criar um túnel.

    Parâmetros

    Parâmetros da solicitação

    Parâmetro

    Descrição

    TableName

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

    Parâmetros da resposta

    Parâmetro

    Descrição

    List<TunnelInfo>

    Informações sobre os túneis. A resposta contém os seguintes dados:

    • TunnelId: o ID do túnel.

    • TunnelType: o tipo do túnel. Valores válidos: BaseData, Stream e BaseAndStream. O tipo BaseData indica consumo de dados completos da tabela. O tipo Stream refere-se ao consumo de dados incrementais. Já o tipo BaseAndStream sinaliza o 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 significa que o túnel está em inicialização. ProcessBaseData indica consumo de dados completos em andamento. ProcessStream aponta para o consumo ativo de dados incrementais.

    • Expired: indica se os dados estão expirados.

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

    ResponseInfo

    Outros campos retornados na solicitação, incluindo o campo RequestId. O RequestId identifica a solicitação de forma única.

    Exemplos

    O código abaixo demonstra 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