Manage tunnels - Tablestore CLI - Tablestore - Centre de documentation Alibaba Cloud

Prérequis

Tablestore CLI est installé et les identifiants d'accès sont configurés. Pour plus d'informations, consultez Tablestore CLI.
Une table de données avec la fonctionnalité Stream (journal des modifications de données) activée. Pour plus d'informations, consultez Opérations sur les tables de données.

Créer un tunnel

Exécutez la commande suivante pour créer un tunnel pour une table de données.

create_tunnel -n <tunnelName>

Paramètre	Obligatoire	Description
-t, --table	Non	Nom de la table de données. Ce paramètre n'est pas requis si vous avez déjà sélectionné une table de données à l'aide de la commande `use`.
-n, --name	Oui	Nom du tunnel.
-m, --mode	Non	Type de tunnel. Valeurs possibles : base_data_only : Mode données complètes. Consomme uniquement les données existantes dans la table. stream_data_only (par défaut) : Mode données incrémentielles. Consomme uniquement les données incrémentielles. base_and_stream : Mode complet plus incrémentiel. Consomme d'abord toutes les données existantes, puis continue avec les données incrémentielles.

Exemple

Créez un tunnel nommé t1 pour une table de données.

create_tunnel -n t1

Exemple de sortie :

New tunnel created, its id is '9933470d-8a5e-4972-a5b0-b7ae6f836460'.

Lister les tunnels

Exécutez la commande suivante pour lister tous les tunnels d'une table de données.

list_tunnel

Paramètre

Obligatoire

Description

-t, --table

Non

Nom de la table de données. Ce paramètre n'est pas requis si vous avez déjà sélectionné une table de données à l'aide de la commande use.

Exemple

list_tunnel

Afficher les détails d'un tunnel

Exécutez la commande suivante pour afficher les détails du tunnel et des canaux.

describe_tunnel -n <tunnelName>

Paramètre

Obligatoire

Description

-t, --table

Non

Nom de la table de données. Ce paramètre n'est pas requis si vous avez déjà sélectionné une table de données à l'aide de la commande use.

-n, --name

Oui

Nom du tunnel.

-o, --output

Non

Enregistre la sortie dans un fichier local.

Exemple

Affichez les détails du tunnel t1.

describe_tunnel -n t1

Exemple de sortie :

Tunnel Info:
+--------------------------------------+------------+------------+---------------+---------+
| TunnelId                             | TunnelName | TunnelType | Stage         | Expired |
+--------------------------------------+------------+------------+---------------+---------+
| 9933470d-8a5e-4972-a5b0-b7ae6f836460 | t1         | Stream     | ProcessStream | false   |
+--------------------------------------+------------+------------+---------------+---------+

Channel Info:
+-------------------------------------------------------+-------------+---------------+----------+-------------------------------+
| ChannelId                                             | ChannelType | ChannelStatus | ClientId | ChannelRPO                    |
+-------------------------------------------------------+-------------+---------------+----------+-------------------------------+
| cfd2c05b-54b6-48ec-aa6f-feb427f0ca57_1635771329155688 | Stream      | OPEN          |          | 1970-01-01 08:00:00 +0800 CST |
+-------------------------------------------------------+-------------+---------------+----------+-------------------------------+

Simuler la consommation d'un tunnel

Exécutez une consommation simulée pour prévisualiser le format des données dans un tunnel.

consume_tunnel -n <tunnelName> -m mock_consume

Paramètre	Obligatoire	Description
-c, --channel	Non	ID du canal. Si ce paramètre n'est pas spécifié, tous les canaux sont consommés.
-t, --table	Non	Nom de la table de données. Ce paramètre n'est pas requis si vous avez déjà sélectionné une table de données à l'aide de la commande `use`.
-n, --name	Oui	Nom du tunnel.
-m, --mode	Oui	Mode de consommation. Valeurs possibles : shadow_copy (par défaut) : Met en miroir le trafic de consommation du tunnel en ligne. mock_consume : Simule la consommation de données sans mettre à jour les enregistrements de point de contrôle. real_consume : Consomme les données et met à jour les enregistrements de point de contrôle. Cette option n'est pas recommandée car elle affecte l'état du point de contrôle du tunnel de production.

Exemple

Simulez la consommation de données sur le tunnel t1.

consume_tunnel -n t1 -m mock_consume

Après avoir exécuté la commande, l'interface CLI attend les données entrantes. Lorsque des données sont écrites dans la table, les enregistrements de consommation apparaissent dans la sortie. Exemple de sortie :

{"Type":0,"Timestamp":1636360028961786,"SequenceInfo":{"Epoch":0,"Timestamp":1636360028961786,"RowIndex":1},"PrimaryKey":{"PrimaryKeys":[{"ColumnName":"uid","Value":"86"},{"ColumnName":"pid","Value":6771}]},"Columns":[{"Type":0,"Name":"name","Value":"redchen","Timestamp":1636360028962},{"Type":0,"Name":"country","Value":"china","Timestamp":1636360028962}]}

Supprimer un tunnel

Exécutez la commande suivante pour supprimer un tunnel d'une table de données.

drop_tunnel -n <tunnelName> -y

Paramètre

Obligatoire

Description

-t, --table

Non

Nom de la table de données. Ce paramètre n'est pas requis si vous avez déjà sélectionné une table de données à l'aide de la commande use.

-n, --name

Oui

Nom du tunnel.

-y, --yes

Oui

Ignores l'invite de confirmation interactive et procède à la suppression.

Exemple

Supprimez le tunnel t1.

drop_tunnel -n t1 -y