Gerencie túneis - Tablestore CLI - Tablestore: Central de Documentação do Alibaba Cloud

Pré-requisitos

Tablestore CLI instalada e credenciais de acesso configuradas. Para mais informações, consulte Tablestore CLI.
Tabela de dados com o Stream (recurso de log de alterações de dados) ativado. Para mais informações, consulte Operações de tabela de dados.

Crie um túnel

Execute o comando a seguir para criar um túnel em uma tabela de dados.

create_tunnel -n <tunnelName>

Parâmetro	Obrigatório	Descrição
-t, --table	Não	Nome da tabela de dados. Dispensável se você já tiver selecionado uma tabela de dados com o comando `use`.
-n, --name	Sim	Nome do túnel.
-m, --mode	Não	Tipo do túnel. Valores válidos: base_data_only: modo de dados completos. Consome apenas os dados existentes na tabela. stream_data_only (padrão): modo de dados incrementais. Consome apenas dados incrementais. base_and_stream: modo completo com incrementais. Consome primeiro todos os dados existentes e depois continua com os dados incrementais.

Exemplo

Crie um túnel chamado t1 para uma tabela de dados.

create_tunnel -n t1

Saída de exemplo:

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

Listar túneis

Execute o comando a seguir para listar todos os túneis de uma tabela de dados.

list_tunnel

Parâmetro	Obrigatório	Descrição
-t, --table	Não	Nome da tabela de dados. Dispensável se você já tiver selecionado uma tabela de dados com o comando `use`.

Exemplo

list_tunnel

Visualize detalhes do túnel

Execute o comando a seguir para visualizar os detalhes do túnel e dos canais.

describe_tunnel -n <tunnelName>

Parâmetro	Obrigatório	Descrição
-t, --table	Não	Nome da tabela de dados. Dispensável se você já tiver selecionado uma tabela de dados com o comando `use`.
-n, --name	Sim	Nome do túnel.
-o, --output	Não	Salva a saída em um arquivo local.

Exemplo

Visualize os detalhes do túnel t1.

describe_tunnel -n t1

Saída de exemplo:

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 consumo do túnel

Execute um consumo simulado para visualizar o formato dos dados em um túnel.

consume_tunnel -n <tunnelName> -m mock_consume

Parâmetro	Obrigatório	Descrição
-c, --channel	Não	ID do canal. Se não especificado, todos os canais serão consumidos.
-t, --table	Não	Nome da tabela de dados. Dispensável se você já tiver selecionado uma tabela de dados com o comando `use`.
-n, --name	Sim	Nome do túnel.
-m, --mode	Sim	Modo de consumo. Valores válidos: shadow_copy (padrão): espelha o tráfego de consumo do túnel online. mock_consume: simula o consumo de dados sem atualizar os registros de checkpoint. real_consume: consome dados e atualiza os registros de checkpoint. Não recomendado, pois afeta o estado de checkpoint do túnel de produção.

Exemplo

Simule o consumo de dados no túnel t1.

consume_tunnel -n t1 -m mock_consume

Após a execução do comando, a CLI aguarda a chegada de dados. Quando dados são gravados na tabela, os registros de consumo aparecem na saída. Saída de exemplo:

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

Exclua um túnel

Execute o comando a seguir para excluir um túnel de uma tabela de dados.

drop_tunnel -n <tunnelName> -y

Parâmetro	Obrigatório	Descrição
-t, --table	Não	Nome da tabela de dados. Dispensável se você já tiver selecionado uma tabela de dados com o comando `use`.
-n, --name	Sim	Nome do túnel.
-y, --yes	Sim	Ignora o prompt de confirmação interativo e prossegue com a exclusão.

Exemplo

Exclua o túnel t1.

drop_tunnel -n t1 -y