Tous les produits
Search

Ce produit

    Tablestore:Créer un tunnel

    Centre de documentation

    Tablestore:Créer un tunnel

    Dernière mise à jour :Aug 18, 2026

    Prérequis

    • Initialisez une instance TunnelClient.

    • Créez une table de données. Pour plus d'informations, consultez la rubrique Créer une table de données.

    Paramètres

    Paramètres de requête

    Paramètre

    Description

    TableName

    Nom de la table de données pour laquelle vous souhaitez créer un tunnel.

    TunnelName

    Nom du tunnel.

    Type

    Type de tunnel. Valeurs possibles : BaseData, Stream et BaseAndStream. Le type BaseData permet de consommer l'intégralité des données de la table. Le type Stream permet de consommer les données incrémentielles de la table. Le type BaseAndStream permet de consommer les données différentielles de la table.

    Si vous définissez ce paramètre sur Stream ou BaseAndStream, le système considère comme incrémentielles les données écrites dans la table après la création du tunnel. Pour consommer les données incrémentielles générées après un instant précis, configurez le paramètre startTime pour ces données.

    • Plage de valeurs valides pour le paramètre startTime : [Heure système actuelle - Période de validité du flux + 5 minutes, Heure système actuelle]. Unité : nanosecondes.

      Remarque

      La période de validité du flux correspond à la durée de conservation des journaux incrémentiels, exprimée en millisecondes. La durée maximale de conservation des journaux incrémentiels est de sept jours. Spécifiez cette période lors de l'activation du flux pour la table de données. Une fois définie, cette période ne peut plus être modifiée.

    • Vous pouvez également configurer le paramètre endTime pour les données incrémentielles à consommer. La valeur du paramètre endTime doit être supérieure à celle du paramètre startTime.

    Paramètres de réponse

    Paramètre

    Description

    TunnelId

    ID du tunnel.

    ResponseInfo

    Autres champs renvoyés dans la réponse, notamment le champ RequestId de la requête. L'identifiant RequestId permet d'identifier la requête de manière unique.

    Exemples

    L'exemple de code suivant montre comment créer un tunnel de type BaseAndStream :

    req := &tunnel.CreateTunnelRequest{
   TableName:  "<TABLE_NAME>",
   TunnelName: "<TUNNEL_NAME>",
   Type:       tunnel.TunnelTypeBaseStream, // Create a tunnel of the BaseAndStream type. 
}
resp, err := tunnelClient.CreateTunnel(req)
if err != nil {
   log.Fatal("create tunnel failed ", err)
}
log.Println("tunnel id is", resp.TunnelId)

    FAQ

    Que faire si le message d'erreur « OTSTrimmedDataAccess Requested stream data is already trimmed or does not exist » s'affiche lors de la consommation de données avec Tunnel Service ?

    Références