Base de datos
La Base de datos de Nube de Atoms almacena y gestiona los datos estructurados de los que depende tu app, incluidos productos, reservas, pedidos, envíos de formularios y contenido generado por usuarios. En el módulo de Base de datos, puedes ver entornos y tablas, buscar y editar registros, inspeccionar estructuras de tablas e importar o exportar datos mediante archivos CSV.
Esta guía cubre la base de datos integrada en Nube de Atoms. Si tu proyecto usa Supabase, consulta Conectar Supabase en su lugar.
Abrir una base de datos
Antes de abrir una base de datos, conecta tu proyecto a Nube de Atoms. Si aún no está conectado, sigue los pasos de conexión en Nube de Atoms.
- Abre tu proyecto en un dispositivo de escritorio.
- En la misma barra de herramientas del espacio de trabajo donde está el Visor de Apps, selecciona Nube de Atoms.
- Selecciona Base de datos en la barra lateral de Atoms Cloud.
- En Databases, selecciona qué base de datos quieres inspeccionar. Las tarjetas de base de datos Development y Production aparecen cuando están disponibles para el proyecto.
Cada tarjeta de base de datos muestra cuánto almacenamiento se está usando y la cantidad total disponible. Usa Development mientras desarrollas y pruebas tu app. Los cambios realizados en Production pueden afectar los datos de la app en vivo, así que siempre verifica en qué entorno estás antes de hacer cambios.
Elige la base de datos Development o Production.
Explorar y filtrar datos de tablas
- Selecciona la tarjeta de base de datos Development o Production, según el entorno en el que quieras trabajar.
- Usa Search tables para encontrar una tabla, o selecciona una directamente de la lista. Cada tarjeta de tabla muestra su cantidad de filas y si es de solo lectura.
- Usa Search rows para buscar dentro de la tabla actual, o selecciona Filter para limitar los resultados usando uno o más campos.
- Usa los controles de flecha de página debajo de la tabla para ver filas adicionales.
- Para inspeccionar la estructura de la tabla, abre el menú ••• y selecciona Schema.
La vista Schema muestra el nombre de cada campo, tipo de dato, estado de clave, requisitos, restricciones y valor predeterminado. Selecciona Copy para copiar el esquema mostrado.
Agregar, editar o eliminar filas
Cuando hayas encontrado la base de datos en la que quieres hacer cambios, puedes usar estas acciones para hacerlo:
| Operation | How to do it |
|---|---|
| Agregar una fila | Abre... y selecciona Add Row. Ingresa valores que coincidan con los campos disponibles y luego envía la fila. |
| Editar una fila | Haz doble clic en una celda e ingresa el nuevo valor. SeleccionaCommit Changes para guardar todas las ediciones pendientes, o Discard para eliminarlas. |
| Eliminar filas | Selecciona una o más filas, seleccionaDelete y luego confirma. La eliminación de filas no se puede deshacer. |
Agregar una fila o confirmar una eliminación aplica el cambio inmediatamente a la base de datos seleccionada. Solo las ediciones en línea de celdas requieren que selecciones Commit Changes o Discard. Si tienes ediciones pendientes, confírmalas o descártalas antes de agregar una fila, importar o exportar un archivo CSV, cambiar la búsqueda o los filtros, o navegar a otra página.
Si el proyecto está en un espacio de trabajo, solo los Editors y el workspace owner pueden editar filas en tablas editables. Si Atoms no puede detectar una clave primaria para una tabla, no podrás editar ni eliminar sus filas porque Atoms no puede identificar de forma confiable los registros individuales.
Revisa una edición de fila pendiente y luego confirma o descarta el cambio.
Crear tablas o cambiar el esquema
Abre el entorno de base de datos que quieres actualizar y luego sigue las instrucciones para el cambio que quieres hacer:
| Operation | How to do it |
|---|---|
| Crear una tabla | En la lista de tablas, haz clic en... y selecciona Create table. Ingresa un nombre de tabla válido y los campos iniciales, luego envía la solicitud. Espera a que el Agente termine, vuelve a abrir Base de datos y verifica la tabla. |
| Cambiar el esquema | Haz clic en la tabla en la que quieres hacer cambios, luego haz clic en... y selecciona Schema. Usa Add Field para crear un campo, o selecciona un campo apto para editarlo. Puedes cambiar su nombre, tipo, valor predeterminado, estado de obligatorio o unicidad. También puedes marcar campos que no sean clave para eliminarlos. Selecciona Submit Changes para enviar la solicitud al Agente, o Discard para borrar tus cambios pendientes. |
Solo el workspace owner puede crear tablas o cambiar el esquema de una tabla.
Enviar una solicitud de esquema no significa que la migración esté completa. Espera a que el Agente termine, verifica el resultado en Base de datos y luego prueba tu app. Los campos de clave primaria y las tablas de solo lectura no se pueden modificar de esta manera.
Ingresa los detalles del nuevo campo en Add Field.
Revisa los cambios de esquema pendientes antes de seleccionar Submit Changes.
Importar o exportar datos CSV
Selecciona la tabla con la que quieres trabajar y luego sigue las instrucciones para la operación correspondiente:
| Operation | How to do it |
|---|---|
| Importar CSV | Haz clic en... y selecciona Import CSV. Elige un archivo .csv de no más de 10 MB y luego revisa el nombre del archivo, la cantidad estimada de filas, la tabla seleccionada y el entorno antes de confirmar. Las columnas del CSV deben coincidir con el esquema de la tabla. Las filas importadas se agregan de inmediato y no se pueden deshacer automáticamente, así que considera exportar primero los datos existentes. |
| Exportar CSV | Haz clic en... y selecciona Export CSV. Si hay una búsqueda o filtro activo, solo se exportarán las filas coincidentes. De lo contrario, se exportarán todos los datos de la tabla actual. |
Solo el workspace owner puede importar o exportar archivos CSV. Para las tablas de solo lectura, Export CSV es la única opción disponible.
Permisos y tablas protegidas
| Action | Who can perform it | Additional requirements |
|---|---|---|
| Agregar, editar o eliminar filas | Editor o workspace owner | La tabla debe ser editable. Editar y eliminar filas también requiere información de clave primaria. |
| Crear tablas o cambiar esquemas | Espacio de trabajo owner | Los campos de clave primaria y las tablas de solo lectura no se pueden modificar. |
| Importar o exportar archivos CSV | Espacio de trabajo owner | Los archivos CSV no se pueden importar en tablas de solo lectura. |
Las tablas protegidas del sistema o del usuario pueden mostrar una insignia de Read-only. Puedes ver sus datos e inspeccionar su esquema cuando esté disponible, pero no puedes modificar sus filas ni su estructura desde esta página.
Solucionar problemas comunes de base de datos
“No databases found” o “No tables found”
Asegúrate de que Nube de Atoms esté conectada al proyecto. Si ya está conectada, confirma que tu app incluya una función que almacene datos persistentes. Si es necesario, pide al Agente que agregue la función respaldada por base de datos. Una vez que el Agente haya terminado, vuelve a abrir Base de datos o selecciona Refresh.
Falta una acción de base de datos o no está disponible
Verifica si la tabla tiene una insignia de Read-only y luego revisa los permisos anteriores para confirmar que tu rol en el espacio de trabajo permite la acción. Editar y eliminar filas también requiere información de clave primaria.
Las ediciones de filas pendientes pueden impedir otras acciones. Selecciona Commit Changes o Discard antes de agregar una fila, importar o exportar un archivo CSV, cambiar la búsqueda o los filtros, o pasar a otra página.
Si la acción sigue sin estar disponible después de estas comprobaciones, contacta a Support e incluye el enlace del proyecto o del Chat, el entorno, la tabla, el rol en el espacio de trabajo, la acción intentada y el texto exacto del error.
No se puede importar un archivo CSV
Solo el workspace owner puede importar datos, y la tabla de destino debe ser editable. Asegúrate de que:
- El archivo use el formato
.csv. - El archivo no sea mayor de 10 MB.
- Sus columnas y datos sean compatibles con el esquema de la tabla de destino.
- Hayas confirmado o descartado cualquier edición de fila pendiente.
Si la importación sigue fallando, contacta a Support e incluye el enlace del proyecto o del Chat, el entorno, la tabla de destino, el rol en el espacio de trabajo, el nombre y tamaño del archivo, la acción intentada y el texto exacto del error.
Preguntas frecuentes
Mi base de datos de producción no se está sincronizando. ¿Qué debo hacer?
Si Development funciona normalmente pero el sitio en vivo (Production) muestra tablas, columnas o errores de migración faltantes:
Importante: No reconstruyas ni sobrescribas la base de datos de producción por tu cuenta.
Información necesaria:
- Enlace del Chat y URL en vivo
- Mensaje de error SQL completo
- Nombres de tablas/columnas faltantes
- Último cambio en el esquema de la base de datos
- Última versión en vivo que funcionaba
- Si los datos de producción deben conservarse
- Si quieres sincronizar completamente los datos de Development o solo completar las estructuras faltantes
Contacta a soporte con estos detalles para que podamos comparar las versiones de Development/Production, el estado de la migración y las diferencias de esquema antes de hacer cambios.
¿Por qué mis datos de desarrollo son diferentes de los datos de producción?
Si has publicado varias veces pero Production sigue mostrando datos antiguos mientras las actualizaciones de código funcionan bien:
Antes de contactar a soporte, confirma:
1. ¿Deben conservarse los datos actuales de producción?
2. ¿Quieres sobrescribir completamente con los datos actuales de Development, o solo completar los registros faltantes?
3. ¿Ya tienes una copia de seguridad?
4. ¿Cuál es tu ventana de mantenimiento aceptable?
No sobrescribiremos ni reconstruiremos los datos de producción hasta que se confirme el objetivo del manejo de datos. Proporciona las URL de Development/Production y ejemplos de ID o cantidades de registros que muestren la diferencia.
¿Puedo mover una base de datos de un proyecto de Atoms a otro sin perder datos?
Actualmente, Atoms no admite la migración automática y sin pérdida de bases de datos entre proyectos. Crear un proyecto nuevo o dividir un proyecto existente no copiará automáticamente las cuentas de usuario ni los registros de base de datos existentes al nuevo proyecto.
Antes de continuar:
- No restablezcas, reemplaces, migres ni elimines la base de datos existente ni los recursos del proyecto.
- Mantén el proyecto original sin cambios como fuente de los datos existentes.
- Contacta a Atoms Support y proporciona el proyecto de origen, el proyecto de destino, el proveedor de base de datos y los datos que deben conservarse.
En algunos casos, el equipo puede ayudarte con una copia manual única desde la base de datos de origen a la base de datos de destino. Esto no es una sincronización continua: cualquier dato nuevo escrito en el origen después de que comience la copia no aparecerá automáticamente en el destino.
Para minimizar las diferencias de datos, pausa las escrituras en la base de datos de origen durante la ventana de migración y verifica los datos copiados en el proyecto de destino antes de cambiar a él. Actualmente no se puede garantizar una migración completamente sin pérdida.