

Para recursos semelhantes aos do Amazon Timestream para, considere o Amazon Timestream LiveAnalytics para InfluxDB. Ele oferece ingestão de dados simplificada e tempos de resposta de consulta de um dígito em milissegundos para análises em tempo real. Saiba mais [aqui](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Visão geral da migração
<a name="timestream-for-influx-getting-started-migrating-data-overview"></a>

Depois de atender aos pré-requisitos:

1. Execute o script de migração: usando um aplicativo de terminal de sua escolha, execute o script Python para transferir dados da instância do InfluxDB de origem para a instância do InfluxDB de destino.

1. Forneça credenciais: forneça endereços e portas de host como opções de CLI.

1. Verifique os dados: verifique se os dados foram transferidos corretamente ao:

   1. Usar a UI do InfluxDB e inspecionar buckets.

   1. Listar buckets com `influx bucket list -t <destination token> --host <destination host address> --skip-verify`.

   1. Usar o `influx v1 shell -t <destination token> --host <destination host address> --skip-verify` e executar o `SELECT * FROM <migrated bucket>.<retention period>.<measurement name> LIMIT 100 to view contents of a bucket or SELECT COUNT(*) FROM <migrated bucket>.<retention period>.<measurment name>` para verificar se o número correto de registros foi migrado.

**Example Exemplo de execução**  

1. Abra um aplicativo de terminal de sua escolha e verifique se os pré-requisitos necessários estão instalados corretamente:  
![Pré-requisitos do script.](http://docs.aws.amazon.com/pt_br/timestream/latest/developerguide/images/script-pre-reqs.png)

1. Navegue até o script de migração:  
![Local do script](http://docs.aws.amazon.com/pt_br/timestream/latest/developerguide/images/script-navigate.png)

1. Prepare as seguintes informações:

   1. Nome do bucket de origem a ser migrado.

   1. (Opcional) Escolha um novo nome para o bucket migrado no servidor de destino.

   1. Token raiz para instâncias de de origem e destino do Influx.

   1. Endereço do host das instâncias de origem e destino do Influx.

   1. (Opcional) Nome e credenciais do bucket S3; as AWS Command Line Interface credenciais devem ser definidas nas variáveis de ambiente do sistema operacional.

      ```
      # AWS credentials (for timestream testing)
          export AWS_ACCESS_KEY_ID="xxx"
          export AWS_SECRET_ACCESS_KEY="xxx"
      ```

   1. Construa o comando como:

      ```
      python3 influx_migration.py --src-bucket [amzn-s3-demo-source-bucket]  --dest-bucket [amzn-s3-demo-destination-bucket] --src-host [source host] --dest-host [dest host] --s3-bucket [amzn-s3-demo-bucket2](optional) --log-level debug
      ```

   1. Execute o script:  
![Execução do script](http://docs.aws.amazon.com/pt_br/timestream/latest/developerguide/images/script-execution.png)

   1. Aguarde o término da execução do script.

   1. Verifique a integridade dos dados no bucket recém-migrado `performance.txt`. Esse arquivo, localizado no mesmo diretório em que o script foi executado, contém algumas informações básicas sobre a duração de cada etapa.

## Cenários de migração
<a name="timestream-for-influx-migration-scenarios"></a>

**Example Exemplo 1: migração simples usando o armazenamento local**  
Você deseja migrar um único bucket, amzn-s3-demo-primary-bucket, do servidor de origem para um servidor `(http://localhost:8086)` de destino. `(http://dest-server-address:8086)`  
Depois de garantir que você tem acesso TCP (para acesso HTTP) às duas máquinas que hospedam as instâncias do InfluxDB na porta 8086 e tem tokens de origem e destino e eles foram armazenados como variáveis de ambiente `INFLUX_SRC_TOKEN` e `INFLUX_DEST_TOKEN`, respectivamente, para maior segurança:  

```
python3 influx_migration.py --src-bucket amzn-s3-demo-primary-bucket --src-host http://localhost:8086 --dest-host http://dest-server-address:8086
```
A saída deve ser semelhante à seguinte:  

```
INFO: influx_migration.py: Backing up bucket data and metadata using the InfluxDB CLI
2023/10/26 10:47:15 INFO: Downloading metadata snapshot
2023/10/26 10:47:15 INFO: Backing up TSM for shard 1
2023/10/26 10:47:15 INFO: Backing up TSM for shard 8245
2023/10/26 10:47:15 INFO: Backing up TSM for shard 8263
[More shard backups . . .]
2023/10/26 10:47:20 INFO: Backing up TSM for shard 8240
2023/10/26 10:47:20 INFO: Backing up TSM for shard 8268
2023/10/26 10:47:20 INFO: Backing up TSM for shard 2
INFO: influx_migration.py: Restoring bucket data and metadata using the InfluxDB CLI
2023/10/26 10:47:20 INFO: Restoring bucket "96c11c8876b3c016" as "amzn-s3-demo-primary-bucket"
2023/10/26 10:47:21 INFO: Restoring TSM snapshot for shard 12772
2023/10/26 10:47:22 INFO: Restoring TSM snapshot for shard 12773
[More shard restores . . .]
2023/10/26 10:47:28 INFO: Restoring TSM snapshot for shard 12825
2023/10/26 10:47:28 INFO: Restoring TSM snapshot for shard 12826
INFO: influx_migration.py: Migration complete
```
O diretório `influxdb-backup-<timestamp>` será criado e armazenado no diretório de onde o script foi executado, contendo arquivos de backup.



**Example Exemplo 2: migração completa usando armazenamento local e registro em log de depuração**  
Igual ao acima, exceto que você deseja migrar todos os buckets, tokens, usuários e painéis, excluindo os buckets no servidor de destino e prosseguindo sem a confirmação do usuário de uma migração completa do banco de dados usando a opção `--confirm-full`. Você também quer ver quais são as medidas de desempenho para ativar o registro em log de depuração.  

```
python3 influx_migration.py --full --confirm-full --src-host http://localhost:8086 --dest-host http://dest-server-address:8086 --log-level debug
```
A saída deve ser semelhante à seguinte:  

```
INFO: influx_migration.py: Backing up bucket data and metadata using the InfluxDB CLI
2023/10/26 10:55:27 INFO: Downloading metadata snapshot
2023/10/26 10:55:27 INFO: Backing up TSM for shard 6952
2023/10/26 10:55:27 INFO: Backing up TSM for shard 6953
[More shard backups . . .]
2023/10/26 10:55:36 INFO: Backing up TSM for shard 8268
2023/10/26 10:55:36 INFO: Backing up TSM for shard 2
DEBUG: influx_migration.py: backup started at 2023-10-26 10:55:27 and took 9.41 seconds to run.
INFO: influx_migration.py: Restoring bucket data and metadata using the InfluxDB CLI
2023/10/26 10:55:36 INFO: Restoring KV snapshot
2023/10/26 10:55:38 WARN: Restoring KV snapshot overwrote the operator token, ensure following commands use the correct token
2023/10/26 10:55:38 INFO: Restoring SQL snapshot
2023/10/26 10:55:39 INFO: Restoring TSM snapshot for shard 6952
2023/10/26 10:55:39 INFO: Restoring TSM snapshot for shard 6953
[More shard restores . . .]
2023/10/26 10:55:49 INFO: Restoring TSM snapshot for shard 8268
2023/10/26 10:55:49 INFO: Restoring TSM snapshot for shard 2
DEBUG: influx_migration.py: restore started at 2023-10-26 10:55:36 and took 13.51 seconds to run.
INFO: influx_migration.py: Migration complete
```



**Example Exemplo 3: migração completa usando CSV, organização de destino e bucket do S3**  
Igual ao exemplo anterior, mas usando Linux ou Mac e armazenando os arquivos no bucket do S3, `amzn-s3-demo-bucket`. Isso evita que os arquivos de backup sobrecarreguem a capacidade de armazenamento local.  

```
python3 influx_migration.py --full --src-host http://localhost:8086 --dest-host http://dest-server-address:8086 --csv --dest-org MyOrg --s3-bucket amzn-s3-demo-bucket
```
A saída deve ser semelhante à seguinte:  

```
INFO: influx_migration.py: Creating directory influxdb-backups
INFO: influx_migration.py: Mounting amzn-s3-demo-influxdb-migration-bucket
INFO: influx_migration.py: Creating directory influxdb-backups/amzn-s3-demo-bucket/influxdb-backup-1698352128323
INFO: influx_migration.py: Backing up bucket data and metadata using the InfluxDB v2 API
INFO: influx_migration.py: Restoring bucket data and metadata from csv
INFO: influx_migration.py: Restoring bucket amzn-s3-demo-some-bucket
INFO: influx_migration.py: Restoring bucket amzn-s3-demo-another-bucket
INFO: influx_migration.py: Restoring bucket amzn-s3-demo-primary-bucket
INFO: influx_migration.py: Migration complete
INFO: influx_migration.py: Unmounting influxdb-backups
INFO: influx_migration.py: Removing temporary mount directory
```