Servicio de túnel - Tablestore - Centro de documentación de Alibaba Cloud

Puede usar el CLI de Tablestore para crear y gestionar túneles que consumen datos incrementales, completos o una combinación de ambos desde las tablas de datos.

Requisitos previos

Instale el CLI de Tablestore y configure las credenciales de acceso. Para más información, consulte Tablestore CLI.
Cuenta con una tabla de datos que tenga habilitada la función Stream (el registro de cambios de datos). Para más información, consulte Data table operations.

Crear un túnel

Ejecute el siguiente comando para crear un túnel en una tabla de datos.

create_tunnel -n <tunnelName>

Parámetro	Obligatorio	Descripción
-t, --table	No	Nombre de la tabla de datos. No es necesario si ya seleccionó una tabla mediante el comando `use`.
-n, --name	Sí	Nombre del túnel.
-m, --mode	No	Tipo de túnel. Valores válidos: base_data_only: modo de datos completos. Consume únicamente los datos existentes en la tabla. stream_data_only (predeterminado): modo de datos incrementales. Consume solo los datos nuevos. base_and_stream: modo combinado. Primero consume todos los datos existentes y después continúa con los incrementales.

Ejemplo

Cree un túnel llamado t1 para una tabla de datos.

create_tunnel -n t1

Salida de ejemplo:

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

Listar túneles

Ejecute el siguiente comando para listar todos los túneles de una tabla de datos.

list_tunnel

Parámetro	Obligatorio	Descripción
-t, --table	No	Nombre de la tabla de datos. No es necesario si ya seleccionó una tabla mediante el comando `use`.

Ejemplo

list_tunnel

Consultar los detalles de un túnel

Ejecute el siguiente comando para consultar los detalles del túnel y de sus canales.

describe_tunnel -n <tunnelName>

Parámetro	Obligatorio	Descripción
-t, --table	No	Nombre de la tabla de datos. No es necesario si ya seleccionó una tabla mediante el comando `use`.
-n, --name	Sí	Nombre del túnel.
-o, --output	No	Guarda la salida en un archivo local.

Ejemplo

Consulte los detalles del túnel t1.

describe_tunnel -n t1

Salida de ejemplo:

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 |
+-------------------------------------------------------+-------------+---------------+----------+-------------------------------+

Simular el consumo de un túnel

Ejecute un consumo simulado para previsualizar el formato de los datos dentro de un túnel.

consume_tunnel -n <tunnelName> -m mock_consume

Parámetro	Obligatorio	Descripción
-c, --channel	No	Identificador del canal. Si no se especifica, se consumen todos los canales.
-t, --table	No	Nombre de la tabla de datos. No es necesario si ya seleccionó una tabla mediante el comando `use`.
-n, --name	Sí	Nombre del túnel.
-m, --mode	Sí	Modo de consumo. Valores válidos: shadow_copy (predeterminado): replica el tráfico de consumo del túnel en producción. mock_consume: simula el consumo de datos sin actualizar los registros de punto de control. real_consume: consume los datos y actualiza los registros de punto de control. No se recomienda porque altera el estado del punto de control del túnel en producción.

Ejemplo

Simule el consumo de datos en el túnel t1.

consume_tunnel -n t1 -m mock_consume

Al ejecutar el comando, el CLI queda a la espera de datos entrantes. Cuando se escriben datos en la tabla, los registros de consumo aparecen en la salida. Salida de ejemplo:

{"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}]}

Eliminar un túnel

Ejecute el siguiente comando para eliminar un túnel de una tabla de datos.

drop_tunnel -n <tunnelName> -y

Parámetro	Obligatorio	Descripción
-t, --table	No	Nombre de la tabla de datos. No es necesario si ya seleccionó una tabla mediante el comando `use`.
-n, --name	Sí	Nombre del túnel.
-y, --yes	Sí	Omite la solicitud de confirmación interactiva y continúa con la eliminación.

Ejemplo

Elimine el túnel t1.

drop_tunnel -n t1 -y