Tous les produits
Search

Ce produit

    Tablestore:Interroger les informations relatives à un tunnel

    Centre de documentation

    Tablestore:Interroger les informations relatives à un tunnel

    Dernière mise à jour :Aug 18, 2026

    Utilisez le SDK Tablestore pour Go afin d'interroger la configuration, l'étape, les états des canaux et la progression de la consommation incrémentielle d'un tunnel.

    Prérequis

    • Une instance TunnelClient est initialisée.

    • Un tunnel a été créé pour la table de données. Pour plus d'informations, consultez la rubrique Créer un tunnel.

    Paramètres

    Paramètres de requête

    Paramètre

    Description

    TableName

    Nom de la table de données dont vous souhaitez interroger les informations du tunnel.

    TunnelName

    Nom du tunnel.

    Paramètres de réponse

    Paramètre

    Description

    TunnelRPO

    Horodatage le plus récent indiquant quand le tunnel a été utilisé pour consommer des données incrémentielles. Il correspond au moment où le canal le plus lent du tunnel a consommé les données. Valeur par défaut : 1er janvier 1970 (UTC).

    List<TunnelInfo>

    Informations relatives au tunnel. La réponse inclut les éléments suivants :

    • TunnelId : ID du tunnel.

    • TunnelName : nom du tunnel.

    • TunnelType : type du tunnel. Les valeurs valides sont BaseData, Stream et BaseAndStream. Le type BaseData indique que le tunnel sert à consommer l'intégralité des données de la table. Le type Stream signifie que le tunnel est utilisé pour la consommation de données incrémentielles. Le type BaseAndStream signale que le tunnel permet de consommer les données différentielles de la table.

    • TableName : nom de la table de données associée au tunnel.

    • InstanceName : nom de l'instance hébergeant le tunnel.

    • Stage : étape du tunnel. Les valeurs possibles sont InitBaseDataAndStreamShard, ProcessBaseData et ProcessStream. L'étape InitBaseDataAndStreamShard signifie que le tunnel est en cours d'initialisation. L'étape ProcessBaseData indique que le tunnel consomme l'intégralité des données. L'étape ProcessStream signale que le tunnel traite les données incrémentielles.

    • Expired : indique si les données ont expiré.

      Si la valeur true est renvoyée, contactez le support technique Tablestore via DingTalk dans les plus brefs délais.

    List<ChannelInfo>

    Informations relatives aux canaux du tunnel. La réponse contient les détails suivants :

    • ChannelId : ID du canal.

    • ChannelType : type du canal. Les valeurs valides sont Base et Stream.

    • ChannelStatus : statut du canal. Les valeurs possibles sont WAIT, OPEN, CLOSING, CLOSE et TERMINATED.

    • ClientId : ID du client tunnel. Par défaut, cet identifiant concatène le nom d'hôte du client et une chaîne aléatoire. Vous pouvez spécifier le nom d'hôte du client à l'aide de TunnelWorkerConfig.

    • ChannelRPO : horodatage le plus récent indiquant quand le canal a été utilisé pour consommer des données incrémentielles. Valeur par défaut : 1er janvier 1970 (UTC). Ce paramètre n'a aucun effet sur les canaux de type Base.

    ResponseInfo

    Autres champs renvoyés dans la requête, y compris le champ RequestId. Ce dernier identifie la requête de manière unique.

    Exemples

    L'extrait de code suivant illustre comment interroger les informations d'un tunnel, notamment l'horodatage le plus récent de consommation des données incrémentielles ainsi que les détails des canaux associés :

    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)

    Références