Todos os produtos
Search

Este produto

    Tablestore:Consultar informações sobre um túnel

    Central de documentação

    Tablestore:Consultar informações sobre um túnel

    Última atualização: Oct 09, 2026

    Após criar um túnel, chame a operação DescribeTunnel para consultar as informações dele, como os detalhes dos canais do túnel.

    Pré-requisitos

    • Uma instância do TunnelClient inicializada.

    • Crie um túnel 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 para a qual você deseja consultar as informações do túnel.

    TunnelName

    Nome do túnel.

    Parâmetros de resposta

    Parâmetro

    Descrição

    TunnelRPO

    O horário mais recente em que o túnel consumiu dados incrementais. Esse horário corresponde ao momento em que o canal mais lento do túnel consumiu dados. Valor padrão: 1 de janeiro de 1970 (UTC).

    List<TunnelInfo>

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

    • TunnelId: ID do túnel.

    • TunnelName: nome 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 de dados. O tipo Stream indica que o túnel consome dados incrementais da tabela. O tipo BaseAndStream indica que o túnel consome dados diferenciais da tabela.

    • TableName: nome da tabela de dados para a qual você criou o túnel.

    • 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á em inicialização. O estágio ProcessBaseData indica que o túnel consome dados completos. O estágio ProcessStream indica que o túnel consome dados incrementais.

    • Expired: indica se os dados expiraram.

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

    List<ChannelInfo>

    Informações sobre os canais do túnel. A resposta inclui os seguintes dados:

    • ChannelId: ID do canal.

    • ChannelType: tipo do canal. Valores válidos: Base e Stream.

    • ChannelStatus: status do canal. Valores válidos: WAIT, OPEN, CLOSING, CLOSE e TERMINATED.

    • ClientId: ID do cliente do túnel. Por padrão, o ID do cliente concatena o hostname do cliente e uma string aleatória. Você pode especificar o hostname do cliente por meio do TunnelWorkerConfig.

    • ChannelRPO: horário mais recente em que o canal consumiu dados incrementais. Valor padrão: 1 de janeiro de 1970 (UTC). Este parâmetro não tem efeito para canais do tipo Base.

    ResponseInfo

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

    Exemplos

    O código de exemplo a seguir mostra como consultar as informações de um túnel, incluindo o horário mais recente em que o túnel consumiu dados incrementais e os detalhes dos canais do túnel:

    req := &tunnel.DescribeTunnelRequest{
   TableName:  "<TABLE_NAME>",
   TunnelName: "TUNNEL_NAME",
}
resp, err := tunnelClient.DescribeTunnel(req)
if err != nil {
   log.Fatal("describe tunnel failed", err)
}
log.Println("tunnel id is", resp.Tunnel.TunnelId)

    Referências