Importación de datos
Carga archivos JSON, CSV o Excel en cualquier tabla mediante un asistente de tres pasos con vista previa, asignación de tipos por columna, cambio de nombre, tamaño de lote y progreso en tiempo real.
Archivos compatibles
| Formato | Reglas |
|---|---|
| JSON | Un arreglo de objetos (un objeto único se trata como una fila). Las columnas son la unión de las claves de las primeras 200 filas. Los objetos y arreglos anidados se conservan como mapas y listas. |
| CSV | Separado por comas, UTF-8, con la primera línea como encabezados y comillas dobles como delimitador, duplicándolas para escaparlas. Las líneas en blanco se omiten. |
| Excel (.xlsx, .xls) | La fila 1 se usa como encabezados. Los números y booleanos se conservan, y las celdas con fórmulas usan su resultado calculado. Los libros con varias hojas muestran un selector de hoja. Lo procesa el backend integrado; archivos de hasta 100 MB. |
{"S": "value"}, no se interpretan; se importarían como mapas anidados. La exportación de DynamoOps genera JSON simple que se vuelve a importar sin problemas.Paso 1 — Elige un archivo
Haz clic en ⬆ Import. Suelta un archivo en la zona indicada o búscalo en tu equipo. Una etiqueta confirma el nombre del archivo junto con la cantidad de filas y columnas detectadas. Elige la Target table (tabla de destino), que de forma predeterminada es la tabla abierta, selecciona una Sheet (hoja) si el libro tiene varias y luego haz clic en Next →.
Paso 2 — Asigna las columnas
Encima de la cuadrícula de asignación, que tiene una línea por columna, hay una vista previa de las primeras cinco filas.
- Includecheckbox
- Desmárcalo para dejar la columna fuera de la importación.
- Type in DynamoDBselect
- Auto, String, Number, Boolean, JSON (parse) o Skip. DynamoOps preselecciona Number o Boolean cuando más del 90 % de los valores de la muestra parecen de ese tipo.
- Rename totext
- Escribe la columna con un nombre de atributo diferente. Úsalo para asignar los encabezados del archivo a los nombres de los atributos de clave de la tabla.
Debajo de la cuadrícula, tres opciones controlan la escritura:
- Skip empty / null values (activada de forma predeterminada) elimina de cada ítem los atributos vacíos, null y undefined.
- Batch size per request (500 de forma predeterminada, rango de 25 a 5000) es la cantidad de filas que se envían al backend por solicitud; el backend las divide en lotes de DynamoDB de 25.
- Overwrite existing items refleja la semántica de escritura: cada fila se escribe con un Put, así que un ítem con la misma clave se reemplaza.
Haz clic en Import. El pie confirma “N rows → table” (N filas → tabla).
Cómo se convierten los valores
| Tipo | Regla de conversión |
|---|---|
| Auto | true/false se convierten en booleanos, null en null, el texto numérico en número, los objetos y arreglos JSON se analizan, y todo lo demás queda como cadena |
| String | Se conserva como texto |
| Number | Se convierte con Number(); el texto no numérico se conserva como cadena |
| Boolean | true, 1 y yes se convierten en true; cualquier otro valor, en false |
| JSON (parse) | Se analiza como JSON; el JSON inválido se conserva como la cadena original |
Paso 3 — Progreso y errores
- Sigue la barra de progreso
La etiqueta cuenta “Importing… x / N” y las estadísticas muestran Imported, Total y Errors (importados, total y errores).
- Revisa los errores
Se listan hasta diez errores de lote, por ejemplo un error de validación cuando a una fila le falta la clave de partición.
- Termina
Abort se detiene antes del siguiente bloque; Done cierra el asistente y actualiza la cuadrícula.
La capacidad de escritura consumida se informa en Cost Analytics.
Archivos de ejemplo
[
{ "userId": "usr_001", "email": "alice@example.com", "active": true, "plan": { "name": "pro", "seats": 3 } },
{ "userId": "usr_002", "email": "bob@example.com", "active": false }
]