Tablestore:Get started with Tunnel Service

Etapa 1: Criar um tunnel

1. Acesse a página Tunnels.

   1. Faça login no console do Tablestore.

   2. Na barra de navegação superior, selecione um grupo de recursos e uma região.

   3. Na página Overview, clique em nome da instância desejada ou em Manage Instance na coluna Actions da instância.

   4. Na aba Instance Details, clique em aba Tables. Clique em nome da tabela de dados de destino e, em seguida, na aba Tunnels. Como alternativa, clique em na coluna Actions da tabela de dados e selecione Tunnels.

2. Na aba Tunnels, clique em Create Tunnel.

3. Na caixa de diálogo Create Tunnel, configure os seguintes parâmetros:

   Parâmetro	Descrição
   Nome do tunnel	Nome do tunnel.
   Tipo de tunnel	Tipo do tunnel. Valores válidos: Full: consome todos os dados existentes na tabela de dados. Incremental: consome apenas novos dados gravados na tabela de dados. Differential: consome todos os dados existentes na tabela de dados e, em seguida, todos os novos dados.
   Hora de início	Ao criar um tunnel Incremental ou Full and Incremental, os dados gravados após a criação do tunnel são considerados incrementais por padrão. Para consumir dados incrementais a partir de um momento específico, configure a Start Time. Também é possível configurar uma End Time conforme necessário. Os valores de Start Time e End Time devem ser timestamps de 64 bits em milissegundos e estar dentro do intervalo [current system time - Stream expiration time + 5 minutes , current system time]. A End Time deve ser posterior à Start Time. Importante O tempo de expiração do Stream corresponde ao período de retenção do log de alterações, com duração máxima de 7 dias. Você define essa duração ao ativar o recurso Stream para uma tabela de dados. Não é possível alterar essa configuração posteriormente.
   Hora de término

4. Clique em OK.

   Após criar o tunnel, clique em Show Channels no lado direito do tunnel para visualizar o conteúdo dos dados, monitorar a latência de consumo e verificar o número de linhas consumidas em cada partição de canal.

   Após a criação, o status do tunnel passa a ser Processing Full Data. A lista de partições de canal contém uma partição Full com status Open e uma partição Incremental com status Waiting. Clique em Simulate Consumption na coluna Actions para visualizar os dados consumidos.

Etapa 2: (Opcional) Visualizar o formato dos dados do tunnel

Após criar o tunnel, simule o consumo de dados para visualizar o formato dos registros.

1. Write data para ou Delete data da tabela.

2. Na aba Tunnels da tabela, clique em Show Channels na coluna Actions do tunnel.

3. Na coluna Actions de uma partição de canal, clique em View Simulated Export Records.

4. Na caixa de diálogo View Simulated Export Records, clique em Start.

   A caixa de diálogo exibe os registros de dados consumidos.

   Exemplo de registro de dados consumidos

   O exemplo abaixo mostra um registro de dados consumidos:

   {
     "sequenceInfo": {
       "epoch": 0,
       "rowIndex": 0,
       "timestamp": 0
     },
     "recordType": "PUT",
     "columns": [
       {
         "actionType": "PUT",
         "name": "create_time",
         "type": "STRING",
         "value": "2024-02-18 22:10:07"
       },
       {
         "actionType": "PUT",
         "name": "modified_time",
         "type": "STRING",
         "value": "2024-02-18 22:10:07"
       },
       {
         "actionType": "PUT",
         "name": "num",
         "type": "INTEGER",
         "value": 29
       },
       {
         "actionType": "PUT",
         "name": "order_status",
         "type": "STRING",
         "value": "00"
       },
       {
         "actionType": "PUT",
         "name": "price",
         "type": "DOUBLE",
         "value": 400
       },
       {
         "actionType": "PUT",
         "name": "sku_id",
         "type": "STRING",
         "value": "9000000007"
       },
       {
         "actionType": "PUT",
         "name": "total_price",
         "type": "DOUBLE",
         "value": 11600
       },
       {
         "actionType": "PUT",
         "name": "user_id",
         "type": "STRING",
         "value": "1000000042"
       }
     ],
     "primaryKey": [
       {
         "name": "order_id",
         "type": "STRING",
         "value": "90fb478c-1360-11f0-a34d-00163e30a2a9"
       }
     ],
     "timestamp": 0
   }

Etapa 3: Iniciar o consumo de dados do tunnel

1. Na aba Tunnels, copie o ID do tunnel na lista.

2. Use o Tablestore SDK for Java ou o Tablestore SDK for Go para consumir dados rapidamente do tunnel.

   Após consumir os dados, visualize logs com estatísticas de consumo e o timestamp de sincronização mais recente de cada partição de canal incremental. No console do Tablestore, também é possível monitorar a latência de consumo e o número de linhas consumidas em cada partição de canal.