Usando o carregamento em lote com o console

A seguir estão as etapas para usar o carregamento em lote com o Console de gerenciamento da AWS. Você pode baixar um exemplo de CSV em Amostra CSV.

Acessar o carregamento em lote

Siga estas etapas para acessar o carregamento em lote usando o Console de gerenciamento da AWS.

1. Abra o Console do Amazon Timestream.

2. No painel de navegação, escolha Ferramentas de gerenciamento e, em seguida, escolha Tarefas de carregamento em lote.

3. A partir daqui, você pode ver a lista de tarefas de carregamento em lote e detalhar uma determinada tarefa para obter mais detalhes. Você também pode criar e retomar tarefas.

Criar uma tarefa de carregamento em lote

Para criar uma tarefa de carregamento em lote usando Console de gerenciamento da AWS, siga estas etapas.

1. Abra o Console do Amazon Timestream.

2. No painel de navegação, escolha Ferramentas de gerenciamento e, em seguida, escolha Tarefas de carregamento em lote.

3. Escolha Criar tarefa de carregamento em lote.

4. Em Destino de importação, escolha o seguinte.

   • Banco de dados de destino: selecione o nome do banco de dados criado em Criar um banco de dados.

   • Tabela de destino: selecione o nome da tabela criada em Criar uma tabela.

   Se necessário, você pode adicionar uma tabela desse painel com o botão Criar nova tabela.

5. Em Localização da fonte de dados S3 em Fonte de dados, selecione o bucket do S3 em que os dados de origem estão armazenados. Use o botão Procurar no S3 para visualizar os recursos do S3 aos quais a AWS conta ativa tem acesso ou insira a URL de localização do S3. A fonte de dados deve estar localizada na mesma região.

6. Em Configurações de formato de arquivo (seção expansível), você pode usar as configurações padrão para analisar os dados de entrada. Você também pode escolher Configurações avançadas. A partir daí, você pode escolher os parâmetros do formato CSV e selecionar os parâmetros para analisar os dados de entrada. Para informações sobre esses parâmetros, consulte Parâmetros do formato CSV.

7. Em Configurar mapeamento do modelo de dados, configure o modelo de dados. Para obter orientações adicionais sobre o modelo de dados, consulte Mapeamentos de modelos de dados para carregamento em lote

   • Em Mapeamento do modelo de dados, escolha Entrada de configuração de mapeamento e escolha uma das opções a seguir.

     • Construtor visual — Para mapear dados visualmente, escolha TargetMultiMeasureNameou MeasureNameColumn. Em seguida, mapeie as colunas no Visual Builder.

       O Visual Builder detecta e carrega automaticamente os cabeçalhos das colunas de origem do arquivo da fonte de dados quando um único arquivo CSV é selecionado como fonte de dados. Escolha o atributo e o tipo de dados para criar seu mapeamento.

       Para obter informações sobre como usar o visual builder, consulte Usar o criador visual.

     • Editor JSON: um editor JSON de formato livre para configurar seu modelo de dados. Escolha essa opção se você estiver familiarizado com o Timestream for LiveAnalytics e quiser criar mapeamentos avançados de modelos de dados.

     • Arquivo JSON do S3: selecione um arquivo de modelo JSON que você armazenou no S3. Escolha essa opção se você já configurou um modelo de dados e deseja reutilizá-lo para cargas em lote adicionais.

8. Em Localização dos logs de erro do S3 em Relatório do log de erro, selecione a localização do S3 que será usada para reportar erros. Para obter informações sobre como utilizar esse relatório, consulte Usando relatórios de erro de carregamento em lote.

9. Em Tipo de chave de criptografia, selecione uma das seguintes opções.

   • Chave gerenciada pelo Amazon S3 (SSE-S3): uma chave de criptografia que o Amazon S3 cria, gerencia e usa para você.

   • AWS KMS key (SSE-KMS) — Uma chave de criptografia protegida por AWS Key Management Service ().AWS KMS

10. Escolha Próximo.

11. Na página Revisar e criar, revise as configurações e edite conforme necessário.

    nota

    Não é possível alterar as configurações da tarefa de carregamento em lote após sua criação. Os tempos de conclusão da tarefa vão variar com base na quantidade de dados que estão sendo importados.

12. Escolha Criar tarefa de carregamento em lote.

Retomar uma tarefa de carregamento em lote

Quando você seleciona uma tarefa de carregamento em lote com o status “Progresso interrompido” que ainda pode ser retomada, você é instruído a retomar a tarefa. Também há um banner com um botão Retomar tarefa quando você visualiza os detalhes dessas tarefas. As tarefas retomáveis têm uma data de validade. Depois que essa data expirar, não será possível retomar as tarefas.

Usar o criador visual

Você pode usar o Visual Builder para mapear colunas de dados de origem de um ou mais arquivos CSV armazenados em um bucket do S3 para colunas de destino em um Timestream para tabela. LiveAnalytics

nota

Seu perfil precisará da permissão SelectObjectContent para o arquivo. Sem isso, será necessário adicionar e excluir colunas manualmente.

Modo de carregamento automático de colunas de origem

O Timestream for LiveAnalytics pode verificar automaticamente o arquivo CSV de origem em busca de nomes de colunas se você especificar apenas um bucket. Quando não há mapeamentos existentes, você pode escolher Importar colunas de origem.

1. Com a opção Visual builder selecionada nas Configurações de entrada da configuração de mapeamento, defina a entrada de hora do registro de data e hora. Millisecondsé a configuração padrão.

2. Clique no botão Carregar colunas de origem para importar os cabeçalhos das colunas encontrados no arquivo de dados de origem. A tabela será preenchida com os nomes dos cabeçalhos da coluna de origem do arquivo da fonte de dados.

3. Escolha o Nome da coluna da tabela de destino, o Tipo de atributo do Timestream e o Tipo de dados para cada coluna de origem.

   Para obter detalhes sobre essas colunas e valores possíveis, consulte Mapear campos.

4. Use o drag-to-fill recurso para definir o valor de várias colunas ao mesmo tempo.

Adicionar colunas de origem manualmente

Se você estiver usando um bucket ou prefixo CSV e não um único CSV, poderá adicionar e excluir mapeamentos de colunas do editor visual com os botões Adicionar mapeamento de coluna e Excluir mapeamento de coluna. Também há um botão para redefinir os mapeamentos.

Mapear campos

• Nome da coluna de origem: o nome de uma coluna no arquivo de origem que representa uma medida a ser importada. O Timestream for LiveAnalytics pode preencher esse valor automaticamente quando você usa colunas de origem de importação.

• Nome da coluna da tabela de destino: entrada opcional que indica o nome da coluna da medida na tabela de destino.

• Tipo de atributo Timestream: o tipo de atributo dos dados na coluna de origem especificada, como DIMENSION.

  • TIMESTAMP: especifica quando uma medida foi coletada.

  • MULTI: várias medidas são representadas.

  • DIMENSION: metadados de séries temporais.

  • MEASURE_NAME: esse é o nome da medida para registros de medida única.

• Tipo de dados: o tipo de coluna Timestream, como BOOLEAN.

  • BIGINT: um número inteiro de 64 bits.

  • BOOLEAN: os dois valores verdadeiros da lógica: verdadeiro e falso.

  • DOUBLE: número de precisão variável de 64 bits.

  • TIMESTAMP: uma instância no tempo que usa tempo de precisão de nanossegundos em UTC e rastreia o tempo desde a época do Unix.