Nube de Atoms Database 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 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.

1. Abre tu proyecto en un dispositivo de escritorio.
2. En la misma barra de herramientas del espacio de trabajo donde está Visor de Apps , selecciona Nube de Atoms.
3. Selecciona Base de datos en la barra lateral de Nube de Atoms.
4. 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 construyes 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

1. Selecciona la tarjeta de base de datos Development o Production, según el entorno en el que quieras trabajar.
2. 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.
3. Usa Search rows para buscar dentro de la tabla actual, o selecciona Filter para limitar los resultados usando uno o más campos.
4. Usa los controles de flechas de página debajo de la tabla para ver filas adicionales.
5. 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:

Operación	Cómo hacerlo
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. Selecciona Commit Changes para guardar todas las ediciones pendientes, o Discard para eliminarlas.
Eliminar filas	Selecciona una o más filas, selecciona Delete 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 celdas en línea 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 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 fiable 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:

Operación	Cómo hacerlo
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 elegible 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 prueba tu app después. 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:

Operación	Cómo hacerlo
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 exportan las filas coincidentes. De lo contrario, se exportan 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

Acción	Quién puede realizarla	Requisitos adicionales
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 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 la base de datos

“No databases found” o “No tables found”

Asegúrate de que Nube de Atoms esté conectado al proyecto. Si ya está conectado, 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 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 proyecto o enlace de Chat, entorno, tabla, rol en el espacio de trabajo, 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 proyecto o enlace de Chat, entorno, tabla de destino, rol en el espacio de trabajo, nombre y tamaño del archivo, 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 de 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 Development/Production, el estado de la migración y las diferencias del 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.