Importando dados
Carregue arquivos JSON, CSV ou Excel em qualquer tabela por meio de um assistente em três etapas, com pré-visualização, mapeamento de tipo por coluna, renomeação, tamanho de lote e progresso em tempo real.
Arquivos suportados
| Formato | Regras |
|---|---|
| JSON | Um array de objetos (um único objeto é tratado como uma linha). As colunas são a união das chaves das primeiras 200 linhas. Objetos e arrays aninhados são mantidos como mapas e listas. |
| CSV | Separado por vírgulas, UTF-8, primeira linha como cabeçalho, valores entre aspas duplas com aspas duplicadas como escape. Linhas em branco são ignoradas. |
| Excel (.xlsx, .xls) | Linha 1 como cabeçalho. Números e booleanos são preservados, e células com fórmulas usam o resultado calculado. Pastas de trabalho com várias planilhas exibem um seletor de planilha. A leitura é feita pelo backend embutido; arquivos de até 100 MB. |
{"S": "value"}, não são interpretados; eles seriam importados como mapas aninhados. A exportação do DynamoOps gera JSON simples, que pode ser importado de volta sem problemas.Etapa 1 — Escolha um arquivo
Clique em ⬆ Import. Solte um arquivo na área indicada ou procure-o no computador. Um chip confirma o nome do arquivo com a quantidade de linhas e colunas detectadas. Escolha a Target table (tabela de destino), que por padrão é a tabela aberta, selecione uma Sheet (planilha) se a pasta de trabalho tiver várias e clique em Next →.
Etapa 2 — Mapeie as colunas
Uma pré-visualização das cinco primeiras linhas fica acima da grade de mapeamento, que tem uma linha por coluna.
- Includecheckbox
- Desmarque para deixar a coluna fora da importação.
- Type in DynamoDBselect
- Auto, String, Number, Boolean, JSON (parse) ou Skip. O DynamoOps pré-seleciona Number ou Boolean quando mais de 90% dos valores amostrados parecem desse tipo.
- Rename totext
- Grava a coluna com um nome de atributo diferente. Use isso para mapear os cabeçalhos do arquivo para os nomes dos atributos de chave da tabela.
Abaixo da grade, três opções controlam a escrita:
- Skip empty / null values (ativado por padrão) remove de cada item os atributos vazios, null e undefined.
- Batch size per request (padrão 500, intervalo de 25 a 5000) define quantas linhas são enviadas ao backend por requisição; o backend as divide em lotes de 25 para o DynamoDB.
- Overwrite existing items reflete a semântica de escrita: cada linha é gravada com um Put, então um item com a mesma chave é substituído.
Clique em Import. O rodapé confirma “N rows → table”.
Como os valores são convertidos
| Tipo | Regra de conversão |
|---|---|
| Auto | true/false viram booleanos, null vira null, texto numérico vira número, objetos e arrays JSON são interpretados, e todo o resto continua como string |
| String | Mantido como texto |
| Number | Convertido com Number(); texto não numérico é mantido como string |
| Boolean | true, 1 e yes viram true; qualquer outro valor vira false |
| JSON (parse) | Interpretado como JSON; JSON inválido é mantido como a string original |
Etapa 3 — Progresso e erros
- Acompanhe a barra de progresso
O rótulo conta “Importing… x / N” e as estatísticas mostram Imported, Total e Errors.
- Revise os erros
São listados até dez erros de lote, por exemplo um erro de validação quando uma linha não tem a chave de partição.
- Conclua
Abort interrompe antes do próximo bloco; Done fecha o assistente e atualiza a grade.
A capacidade de escrita consumida é reportada na análise de custos.
Arquivos de exemplo
[
{ "userId": "usr_001", "email": "alice@example.com", "active": true, "plan": { "name": "pro", "seats": 3 } },
{ "userId": "usr_002", "email": "bob@example.com", "active": false }
]