Saltar al contenido
Inicio
Docs/Base de datos

Base de datos

PocketCode trae un PostgreSQL 18.2 real que corre dentro de la app en móviles ARM de 64 bits, sin servidor ni cuenta que configurar. Alrededor: una consola SQL con asistente de IA en el propio editor, un visor de datos editable, copias de seguridad y restauración, planes de ejecución, diagramas ER y un diseñador de esquemas. El mismo módulo abre también tus servidores PostgreSQL y MySQL y tus bases de Neon, Supabase, PlanetScale, Turso y Cloudflare D1. MongoDB, Redis, Firestore, la monitorización, la seguridad, los paneles, la importación y el compartir están en Herramientas de base de datos.

Qué es y cómo se abre

Base de datos es un gestor a pantalla completa que se abre sobre la app; no es una de las cinco páginas del pager. Tiene su propia pila de navegación: las pantallas del núcleo están en esta página y el resto en Herramientas de base de datos.

Cuatro formas de abrirlo

DesdeCómo
Hoja de herramientasPulsa Herramientas en la barra inferior y después la baldosa Database de Herramientas de desarrollo. Llegas a la pantalla de inicio.
Paleta de comandosEjecuta Gestor de bases de datos («Conecta y consulta tus bases de datos»).
HomeLa acción rápida Base de datos, o el widget de bases de datos.
Backend ManagerAbrir en Database en el proyecto de un proveedor conectado abre directamente su proyecto, sus tablas o su consola SQL.

La pantalla de inicio

La raíz de la navegación del módulo.

Puedes

  • Mis Conexiones abre la lista de conexiones.
  • La tarjeta Base de Datos Local dice Running o Stopped. Púlsala para instalar el motor (solo la primera vez, con barra de progreso), arrancarlo y abrir sus tablas.
  • Arrancar / Parar en la tarjeta cuando la app ya ha comprobado el motor; Administrar (la pantalla del motor) y Usar en el proyecto (la URL de conexión) solo mientras está en marcha.
  • Monitoreo y Diseñador de Esquemas (no necesita conexión).

No puedes, y por qué

  • En un móvil para cuya arquitectura la compilación no trae motor, pulsar la tarjeta no instala nada y avisa «PostgreSQL no viene en esta compilación para tu dispositivo». El resto del módulo funciona.Dispositivo
  • Administrar y Usar en el proyecto no existen con el motor parado: no tendrían nada que enseñar.A propósito
Database Manager start screen on a tablet: My Connections, the Local Database card stopped with only Start, Monitoring and Schema Designer
Inicio en una tablet. Con el motor parado solo hay Start: Administrar y Usar en el proyecto aparecen cuando está en marcha

Cómo moverte

  • Volver es el gesto atrás de Android. Deshace el camino pantalla a pantalla y, en la de inicio, cierra el módulo. No hay flechas de volver en la cabecera.
  • El título es un selector. Tócalo (la ▾ de al lado) para abrir Cambiar base de datos: con el motor local, sus bases, Nueva Base de Datos y Motor; con cualquier otra conexión, solo la base activa. Debajo, Conexiones (la activa primero, marcada Activa) y Todas las conexiones. No se ofrece en la pantalla de inicio, en la lista y el formulario de conexiones, en la lista de proyectos ni en el diseñador de esquemas.
  • El icono de rejilla abre Herramientas: 25 herramientas en seis secciones (Explorar, Consultar, Diseñar, Datos, Servidor, Seguridad), un cuadro Buscar herramientas y una fila Frecuentes que aparece cuando has usado una herramienta tres veces (cuatro como máximo). Solo sale lo que tiene sentido para la conexión abierta.
  • El subtítulo dice qué base está abierta y si el motor está en marcha, por ejemplo postgres · ● Motor en marcha.
  • El bloqueo biométrico, si lo activaste en Seguridad, pide tu huella, tu cara o el PIN / patrón del dispositivo al abrir el módulo.
Database Manager start screen with My Connections, the Local Database card running, Monitoring and Schema Designer
Inicio — conexiones, el motor local y dos accesos
Tools sheet with Frequent, Explore and Query sections
Herramientas — una hoja, agrupada por lo que quieres hacer
Switch database sheet with the postgres database, New Database, Engine and the list of connections
Toca el título para cambiar de base o de conexión

Móvil, horizontal y tablet

Móvil en verticalUna pantalla cada vez. La consola alterna entre Editor y Resultados.
Móvil en horizontalUn riel estrecho a la izquierda sustituye a la cabecera (Herramientas y el selector de conexión). La consola pone editor y resultados lado a lado con un divisor que se arrastra.
Tablet en verticalEditor arriba y resultados debajo, con posiciones de 30 / 50 / 70 %. El panel lateral se abre como un cajón.
Tablet en horizontalUn riel de Herramientas permanente que se pliega a una franja estrecha, un panel lateral con tus conexiones y tablas (se acopla a partir de 952 dp de ancho), el detalle de fila junto a la rejilla, una tira de pestañas y atajos de teclado en la consola.

Mapa de pantallas

Una fila por cada pantalla, hoja y pestaña del módulo que cubre esta página.

PantallaCómo llegasQué puedes hacer
Database Manager (inicio)Herramientas → Database, la paleta, Home o Abrir en DatabaseAbrir Mis Conexiones, arrancar o parar el motor local, Administrarlo, Usar en el proyecto, abrir Monitoreo o Diseñador de Esquemas.
Bases de datos (lista de conexiones)Mis Conexiones, o Todas las conexiones en el selector del títuloVer favoritas, locales, en la nube y personalizadas; abrir, editar, duplicar, probar, marcar como favorita o eliminar una; añadir un servidor con +.
Nueva conexión / Editar conexión+, el ⋮ de una tarjeta o Usar una conexión directa en un proyecto de SupabaseParsear una cadena de conexión, rellenar los datos, configurar TLS y túnel SSH, Probar conexión, Guardar.
TablasToca una conexión, o Herramientas → TablasBuscar tablas y vistas, abrir datos o estructura, Crear Tabla, importar, exportar.
Datos (visor)Toca una tabla o vistaFiltro, Orden, Columnas, Vistas, editar celdas, seleccionar filas, Copiar Como, Exportar, Insertar Fila, añadir una columna.
Detalle de FilaToca una filaLeer y editar una fila como formulario, Copiar JSON.
Detalle de Tabla⋮ → Detalle de Tabla, o Estructura en una tablaColumnas, índices, claves, disparadores y DDL; Renombrar, Vaciar, Eliminar Tabla.
Crear TablaCrear Tabla o Herramientas → Tabla nuevaDefinir una tabla con 15 tipos de columna y las marcas PK, AI, NN, UQ.
Consola SQLHerramientas → Consola SQLEscribir y ejecutar SQL, pedirlo a la IA, usar parámetros y pestañas, copiar o exportar resultados, Explicar.
Plan de ejecuciónHerramientas → Plan de ejecución, o ExplicarVer el plan como árbol, medirlo con Analizar de verdad, recibir índices sugeridos y una explicación con IA.
Árbol de SchemaHerramientas → Árbol de esquemaExplorar base → tablas → columnas e índices.
Diagrama ERHerramientas → Diagrama ERUn diagrama de tablas y relaciones que se pellizca y se arrastra, Exportar Diagrama como PNG, Editar como diseño.
Diff de EsquemaHerramientas → Comparar esquemas (Pro)Guardar Snapshot, Ejecutar Diff, Generar Migración.
Backup y RestauraciónHerramientas → Copias de seguridadHacer, restaurar, importar y exportar copias del PostgreSQL local; programar copias (Pro).
MotorAdministrar, Motor en el selector del título, o Herramientas → Ajustes del motor, Extensiones, Registro del servidorSalud, Extensiones, Registro y Ajustes del PostgreSQL local.
Diseñador de Esquemas y el asistente de esquema nuevoInicio, o Herramientas → Diseñador de esquemaListar, crear (asistente de 3 pasos, 6 plantillas), duplicar y eliminar proyectos de esquema.
Editor de esquema, editor de tabla y Exportar EsquemaAbre un proyecto de esquemaDibujar tablas y relaciones, editar columnas, exportar a 7 formatos, Aplicar a … en la consola.
Hoja y riel de HerramientasEl icono de rejilla; permanente en una tablet en horizontalBuscar y abrir cualquiera de las 25 herramientas.
Cambiar base de datos y el panel lateralToca el título; el panel en una tabletCambiar de base o de conexión, Nueva Base de Datos, Motor, buscar conexiones y tablas.
Usar en el proyectoUsar en el proyecto en la tarjeta del motorVer la URL de conexión, Revelar, Copiar URL, Escribir .env en el proyecto abierto.
Más pantallas del móduloHoja de herramientas, listas de proyectos, Abrir en DatabaseProyectos de cuentas de proveedor, Vista previa de importación, Historial de consultas, Consultas guardadas, Gráficos, Paneles, Monitoreo, Datos de prueba, Seguridad, Registro de auditoría, Compartir, Redis, Firestore y el diff de PlanetScale: todo en Herramientas de base de datos.
Las pantallas de la última fila, y las herramientas de la hoja Herramientas que no están en esta página, se explican en Herramientas de base de datos.

Qué puedes conectar

El módulo abre 13 tipos de base de datos. Tus servidores PostgreSQL y MySQL son conexiones que guardas; las cuentas de proveedor salen de los servicios que conectas en Ajustes → Integraciones → Servicios conectados (o desde el Backend Manager) y necesitan red. Firestore usa tu proyecto de Firebase.

MotorCómo conectaQué puedes hacer
PostgreSQL (local)El motor que va dentro de la app: PostgreSQL 18.2 en 127.0.0.1:5433, sin cuenta. Solo móviles ARM de 64 bits.Todo lo de esta página, además de ajustes del motor, extensiones, registro del servidor, copias con restauración y Usar en el proyecto.
PostgreSQL (tu servidor)Directo a tu host, con TLS y túnel SSH opcionales.Tablas, datos, consola SQL, planes, crear tablas, diagrama ER, herramientas de esquema.
MySQL / MariaDBEl cliente MySQL propio de PocketCode, con TLS y túnel SSH opcionales.Lo mismo, salvo que no lista índices, claves ajenas ni disparadores y sus planes son estimaciones.
NeonTu cuenta de Neon. El SQL va por JDBC cuando la app puede leer la conexión del proyecto desde tu cuenta, y por la API HTTP de Neon en caso contrario.Consola SQL con la guarda Solo lectura, tablas, datos, planes, diagrama ER.
SupabaseTu cuenta de Supabase; el SQL va por su API en todos los esquemas. Usar una conexión directa añade una conexión PostgreSQL real cuando das la contraseña.Lo mismo que Neon.
PlanetScaleTu cuenta lista bases y ramas; una rama se abre como conexión MySQL con comprobación completa del certificado.Como MySQL / MariaDB. El schema de la rama, el schema check y el diff del deploy request están en Herramientas de base de datos.
TursoTu cuenta de Turso; el SQL va por la API HTTP de Turso.Consola SQL, tablas, datos, diagrama ER (los planes de SQLite no traen costes).
Cloudflare D1Tu cuenta de Cloudflare; el SQL va por la API de D1, igual que Turso.Lo mismo que Turso.
MongoDB AtlasTu cuenta de Atlas lista clústeres; tecleas el usuario y la contraseña de la base.Colecciones y recuentos, en Herramientas de base de datos. Sin consola SQL.
Upstash RedisTu cuenta de Upstash; abrir una base conecta como una base Redis real.Herramientas de Redis, en Herramientas de base de datos. Sin consola SQL.
MongoDBEl cliente MongoDB propio de PocketCode, con autenticación SCRAM y TLS.Colecciones y recuentos, en Herramientas de base de datos.
RedisEl cliente Redis propio de PocketCode, con TLS.Explorador de claves, CLI y monitor, en Herramientas de base de datos.
Cloud FirestoreTu proyecto de Firebase en Ajustes → Integraciones, o la sesión de Google del Backend Manager.Explorar y consultar, en Herramientas de base de datos.
PocketCode no pone ningún servidor propio en medio: la app habla directamente con el motor local, con tus hosts o con la API del proveedor. Son 13 tipos de conexión, que la web cuenta como 12 motores porque el motor local y tus servidores PostgreSQL son el mismo motor. Las bases gestionadas de DigitalOcean (PostgreSQL, MySQL y Redis) se abren desde Bases de datos gestionadas en el Backend Manager, como conexiones normales de PostgreSQL, MySQL o Redis que viven en memoria (sin formulario, y no cuentan para el límite de conexiones); sus demás motores no se abren desde ahí. MongoDB, Redis, Firestore, monitorización, seguridad, paneles y el resto se explican en Herramientas de base de datos.

PostgreSQL en tu móvil

El motor es PostgreSQL 18.2 compilado para Android y empaquetado en la app, para móviles ARM de 64 bits (arm64-v8a). Solo escucha en el propio móvil (127.0.0.1, puerto 5433, usuario postgres) y por TCP siempre pide contraseña (SCRAM-SHA-256); la contraseña es aleatoria, se guarda cifrada y el motor no arranca sin ella. No hace falta root, Termux ni conexión.

Arrancarlo

Desde la pantalla de inicio.

  1. 1Pulsa Base de Datos Local. La primera vez, la app desempaqueta el motor y crea el clúster de datos; después arranca el servidor y abre la lista de tablas.
  2. 2Para pararlo, pulsa Parar en la tarjeta del motor. Para volver a arrancarlo, Arrancar.
  3. 3Las pantallas que necesitan el motor (Tablas, Datos, Consola SQL, Plan de ejecución, Árbol de esquema, Diagrama ER y otras) muestran Motor parado con un botón Arrancar cuando está apagado: «Arranca el motor PostgreSQL local para trabajar con sus tablas».
El primer arranque desempaqueta un paquete de unos 36 MB y ejecuta initdb en el móvil para crear el clúster (se le permiten hasta 10 minutos); ocurre una sola vez. La app no mantiene el motor vivo en segundo plano: al salir le pide a PostgreSQL que escriba un checkpoint, y Android puede parar el proceso más tarde. Los pasos del primer arranque («Preparing…», «Extracting…», «Verifying…») y las etiquetas Running / Stopped salen en inglés en todos los idiomas.

No puedes, y por qué

  • El motor no vive en segundo plano: Android puede matar el proceso sin avisar, así que al volver la tarjeta puede decir Stopped y pulsas Arrancar. Google Play exige que un servicio en primer plano tenga un tipo declarado y un propósito visible, y «mantener un PostgreSQL vivo» no encaja en ninguno.Google Play
  • El motor solo viaja para arm64-v8a. En x86 (emuladores, Chromebooks x86) no está disponible.Dispositivo

La pantalla del motor

Se abre con Administrar en la tarjeta del motor o con Motor en el selector del título. Ajustes del motor, Extensiones y Registro del servidor en Herramientas abren la misma pantalla en una pestaña (Ajustes del motor abre Salud, no Ajustes). Tiene cuatro pestañas y un botón Actualizar. Con el motor parado, cada pestaña dice «El motor está parado. Arráncalo para ver su estado».

Landscape tablet: connection list on the left, Engine Health tab with PostgreSQL 18.2, sessions and slowest statements in the middle, and the Tools rail on the right
Tablet en horizontal: tus conexiones a la izquierda, Motor → Salud en el centro y el riel de Herramientas a la derecha

Salud

El estado del servidor en marcha.

Puedes

  • Leer Versión, En marcha desde hace, Tamaño de los datos, Sesiones abiertas, Commits, Rollbacks, Aciertos de caché, Checkpoints e Interbloqueos.
  • Ver el tamaño de cada base en Bases de datos y quitar una con Eliminar base (tras una confirmación: «Se borra todo lo que hay dentro y no se puede deshacer»).
  • Vigilar las Sesiones activas y terminar una con Cancelar consulta o Terminar sesión.
  • Ver las Sentencias más lentas (llamadas, tiempo medio, filas) desde pg_stat_statements. Si no está activa, Activar ejecuta CREATE EXTENSION pg_stat_statements; para medir también hace falta Estadísticas de sentencias activado en Ajustes y reiniciar.

No puedes, y por qué

  • Eliminar base nunca se ofrece para postgres («La base “postgres” es la de mantenimiento del motor y no se puede eliminar») ni para la base a la que estás conectado.A propósito

Extensiones

Las extensiones que trae este paquete de PostgreSQL: 17 en total (btree_gin, btree_gist, citext, dblink, fuzzystrmatch, hstore, pageinspect, pg_freespacemap, pg_stat_statements, pg_trgm, pgcrypto, pgrowlocks, plpgsql, postgres_fdw, tablefunc, unaccent, uuid-ossp).

Puedes

  • Ver Las más útiles (pg_trgm, pgcrypto, uuid-ossp, citext, hstore, pg_stat_statements) y Todas las disponibles, cada una con su nombre, versión y descripción.
  • Activar o desactivar una con su interruptor: ejecuta CREATE EXTENSION o DROP EXTENSION en la base abierta.

No puedes, y por qué

  • No se pueden instalar otras extensiones: solo las 17 del paquete, y el nombre se comprueba contra esa lista antes de ejecutar nada.A propósito

Registro

El log del propio servidor.

Puedes

  • Leer los últimos 256 KiB del log del servidor, filtrados por Todo, LOG, WARNING, ERROR o FATAL.
  • Copiarlo, o Compartirlo como texto.

No puedes, y por qué

—

Ajustes

Cuánta memoria usa el motor y lo seguras que son sus escrituras. Los cambios se aplican al guardar: el motor se reinicia.

Puedes

  • Elegir el Perfil de memoria: Ligero, Equilibrado o Potente. La línea de debajo dice qué ajusta, y RAM detectada lo que informa el móvil.
  • Activar o no Durabilidad y Estadísticas de sentencias («Registra cada sentencia para que Salud pueda enseñar las más lentas. Requiere reiniciar»).
  • Copiar URL copia la URL de conexión completa, con la contraseña.
  • Guardar (solo habilitado si hay cambios; guarda y reinicia: «Ajustes aplicados: el motor se ha reiniciado») y Reiniciar motor.

No puedes, y por qué

  • El puerto es fijo, 5433, y el motor solo escucha en 127.0.0.1: nunca se expone a la red.A propósito
  • Potente solo se ofrece cuando Android informa de 8 GiB de RAM o más.Dispositivo
Engine Extensions tab with pg_trgm switched on
Motor → Extensiones: activa lo que trae PostgreSQL
Engine Settings tab with Light, Balanced and Powerful profiles and the Durability switch
Motor → Ajustes: perfil de memoria y durabilidad

Perfiles de memoria

PerfilQué ajusta
Ligero16 MB de memoria compartida · 2 MB por ordenación · hasta 10 conexiones · 128 MB de effective_cache_size · 2 workers. Por defecto con menos de 6 GiB de RAM.
Equilibrado64 MB de memoria compartida · 4 MB por ordenación · hasta 20 conexiones · 512 MB de effective_cache_size · 3 workers. Por defecto desde 6 GiB.
Potente128 MB de memoria compartida · 8 MB por ordenación · hasta 30 conexiones · 1 GB de effective_cache_size · 4 workers. Necesita 8 GiB o más.

La RAM es el total que informa Android (ActivityManager.totalMem), contado en GiB: un móvil vendido como «de 8 GB» puede informar de menos y no ofrecer Potente. Un perfil guardado que el móvil ya no aguanta se rebaja. Siempre: sin consultas paralelas (max_parallel_workers = 0) y zona horaria UTC.

Durabilidad

  • Activada (por defecto): full_page_writes = on y synchronous_commit = off. Si el móvil se queda sin corriente o Android mata la app, PostgreSQL se recupera solo, pero pueden perderse los últimos milisegundos de transacciones confirmadas; no se corrompe nada.
  • Desactivada: más rápido, pero con full_page_writes = off: un fallo mientras escribe puede dejar la base corrupta y sin vuelta atrás. La pantalla te avisa en ámbar. Déjala activada salvo con datos que puedas regenerar.

Más de una base de datos

El motor local puede tener varias bases.

Puedes

  • Toca el título y elige Nueva Base de Datos; escribe el Nombre de la base de datos y pulsa Crear. El nombre conserva letras, números y _. La app cambia a la base nueva al momento.
  • Todas aparecen en Bases de datos dentro del mismo selector; toca una para cambiar. Extensiones, tablas y consultas se aplican a la que está abierta.

No puedes, y por qué

  • En Free el motor tiene una sola base (postgres), así que Nueva Base de Datos abre el muro Pro directamente; el diálogo y la herramienta llevan una insignia Pro.Pro
  • Solo el motor local cambia de base; el resto de las conexiones tienen una base fija.A propósito

Usarlo desde tu código

Usar en el proyecto en la tarjeta del motor (con el motor en marcha) abre la hoja Usar en el proyecto.

  1. 1La hoja muestra la URL de conexión con la contraseña oculta: postgresql://postgres:***@127.0.0.1:5433/<base>.
  2. 2Revelar muestra la contraseña y Ocultar la vuelve a tapar. Copiar URL copia lo que enseña la hoja, así que copia la versión oculta hasta que pulses Revelar. El Copiar URL de la pestaña Ajustes del motor copia siempre la URL completa.
  3. 3Escribir .env en el proyecto abierto pregunta «¿Escribir .env?» y, con Escribir, pone DATABASE_URL en el .env del proyecto: sustituye la primera DATABASE_URL que haya (quita las repetidas e ignora la comentada) y conserva el resto del fichero. Si el fichero o una carpeta .git existen, .env se añade a .gitignore.

No puedes, y por qué

  • Ni Revelar ni Copiar URL piden tu huella, aunque el bloqueo biométrico esté activo.Aún no
  • Con el motor parado no hay URL («El motor local está parado, así que no hay conexión que dar. Arráncalo y vuelve»), y sin proyecto abierto no hay dónde escribir («No hay ningún proyecto abierto, así que no hay dónde escribir un .env»).A propósito
  • No hay psql ni pgpass: la contraseña solo sale del motor por esta URL o por las variables de entorno.A propósito

Terminal y Node

Con el motor en marcha, la terminal local y los scripts de Node reciben DATABASE_URL, PGHOST, PGPORT, PGUSER, PGPASSWORD y PGDATABASE en su entorno. Con npm i pg en un proyecto, new Client() conecta sin configurar nada. La terminal trae además un snippet listo, Local PostgreSQL (Node).

Las variables se leen al abrir una sesión: abre una sesión nueva después de arrancar el motor. Las sesiones SSH no las reciben. La terminal no tiene psql ni pg_dump; las copias se hacen desde la herramienta Copias de seguridad.

Conexiones

Mis Conexiones (con el título Bases de datos) lista todo lo que el módulo puede abrir. Abrir y guardar conexiones funciona igual para todos los tipos; lo que hace cada tipo una vez abierto está en la tabla «Tipos de conexión».

La lista de conexiones

Ábrela desde Mis Conexiones en la pantalla de inicio o con Todas las conexiones en el selector del título.

Puedes

  • Ver tus conexiones por secciones: Favoritos, Bases de datos locales, Bases de datos en la nube y Conexiones personalizadas, cada una con su contador. Cada tarjeta lleva el logo del motor, el nombre, el host parcialmente oculto (••.••••.empresa.com:5432), el entorno en texto (PROD en rojo cuando el grupo o la etiqueta del color empieza por PROD) y un punto de estado.
  • Tocar una tarjeta para abrirla: el motor local y tus servidores abren sus tablas, las cuentas de proveedor abren sus proyectos, Redis y Firestore abren sus propios exploradores.
  • Pulsar + (Nueva conexión) para añadir un servidor.
  • Usar el ⋮ de una tarjeta: Editar conexión, Duplicar (añade « (Copy)» al nombre), Probar conexión, Añadir a favoritos / Quitar de favoritos y Eliminar («¿Eliminar la conexión …? No se puede deshacer»). Eliminar borra también la credencial guardada y, en una rama de PlanetScale abierta como MySQL, revoca su contraseña de rama en tu cuenta de PlanetScale.
  • Mantener tus conexiones en tu cuenta de PocketCode. Con Activar sincronización en el diálogo Sincronización de Configuración (Cloud Sync, función Pro) y Conexiones (SSH/DB) marcada, guardar o editar uno de tus servidores, abrir una rama de PlanetScale como MySQL y eliminar una conexión también actualizan tu cuenta. Solo viajan metadatos: nombre, host, puerto, motor y etiqueta de grupo; nunca el usuario, la contraseña, los ajustes TLS ni nada más de lo que la app guarda aparte. Con Cloud Sync apagado, o esa casilla sin marcar, no se envía nada. Las conexiones sin host tampoco se envían.

No puedes, y por qué

  • La conexión del motor local no se edita ni se borra: «La conexión al PostgreSQL local la gestiona la app: no se le pueden cambiar host, puerto ni usuario, ni se puede eliminar». Sí ofrece Duplicar, Probar conexión y favoritos.A propósito
  • En Free, guardar (o duplicar y guardar) una segunda conexión propia abre el muro Pro. No cuentan el motor local, las cuentas de proveedor ni las conexiones en memoria de Abrir en Database (Upstash, DigitalOcean). Abrir una rama de PlanetScale, y Abrir… y Pegar en Compartir, obedecen el mismo límite.Pro
Connections list with Local PostgreSQL first and cloud databases below
Conexiones — el motor local primero, luego tus cuentas en la nube

Nueva conexión y Editar conexión

El formulario para servidores y para los tipos de proveedor que quieras introducir a mano. Se abre con el tipo Neon PostgreSQL.

  1. 1En Mis Conexiones, pulsa + (Nueva conexión).
  2. 2Pega una URL en Connection String y pulsa Parsear Connection String. Entiende postgres://, postgresql://, mysql://, mariadb://, libsql://, turso://, redis://, rediss://, mongodb:// y mongodb+srv://, con o sin prefijo jdbc:; decodifica escapes como %40, hosts IPv6 y listas de réplicas de MongoDB. rediss, mongodb+srv y libsql activan TLS.
  3. 3O rellena Nombre de conexión, Tipo de BD, Host, Puerto, Base de datos (en Redis, el índice del SELECT), Usuario y Contraseña.
  4. 4En Apariencia, elige un Color (None, Production, Staging, Development, Testing, Custom, Local) y un Grupo.
  5. 5Configura SSL / TLS y, si lo necesitas, Túnel SSH (los dos, más abajo).
  6. 6Pulsa Probar conexión. El resultado se queda en pantalla en Última prueba, con la Respuesta del servidor y, si fue bien, la Latencia.
  7. 7Pulsa Guardar. La contraseña va al almacén cifrado de Android y el fichero de conexiones nunca la guarda. Al editar una conexión, deja Contraseña vacía para conservar la guardada.

Puedes

  • El selector Tipo de BD ofrece PostgreSQL (Local) (solo donde el motor viaja), PostgreSQL, MySQL / MariaDB, Neon PostgreSQL, Supabase, PlanetScale MySQL, MongoDB Atlas, Turso SQLite, Upstash Redis, Redis y MongoDB. Cloudflare D1 y Cloud Firestore no están en el selector: llegan por su cuenta.
  • Probar conexión prueba de verdad: el motor local con SELECT version(); PostgreSQL, MySQL y PlanetScale con la versión y la latencia («Connected — …»); Neon y Supabase listando proyectos («Connected — N projects»); MongoDB y Redis con un ping real, TLS y autenticación incluidos.

No puedes, y por qué

  • Turso, Upstash, Atlas y D1 no se pueden probar desde el formulario: «… aún no se puede probar desde la app (sin controlador)».Aún no
  • En Free, Guardar una segunda conexión abre el muro Pro.Pro

TLS

Usar TLS está en SSL / TLS. En PostgreSQL y MySQL / MariaDB, una vez activado, el formulario ofrece dos modos y empieza en Verificar servidor.

Puedes

  • Verificar servidor: el certificado del servidor se comprueba con las autoridades en las que confía tu móvil, así que un certificado de una CA pública funciona sin fichero. Si tu servidor usa un certificado propio, elige su CA con Elegir certificado CA… (el fichero se copia al almacén privado de la app).
  • Verificar Hostname (activado por defecto) comprueba además el nombre del host; desactivado, solo se comprueba la CA.
  • Solo cifrar (sin verificar): cifra el tráfico sin comprobar quién contesta. Un aviso en rojo dice que alguien en la misma red podría suplantar tu servidor; úsalo solo con un certificado autofirmado.

No puedes, y por qué

  • El formulario no ofrece Disable, Allow ni Prefer. Una conexión guardada con un modo antiguo enseña ese modo como una ficha suelta hasta que eliges otro.A propósito
  • En Redis y MongoDB, Usar TLS valida siempre el certificado: no hay opción de solo cifrar.A propósito

Túnel SSH

Túnel SSH → Usar túnel SSH llega a una base a través de un host de salto: Host SSH, Puerto SSH, Usuario SSH y una Password o una Private Key (Elegir clave privada…).

Puedes

  • El túnel reenvía un puerto local a la base tal como la ve el host de salto, así que el host y el puerto de la base que escribiste son los que alcanza el host de salto.
  • La primera vez que llegas a un host de salto la app muestra «Primera vez en este servidor. Huella: …» y la guarda. Si la clave cambia después, «La clave del servidor SSH ha cambiado. Conexión detenida: puede que el servidor se reinstalara, o que haya alguien en medio», y no se envía nada.

No puedes, y por qué

  • Solo PostgreSQL y MySQL / MariaDB usan el túnel. El interruptor se dibuja en el formulario de todos los tipos, pero en MongoDB, Redis, Neon y los demás no tiene efecto.Aún no
  • Las claves privadas con frase de paso no funcionan: el formulario no tiene campo para la frase.A propósito
  • No hay agente SSH en Android, y solo hay un reenvío de puerto local: sin saltos encadenados.A propósito

Tipos de conexión

Qué hace abrir cada tipo una vez conectado.

TipoQué pasa
Neon PostgreSQLElige un proyecto. El SQL va por JDBC con comprobación completa del certificado cuando la app puede leer la conexión del proyecto desde tu cuenta, y por la API HTTP de Neon en caso contrario («Sin conexión directa a este proyecto de Neon: va por su API HTTP. Las transacciones con varias sentencias y un EXPLAIN ANALYZE real no están disponibles por esa vía»). El SQL funciona en proyectos con la base neondb y el rol neondb_owner por defecto.
SupabaseElige un proyecto; el SQL va por la API en todos los esquemas (salen fichas de Esquema cuando hay más de uno). La API no da la contraseña de la base, así que Usar una conexión directa en la pantalla del proyecto abre el formulario con el host, el puerto y el usuario del pooler: escribe la contraseña una vez y guárdala como una conexión PostgreSQL normal.
PlanetScale MySQLTu cuenta lista bases y Ramas. Al tocar una rama se crea una contraseña de rama en tu cuenta de PlanetScale y la rama se abre como conexión MySQL con comprobación completa del certificado. En Free, una rama que aún no has abierto cuenta como una conexión propia: con una ya guardada, al tocarla se abre la ventana Base de Datos Pro y no se crea ninguna contraseña. Eliminar esa conexión revoca la contraseña; si revocarla falla, la app te dice que lo hagas en el panel de PlanetScale.
Turso SQLiteTu cuenta lista las bases; el SQL va por la API HTTP de Turso.
Cloudflare D1Tu cuenta lista las bases (D1 está siempre en la lista) y se abre directamente en sus tablas; el SQL va por la API de D1.
MongoDB AtlasTu cuenta lista clústeres. Al elegir uno se abre el formulario con el host SRV rellenado y tecleas el usuario y la contraseña de la base (Atlas no te los da). Un host mongodb+srv:// se resuelve con DNS sobre HTTPS contra dns.google y, si falla, cloudflare-dns.com.
Upstash RedisTu cuenta lista las bases; abrir una conecta como una base Redis real, o por REST cuando la API de Upstash no da contraseña de Redis. La conexión vive en memoria.
MongoDB, Redis, Cloud FirestoreSus exploradores y herramientas están en Herramientas de base de datos.

Tablas y datos

Toca una tabla para abrirla. Las páginas son de 100 filas y van ordenadas por la clave primaria, así que una fila editada no cambia de sitio.

La lista de tablas

Las tablas y vistas de la conexión abierta. Ábrela tocando una conexión, o desde Herramientas → Tablas.

Puedes

  • Buscar con Buscar tablas…. La lista tiene Tablas (cada una con «~N filas · tamaño», donde ~ marca un recuento estimado, y una insignia Sistema cuando corresponde) y Vistas; PlanetScale añade Ramas y Supabase, cuando hay más de un esquema, fichas de Esquema.
  • Tocar una tabla o vista para abrir sus datos. El ⋮ de una fila ofrece Datos, Estructura, Exportar y favoritos.
  • Pulsar + (Crear Tabla) para abrir el formulario de tabla.
  • El ⋮ de la lista tiene Importar CSV (abre la vista previa de importación, que acepta CSV, TSV, JSON, NDJSON, SQL y XLSX; mira Herramientas de base de datos) y, solo en el motor local, Importar desde Portapapeles y Diff de Esquema.

No puedes, y por qué

  • Crear Tabla se ofrece en el motor local, en servidores PostgreSQL y en servidores MySQL (y en ramas de PlanetScale abiertas); no en Neon, Supabase, Turso, D1 ni en la cuenta de PlanetScale. Ahí, ejecuta CREATE TABLE en la consola.A propósito
  • En Free, con 4 tablas en la conexión, Crear Tabla lleva una insignia Pro, y crear una quinta tabla (el formulario, importar con «Create table» o un CREATE TABLE en la consola) abre el muro Pro.Pro
  • MySQL / MariaDB no lista índices, claves ajenas ni disparadores («… no expone los índices»), y sus recuentos de filas son la estimación del catálogo.A propósito

El visor de datos

La cabecera muestra la tabla; el subtítulo, base · conexión. El recuento de filas se calcula una vez por tabla y conjunto de filtros.

Puedes

  • La barra superior tiene Filtro, Orden, Columnas, Vistas, un icono de actualizar, el rango (1-100 de 240, o Página N cuando no se conoce el total) y Anterior / Siguiente.
  • Toca la cabecera de una columna para ordenar; mantenla pulsada para Congelar columna / Descongelar columna, Ajustar anchos, Restablecer anchos y filas Compacta / Cómoda.
  • Mantén pulsada una celda: si no es de la clave primaria, la editas; si lo es, empiezas a seleccionar filas. Toca una fila para abrir Detalle de Fila.
  • El ⋮ de la cabecera tiene Insertar Fila, Añadir columna, Detalle de Tabla y Exportar.
  • Insertar Fila abre un formulario con un campo por columna, cada uno rotulado con su nombre, su tipo y PK si es clave. Deja un campo vacío y la columna toma su valor por defecto (o NULL, o su autoincremento). Preparar fila encola el INSERT (hay que rellenar al menos un campo, o la app lo avisa) y Aplicar lo ejecuta. También sirve en una tabla sin clave primaria.

No puedes, y por qué

  • Editar y borrar necesitan una clave primaria utilizable (y que ninguna fila la tenga a NULL); si no, la app no puede identificar las filas con seguridad y no aplica nada. Insertar Fila no la necesita.A propósito
  • La clave primaria no se edita celda a celda: una pulsación larga sobre ella selecciona la fila.A propósito
  • En Neon, Supabase, Turso y D1 con Solo lectura puesto, quedan bloqueados editar, borrar y Eliminar / Vaciar / Renombrar: «Esta base está en solo lectura, así que no se ha cambiado nada. Quita “Read-only” encima del editor de la consola SQL para hacer cambios».A propósito
  • Sin recuento total (Supabase, o un COUNT(*) que falla) la barra dice Página N y Siguiente solo avanza si la página vino llena.Terceros
The customers table with Filter, Sort, Columns and the page range
Una tabla — filtros, orden, columnas y páginas en una fila
Filter sheet with column, operator and value fields
Los filtros se aplican en el servidor, no solo en pantalla

Filtro

Un filtro recorta lo que devuelve la base, no solo lo que se ve: los filtros se combinan con AND y se aplican en el servidor como un WHERE.

Puedes

  • Elige Seleccionar Columna, un Operador (Cambiar) entre =, !=, >, <, >=, <=, LIKE, NOT LIKE, IS NULL, IS NOT NULL, IN y BETWEEN, escribe un Valor y pulsa Agregar Filtro.
  • La lista Activos tiene Quitar filtro, y Limpiar Todo la vacía. IN toma valores separados por comas; el valor se compara como texto entre comillas; IS NULL e IS NOT NULL no necesitan valor.

No puedes, y por qué

  • BETWEEN está en la lista de operadores pero la hoja tiene un solo campo de valor, sin Desde / Hasta: genera BETWEEN 'x' AND ''. Usa dos filtros, >= y <=.​Aún no

Columnas

Muestra, oculta y da formato a las columnas de esta tabla.

Puedes

  • Activa o desactiva cada columna, o pulsa Mostrar Todas.
  • Dale a una columna un Formato: Sin formato, Stars, Progress Bar, Boolean, Link o Color.
  • Una columna enmascarada por una regla (mira Herramientas de base de datos) muestra un candado; Ver en claro la revela durante la sesión, y pide tu huella cuando el bloqueo biométrico está activo.

No puedes, y por qué

—

Vistas guardadas

Vistas guarda una forma de mirar una tabla.

Puedes

  • Guardar la vista actual con un Nombre de la vista: guarda los filtros, el orden, las columnas visibles, los anchos y las columnas fijadas de esta conexión y tabla.
  • Aplica una vista con un toque (Todo, sin filtrar los quita) o Eliminarla.

No puedes, y por qué

  • Las vistas guardadas se quedan en este dispositivo y cuenta: Compartir exporta conexiones y consultas guardadas, no vistas.A propósito

Editar celdas y aplicar cambios

Las ediciones esperan en una cola hasta que las aplicas.

Puedes

  • Mantén pulsada una celda que no sea de la clave primaria, cambia el Valor o activa NULL, y pulsa Guardar. La celda se resalta y aparece abajo una barra con «N cambios».
  • Ver SQL enseña las sentencias exactas (UPDATE … SET col = valor WHERE <todas las columnas de la clave primaria>), Descartar las quita y Aplicar las ejecuta.

No puedes, y por qué

  • Aplicar ejecuta las sentencias una a una y se detiene en el primer error, sin transacción: «Aplicados %1$d de %2$d: …». Las anteriores al error quedan aplicadas.A propósito
  • El SQL pendiente no se puede editar, solo aplicar o descartar.A propósito

Detalle de fila

Toca una fila (cuando no hay selección activa). En una tablet en horizontal se abre como un panel junto a la rejilla en lugar de sustituirla.

Puedes

  • Leer la clave primaria de la fila (o «Fila N») y pulsar Copiar JSON para copiar todos los valores como texto o null.
  • Editar un campo por columna, cada uno con su tipo y con las marcas PK, FK, NOT NULL, un interruptor NULL en las columnas que lo admiten y una caja multilínea monoespaciada para JSON.
  • El pie dice «Sin cambios» o «N cambios»; Guardar encola solo los campos que has cambiado y los aplica.

No puedes, y por qué

  • No hay navegación a la fila anterior / siguiente ni borrado desde aquí; sin clave primaria utilizable no guarda.A propósito

Seleccionar filas

Mantén pulsada una celda de la columna de la clave primaria para empezar a seleccionar.

Puedes

  • Marca filas con las casillas; la barra dice «N seleccionadas» y tiene Limpiar.
  • Copiar Como copia las filas al portapapeles como CSV, TSV, JSON, NDJSON, SQL (INSERT), SQL (completo) o Markdown.
  • Exportar ofrece los mismos formatos más Excel (XLSX), escribe un fichero y abre la hoja de compartir del sistema.
  • Eliminar encola un DELETE … WHERE <clave primaria> por fila, pasa por el modo seguro y espera a Aplicar.

No puedes, y por qué

  • Exportar aquí comparte un fichero y no pregunta destino; para elegir carpeta, usa ⋮ → Exportar.​A propósito
Row detail form for id = 2 with typed fields and NULL switches
Detalle de fila — campos con su tipo y un NULL de verdad
Three selected rows with Copy As, Export and Delete in the bottom bar
Mantén pulsada la columna de la clave para seleccionar filas

Añadir una columna

⋮ → Añadir columna abre Nueva columna.

Puedes

  • Rellena Nombre, un tipo (los mismos 15 que en Crear Tabla), las fichas NN y UQ y un Valor por Defecto; una vista previa muestra nombre TIPO NOT NULL UNIQUE.
  • Pulsa Añadir columna para ejecutar ALTER TABLE … ADD COLUMN en el dialecto de la conexión.

No puedes, y por qué

  • En una tabla con filas, una columna NOT NULL necesita un valor por defecto; si no, el botón queda deshabilitado con «La tabla ya tiene N filas. Una columna NOT NULL necesita un valor por defecto: si no, el motor no tiene qué poner en ellas».A propósito
  • En este formulario no hay fichas PK ni AI, solo NN y UQ.​A propósito

Detalle de tabla

⋮ → Detalle de Tabla en el visor, o Estructura en una fila de la lista de tablas.

Puedes

  • Leer cinco pestañas: columnas (tipo, PK / FK / NOT NULL, Valor por Defecto, Referencia a), Índices, Claves (Clave primaria y Claves ajenas), Disparadores y DDL, con Copiar DDL.
  • Usar la Zona de Peligro: Renombrar, Vaciar y Eliminar Tabla. Cada una pide confirmación y pasa por el modo seguro. En motores SQLite (Turso, D1), vaciar ejecuta DELETE FROM.

No puedes, y por qué

  • Cuando un motor no expone índices, claves, disparadores o el DDL, la pestaña lo dice («Este motor no devuelve el DDL de una tabla») en vez de enseñar una lista vacía.A propósito
  • Desde aquí no se pueden editar índices, claves ni disparadores.A propósito
  • En bases de la nube, Solo lectura bloquea Eliminar, Vaciar y Renombrar.A propósito

Crear una tabla

Crear Tabla en la lista de tablas, o Herramientas → Tabla nueva.

Puedes

  • Escribe un Nombre de Tabla. Por cada columna pon un Nombre, un tipo (SMALLINT, INTEGER, BIGINT, REAL, DECIMAL(p,s), CHAR(n), VARCHAR(n), TEXT, BLOB, BOOLEAN, DATE, DATETIME, TIMESTAMP, JSON o UUID), las fichas PK, AI, NN y UQ y un Valor por Defecto. Añade y quita columnas libremente.
  • Pulsa Crear para ejecutar CREATE TABLE IF NOT EXISTS en el dialecto de la conexión (SERIAL / BIGSERIAL y BYTEA en PostgreSQL, AUTO_INCREMENT y CHAR(36) para UUID en MySQL). La lista se recarga.

No puedes, y por qué

  • El formulario no tiene claves ajenas, índices ni restricciones CHECK, solo marcas por columna.A propósito
  • En Free, con 4 tablas, Crear abre el muro Pro.Pro

Exportar una tabla

⋮ → Exportar, el ⋮ de una fila de la lista de tablas, Herramientas → Exportar (solo con una tabla abierta), o Exportar bajo los resultados de la consola.

Puedes

  • Elige un Formato (CSV, TSV, JSON, NDJSON, SQL (INSERT), SQL (completo), Markdown o Excel (XLSX)) y, si hay filtros, Filas: Filas filtradas (N) o Tabla entera.
  • Pulsa Guardar en… y elige dónde va. «N filas escritas» va contando. Una tabla se lee por lotes de 1 000 filas y se escribe fila a fila, así que no hay tope de tamaño.

No puedes, y por qué

  • Exportar un resultado de la consola escribe solo las filas que están en pantalla (500 como máximo) y no vuelve a ejecutar la consulta.A propósito
  • Una tabla sin clave primaria de una sola columna se lee con LIMIT/OFFSET, así que escribir durante la exportación puede desajustarla; una tabla sin clave primaria no tiene orden garantizado.A propósito

Consola SQL

Se abre desde Herramientas → Consola SQL. Sale para las conexiones que ejecutan SQL: el motor local, tus servidores PostgreSQL y MySQL, Neon, Supabase, ramas de PlanetScale abiertas, Turso y Cloudflare D1. Si hay una tabla abierta y el editor está vacío, empieza con SELECT * FROM <tabla> LIMIT 50.

El editor

Un solo editor para todos los dialectos.

Puedes

  • Números de línea y resaltado en el dialecto de la conexión (PostgreSQL, MySQL o SQLite). La autocorrección y las mayúsculas automáticas están desactivadas.
  • Deshacer, Rehacer, Formatear e IA en la barra; el menú ⋮ tiene Nueva Pestaña, Historial de Consultas, Consultas Guardadas, Parámetros de Query (solo cuando la consulta tiene parámetros) y Letra más pequeña / Letra más grande.
  • Las sugerencias salen como fichas desde el segundo carácter, diez como máximo: hasta 5 palabras clave, 5 tablas, 3 vistas, 5 columnas de la tabla abierta y 3 funciones.
  • Con el teclado abierto, encima aparece una fila de teclas: fx (alterna entre palabras y hasta 24 funciones del dialecto), los símbolos ( ) , ; = * ' " < > . :, once palabras (SELECT, FROM, WHERE, JOIN, ON, GROUP BY, ORDER BY, LIMIT, INSERT, UPDATE, DELETE) y Ejecutar fijo a la derecha.
  • La disposición se adapta: un conmutador Editor | Resultados en móvil vertical, dos columnas con divisor arrastrable (20–80 %, doble toque para 50/50) en móvil horizontal, filas de 30 / 50 / 70 % en tablet vertical, y columnas con tira de pestañas en tablet horizontal.

No puedes, y por qué

  • MongoDB, Redis, Upstash y Firestore no tienen consola SQL: su pantalla es la propia conexión, y la herramienta no se ofrece.A propósito

Ejecutar, parar y límites

Qué pasa cuando pulsas Ejecutar.

Puedes

  • Ejecutar lanza todo el editor (solo la selección con Ctrl+Shift+Enter). Mientras corre, Resultados dice «Ejecutando · N s» y Ejecutar pasa a Parar.
  • Un SELECT sencillo sin LIMIT recibe LIMIT 500 (no se añade a WITH …, a selects de COUNT / SUM / AVG / MIN / MAX, ni cuando el texto ya contiene LIMIT). Las conexiones remotas guardan 500 filas como máximo. Una consulta se corta a los 30 s en el motor local; en servidores remotos el socket espera 60 s (más 10 s para conectar).
  • Las sentencias que no devuelven filas dicen qué pasó: «Tabla creada · 53 ms», «3 filas afectadas · 8 ms», «Sentencia ejecutada · …».
  • Parar cancela la consulta en el servidor en el motor local, en tus servidores PostgreSQL y en MySQL: «Consulta cancelada en el servidor».
  • Cada ejecución va al historial (500 entradas) y al registro de auditoría (1 000), y recarga la lista de tablas si creó o borró algo.

No puedes, y por qué

  • En Neon, Supabase, Turso y D1, Parar solo deja de esperar: «Se deja de esperar la consulta. El servidor puede seguir ejecutándola».A propósito
  • Cada ejecución abre su propia conexión, así que BEGIN en una ejecución y COMMIT en la siguiente no forman una transacción.A propósito
SQL console with a formatted query joining customers and orders
Consola SQL — resaltado, Formatear e IA en la barra
Results: 12 rows with name and email columns and the result actions below
Resultados — filas, tiempo y qué hacer con ellos

Modo seguro

Antes de ejecutar una sentencia peligrosa, la consola muestra Operación Peligrosa («Esto ejecutará una operación … ») con el SQL exacto y las «Filas afectadas estimadas». No se ejecuta nada hasta que pulsas Ejecutar de Todos Modos; Cancelar lo deja.

Puedes

  • Salta con DELETE o UPDATE sin WHERE, DROP TABLE, DROP VIEW, DROP INDEX, un DELETE dentro de una CTE sin WHERE y cualquier texto con TRUNCATE.
  • En MySQL / MariaDB / PlanetScale la lista es más larga: DROP DATABASE, ALTER TABLE … DROP, RENAME TABLE, gestión de usuarios y privilegios (GRANT…), KILL, FLUSH, RESET, LOAD DATA, INTO OUTFILE, SET GLOBAL, SHUTDOWN, REPLACE INTO, plugins y LOAD_FILE().
  • Eliminar, Vaciar y Renombrar una tabla, borrar filas y eliminar una base desde la pantalla del motor pasan también por él.

No puedes, y por qué

  • El modo seguro no tiene interruptor: está siempre activo.A propósito

Parámetros

Los parámetros con nombre convierten una consulta en una plantilla.

  1. 1Escribe parámetros con nombre en la consulta: SELECT * FROM orders WHERE status = :status AND total > :min;
  2. 2Pulsa Ejecutar. En lugar de ejecutar, la consola abre Parámetros de Query con un campo por nombre.
  3. 3Rellena los valores y pulsa Ejecutar. Los valores se envían como texto entre comillas. El editor conserva la consulta con sus :nombres, y el historial también.

No puedes, y por qué

  • Solo :nombre pide un valor; @nombre y $1 se reconocen pero no preguntan. No hay tipos: todo va como texto.A propósito

Pestañas

Varias consultas a la vez.

Puedes

  • ⋮ → Nueva Pestaña (en una tablet en horizontal, el + de la tira). En un móvil la tira aparece con dos o más pestañas.
  • Toca una pestaña para cambiar, ✕ para cerrar, mantenla pulsada para renombrar. Cada pestaña guarda su SQL y su resultado, y las pestañas sobreviven a cerrar la app. Siempre queda al menos una.

No puedes, y por qué

  • En Free, la tercera pestaña abre el muro Pro.Pro

Qué hacer con los resultados

Bajo la rejilla de resultados hay una fila de acciones, y un icono en la cabecera.

AcciónQué hace
Copiar ComoCSV, TSV, JSON, NDJSON, SQL (INSERT), SQL (completo) o Markdown, al portapapeles. Los identificadores se citan como espera el motor de la conexión (sin comillas invertidas en PostgreSQL).
ExportarAbre Exportar con las filas que están en pantalla.
GráficosUn gráfico a partir del resultado (necesita dos o más columnas). En Herramientas de base de datos.
ExplicarAbre el plan de ejecución de la consulta del editor.
Guardar ConsultaLa guarda con un Nombre de Consulta.
Añadir al panel (icono de la cabecera)Guarda la consulta como widget de un panel una vez ejecutada. En Herramientas de base de datos.

No puedes, y por qué

  • En Free, Guardar Consulta abre el muro Pro cuando ya tienes 5 consultas guardadas.Pro

Historial y consultas guardadas

⋮ → Historial de Consultas o Consultas Guardadas abre una hoja en la consola.

Puedes

  • Elige una entrada para cargarla en el editor.
  • Guarda la consulta con un Nombre de Consulta, Eliminar entradas y mueve las consultas guardadas a carpetas (Sin carpeta).

No puedes, y por qué

  • 5 consultas guardadas en Free; la sexta abre el muro Pro.Pro
  • El historial guarda las últimas 500 entradas.A propósito

Escribir SQL con IA

El asistente vive dentro del editor, encima de tu código. Escribe una propuesta; nada llega al editor hasta que la aceptas, y nada se ejecuta solo.

Puedes

  • Pulsa IA. Se abre una línea con Describe la consulta que necesitas… encima del código; describe la consulta con tus palabras y pulsa Generar. Atajo: escribe la petición como comentario en la línea del cursor, por ejemplo -- clientes que han pedido este mes, y pulsa IA.
  • Lee la propuesta. Encima aparece su origen (el proveedor y el modelo, o Sin conexión — generado por reglas, no por un modelo), la Explicación y flechas para moverte entre alternativas; Regenerar vuelve a pedirla.
  • Aceptar la pone en el editor, sustituyendo la selección o en una línea nueva bajo el cursor. Descartar deja el editor como estaba. Una propuesta destructiva lleva el aviso «Destructive operation — review carefully».

No puedes, y por qué

  • Sin proveedor conectado el asistente recurre a un generador por reglas para consultas sencillas y dice por qué: «No hay ningún proveedor de IA conectado. Conecta uno en los ajustes de IA para que la consulta la escriba un modelo». Si el proveedor tarda más de 90 segundos: «El proveedor de IA no contestó en 90 segundos, así que no se ha usado ningún modelo».Requiere red
  • Si el modelo responde algo que no es SQL ves su respuesta bajo «El modelo no devolvió SQL», sin botón Aceptar.​A propósito
  • Qué sabe: el dialecto y los nombres de hasta 40 tablas y vistas con sus columnas (6 000 caracteres como máximo), así que escribe ciudad si la columna se llama ciudad. No se envían filas.
  • Qué modelo: el que tengas para Asistente SQL en los ajustes de IA, tu elección manual, o un modelo rápido en modo Automático.
  • Consentimiento: la primera vez que se usa un proveedor, la app pregunta ¿Enviar a …? antes de enviar nada.

Bases de la nube: Solo lectura, confirmación y huella

En Neon, Supabase, Turso y Cloudflare D1 la consola pregunta antes de escribir. Una fila fija sobre el editor lleva el interruptor Solo lectura («Las escrituras están bloqueadas» / «Las escrituras preguntan antes»).

Puedes

  • Solo lectura viene puesto por defecto, por base (cambiar de proyecto lo vuelve a poner): solo se mandan lecturas. Ejecutar una escritura dice «“Solo lectura” está activado, así que esta escritura no se ha enviado. Desactívalo encima del editor para ejecutarla».
  • Con él quitado, cada escritura abre «¿Escribir en …?» con lo que hará (crea una tabla, borra una tabla, vacía una tabla, inserta filas, actualiza las filas que cumplen la condición, actualiza todas las filas (sin WHERE)…); Ejecutar confirma.
  • Una escritura destructiva (DROP, TRUNCATE, DELETE o UPDATE sin WHERE…) se titula «Escritura destructiva en …», su botón es Continuar y después pide tu huella o el PIN del dispositivo («Confirma la escritura destructiva»). Un móvil sin bloqueo de pantalla sigue con la confirmación ya dada.
  • El mismo interruptor gobierna las ediciones de la rejilla, Eliminar / Vaciar / Renombrar y el plan medido de una escritura.

No puedes, y por qué

  • El chat de IA respeta el interruptor y no puede ejecutar escrituras destructivas en una base de la nube: te da el SQL para que lo ejecutes desde la consola SQL.A propósito

Plan de ejecución

Herramientas → Plan de ejecución, o Explicar bajo los resultados. Necesita una consulta en el editor: «Escribe antes una consulta: el plan explica cómo se ejecutaría».

Puedes

  • Ver el plan como árbol con una barra de coste por paso y el más caro en rojo, con la etiqueta «Estimado por el planificador — la consulta no se ejecutó» o «Medido — la consulta se ejecutó de verdad», y «Planning: N ms» y «Execution: N ms». Toca un paso para ver el Detalle del paso (paso, tabla, coste total, coste propio, filas, ancho de fila). El icono de actualizar vuelve a pedirlo conservando si era medido.
  • Pulsar Analizar de verdad («Ejecuta la consulta y mide cada paso en vez de estimarlo») en el dialecto PostgreSQL: el motor local, Neon, Supabase y tus servidores PostgreSQL. Si la sentencia no es de solo lectura, pregunta antes «¿Ejecutar esta sentencia?»: «No es una sentencia de solo lectura, y medirla significa ejecutarla: va a cambiar tus datos».
  • Leer los Índices sugeridos cuando hay un recorrido secuencial con filtro sobre al menos 100 filas estimadas (el mínimo no se aplica si el motor no da estimación); cada uno tiene Copiar. «Aquí no se crea nada: copia la sentencia y decide en la consola».
  • Pulsar Explicar con IA para que tu modelo explique el plan. Envía el motor, la consulta y el plan, y dice «Lo escribió … a partir del JSON del plan. Compruébalo antes de actuar». La primera vez por proveedor pregunta ¿Enviar a …?

No puedes, y por qué

  • MySQL / MariaDB / PlanetScale dan solo un plan estimado, y SQLite (Turso, D1) un árbol sin costes («Este motor no publica costes: dice qué hace, no cuánto cuesta»). Analizar de verdad no se dibuja ahí.A propósito
  • En una base de la nube, Analizar de verdad sobre una escritura obedece a Solo lectura y pide tu huella si destruye datos.A propósito
  • En un proyecto de Neon al que se llega por HTTP no hay EXPLAIN ANALYZE real.Terceros
  • Nunca crea un índice; solo copia el CREATE INDEX.​A propósito
Measured execution plan tree with an index suggestion
Plan de ejecución medido: el paso en rojo es el caro

Esquema: árbol, ER, diseñador y comparar

Tablas, relaciones y diseño. El árbol, el diagrama ER, la importación y la comparación funcionan con cualquier conexión que ejecute SQL y tenga tablas.

Árbol de esquema

Herramientas → Árbol de esquema. En una tablet en horizontal, el mismo árbol cuelga de la conexión activa en el panel lateral.

Puedes

  • Desplegar el nombre de la conexión, luego Tables (N) y cada tabla: sus columnas (nombre: tipo, con PK en la clave) y, donde se listan, sus índices (nombre (columnas)); Views (N) contiene las vistas. Una tabla dice «(N rows)» cuando se conoce el recuento. Las etiquetas de este árbol salen en inglés en todos los idiomas.
  • Tocar una tabla o una columna para abrir los datos de esa tabla.
  • Los índices se listan en PostgreSQL, Neon, Supabase, Turso y D1; no en MySQL / MariaDB.

No puedes, y por qué

  • La pantalla dibuja además secciones de Funciones / Procedimientos, Secuencias, Enums / Tipos personalizados y Dependencias, pero nunca se llenan.Aún no
  • Los disparadores se dejan fuera del árbol a propósito.A propósito

Diagrama ER

Herramientas → Diagrama ER. Dibuja las tablas y relaciones de cualquier conexión SQL con tablas: el motor local y tus servidores PostgreSQL y MySQL por sus drivers, y Neon, Supabase, Turso y D1 leyendo su catálogo con SQL.

Puedes

  • Pellizca y arrastra el lienzo. La cabecera dice «N tablas · M relaciones»; con poco zoom, «Columnas ocultas: acerca para leerlas». Toca una tabla para abrir sus datos.
  • Usa la barra de herramientas: Editar como diseño (copia el esquema al diseñador), Seleccionar Tablas (Seleccionar todo / Limpiar; sin selección significa todas), Ajustar a pantalla, Auto-ordenar, acercar y alejar, Color por Schema, Minimapa y Exportar Diagrama (un PNG a 2× con el fondo del tema; el selector de ficheros propone er-diagram.png).

No puedes, y por qué

  • MongoDB, Redis, Upstash y Firestore no tienen diagrama ER, y nunca recurre al almacenamiento propio de PocketCode.A propósito
  • Las claves ajenas compuestas se dibujan como varias relaciones de una sola columna.Aún no
  • El diagrama no se puede editar en sitio: usa Editar como diseño.​A propósito
ER diagram with customers, orders and subscribers
Diagrama ER de la base local

Diseñador de esquema

Desde la pantalla de inicio (Diseñador de Esquemas, no necesita conexión) o Herramientas → Diseñador de esquema. Los proyectos son ficheros JSON en el almacén privado de la app.

Puedes

  • La lista de proyectos tiene Buscar esquemas…, tarjetas con «N tablas» y «N relaciones», un ⋮ con Duplicar y Eliminar, y Nuevo esquema.
  • El asistente Nuevo proyecto de esquema tiene tres pasos: Datos del proyecto (Nombre del proyecto, descripción), Base de datos destino (MySQL, PostgreSQL, SQLite, MariaDB, SQL Server o MongoDB) y Empezar desde plantilla: Esquema vacío o Blog (6 tablas), E-Commerce (8), Social Network (7), SaaS Platform (7), Chat App (5) o Project Management (7). Atrás, Continuar, Crear proyecto.
  • En el editor, arrastra tablas, Ajustar al zoom, Añadir tabla, Deshacer / Rehacer, y dibuja una relación tocando una columna origen y luego la tabla destino (1:1, 1:N, N:M; No Action, Cascade, Set Null, Set Default o Restrict). El nombre del proyecto se edita y una ficha muestra el motor destino.
  • La hoja del editor de tabla renombra la tabla, le pone color y añade columnas: nombre, un tipo (Selecciona tipo de columna, con sugerencias y aviso de palabra reservada), Restricciones (Clave primaria, Auto-incr., No nulo, Único, Indexado), Longitud, Precisión, Escala, Valor por Defecto, Comentario y Añadir FK.
  • Aplicar a … abre la consola con el script, sin ejecutarlo, con cada sentencia destructiva marcada con -- ⚠: «Script abierto en la consola: N sentencia(s), M marcadas con ⚠. No se ha ejecutado nada».

No puedes, y por qué

  • Aplicar a … nunca ejecuta el script: es la operación más destructiva del módulo, así que pasa por el modo seguro de la consola y por el tope de tablas del plan. Necesita una conexión SQL («Abre una conexión SQL para aplicar este diseño») y al menos una tabla.A propósito
  • El diseñador no tiene puerta Pro propia, pero en Free los CREATE TABLE del script chocan con el tope de 4 tablas cuando los ejecutas en la consola.Pro
  • Los proyectos se quedan en este dispositivo: no se sincronizan entre dispositivos, y el destino MongoDB solo adapta los tipos de columna.A propósito

Exportar esquema

Exportar en el editor de esquema abre Exportar Esquema.

Puedes

  • Elige uno de siete formatos: SQL DDL, Room Entity, Prisma, TypeORM, Django, JSON Schema o DBML, y pulsa Generar ….
  • Lee la Salida generada («N líneas»), y después Copiar todo («¡Copiado!») o Compartirla como texto.

No puedes, y por qué

  • Solo genera texto y no toca ninguna base: usa Aplicar a … para tener un script en la consola.A propósito

Importar esquema

Herramientas → Importar esquema (conexión SQL con al menos una tabla), o Editar como diseño en el diagrama ER.

Puedes

  • Trae al diseñador las tablas, columnas, índices y claves ajenas de la base abierta. Después lista lo que no se pudo importar («N cosa(s) no se pudieron importar»).

No puedes, y por qué

  • Los motores sin SQL no tienen esquema que importar («… no habla SQL, así que no tiene esquema que importar»).A propósito
  • En SQLite (Turso, D1) no se importan los índices, y las claves ajenas compuestas llegan como varias de una sola columna.Aún no

Comparar esquemas

Herramientas → Comparar esquemas, o el ⋮ de la lista de tablas → Diff de Esquema (motor local). Es una herramienta Pro. En un proyecto de PlanetScale la misma entrada enseña el diff del último deploy request y es gratis (mira Herramientas de base de datos).

Puedes

  • Pulsa Guardar Snapshot (guarda el esquema de esta conexión: «Instantánea del esquema guardada (N tablas)»), cambia el esquema y pulsa Ejecutar Diff.
  • Lee Tablas Añadidas, Tablas Eliminadas y Tablas Modificadas (+ nombre: tipo y − nombre para las columnas).
  • Pulsa Generar Migración para escribir el SQL en la consola sin ejecutarlo, citado según el motor, con un CREATE TABLE completo para las tablas nuevas y los cambios de tipo y de nulabilidad.

No puedes, y por qué

  • En Free, abrirlo desde Herramientas o el menú, o pulsar Ejecutar Diff, abre el muro Pro.Pro
  • Compara tablas y columnas (nombre, tipo, nulabilidad), no índices, claves ajenas, vistas ni secuencias.A propósito
  • La pantalla lista solo las columnas añadidas y quitadas; una columna cuyo tipo o nulabilidad cambió no se enseña ahí, aunque sí está en la migración.Aún no

Copias de seguridad

Herramientas → Copias de seguridad (con el título Backup y Restauración) se ofrece en todas las conexiones, pero solo se puede copiar el PostgreSQL local. Tiene tres pestañas: Crear, Historial y Programar.

Crear

Una copia se escribe en el almacenamiento de la app; Tus ficheros mueve copias hacia dentro y hacia fuera.

Puedes

  • Elige el Método de Backup (pg_dump o SQL Dump), añade una Nota (opcional) y pulsa Iniciar Backup («Se escribe en …»).
  • En Tus ficheros, Guardar en… escribe una copia directamente en un documento que eliges, e Importar copia… trae un .sql o un fichero pg_dump -Fc: el método se deduce de la firma PGDMP, no de la extensión. Guardar e importar pasan por el selector de ficheros del sistema, así que el fichero acaba donde tú digas y sobrevive a desinstalar la aplicación.

No puedes, y por qué

  • Las demás conexiones dicen por qué: «<motor> runs on a server, so its backups belong to that provider. PocketCode can only back up databases stored on this device.» o «<motor> is not a SQL database — export its collections/keys instead.» (estos avisos salen en inglés).A propósito
  • No hay destinos en la nube (Drive, Firebase): la carpeta de copias es privada de la app, y solo lo que escribe Guardar en… o Exportar fuera de ella sobrevive a una desinstalación.A propósito

Historial y restaurar

Todas las copias, la más reciente primero.

Puedes

  • Cada fila muestra la fecha, el método, «N tablas · tamaño» y las insignias Importada y Programada, con Restaurar, Exportar y Eliminar. Sin copias dice «Sin backups aún»; tras una ejecución programada fallida, «La última copia falló».
  • Restaurar pregunta «¿Sobrescribir la base de datos?». Antes se guarda una copia de la base actual (pre_restore_<hora>.dump), así que se puede deshacer; el resultado dice «Restaurada — … La base anterior queda como …». Un volcado PGDMP se restaura con pg_restore; un volcado de texto se reproduce por JDBC.

No puedes, y por qué

  • Si falla esa copia previa, no se restaura nada.A propósito
Backup History tab with a pg_dump backup and restore, export and delete buttons
Copias — restaurar guarda antes una copia de seguridad

Programar

Un interruptor Pro para copias automáticas.

Puedes

  • Activa Copias programadas y fija la Frecuencia (Every hour, Every 6 hours, Every 12 hours, Daily o Weekly), la Hora del día (las 3 por defecto) y el Máximo de backups a mantener (7 por defecto). Se ejecuta en segundo plano con WorkManager y se omite si queda poca batería o poco espacio.

No puedes, y por qué

  • Activar la programación o cambiarla es Pro (SCHEDULED_BACKUP). Crear, restaurar, exportar, importar y eliminar copias es gratis.Pro
  • No hay servicio en primer plano ni alarma exacta: el sistema puede posponer o matar la ejecución, y el resultado queda registrado en el historial.Google Play
  • Una ejecución programada copia el PostgreSQL local (la última base que abriste) solo si el motor está en marcha en ese momento; nunca lo arranca. Además copia siempre la base interna de PocketCode, en un almacén aparte cuyo historial esta pantalla no enseña.A propósito

Herramientas

El icono de rejilla abre Herramientas: 25 herramientas en seis secciones, con un buscador y una fila Frecuentes. En una tablet en horizontal es un riel permanente (280 dp, plegado a 72 dp). Lo que no aplica a la conexión abierta se oculta, no se deshabilita: con MongoDB, Redis, Upstash o Firestore solo salen nueve herramientas (Tablas, Paneles, Diseñador de esquema, Exportar, Copias de seguridad, Monitor, Seguridad, Registro de auditoría y Compartir).

SecciónHerramientas
ExplorarTablas, Árbol de esquema, Diagrama ER — en esta página.
ConsultarConsola SQL y Plan de ejecución — en esta página. Historial de consultas, Consultas guardadas, Gráficas y Paneles — en Herramientas de base de datos.
DiseñarDiseñador de esquema, Tabla nueva, Comparar esquemas (Pro) e Importar esquema — en esta página.
DatosExportar y Copias de seguridad — en esta página. Datos de prueba e Importar — en Herramientas de base de datos.
ServidorAjustes del motor, Extensiones, Registro del servidor y Base de datos nueva (insignia Pro en Free) — en esta página. Monitor — en Herramientas de base de datos.
SeguridadSeguridad, Registro de auditoría y Compartir — en Herramientas de base de datos.

Arrancar y Parar el motor no están en el catálogo: viven en la tarjeta del motor y en la pantalla del motor.

Monitorización, seguridad, auditoría, paneles, gráficas, datos de prueba, importación, historial, consultas guardadas y compartir se explican en Herramientas de base de datos.

Desde el chat de IA

El chat de IA puede usar tus bases de datos sin que el módulo esté abierto. Pídeselo con tus palabras («¿qué tablas tengo?», «¿cuántos pedidos se devolvieron?») y llama a estas herramientas:

HerramientaQué hace
db_list_connectionsLista el motor local y tus conexiones guardadas, y los proyectos de los servicios en la nube que conectaste como servicio/proyecto.
db_list_tablesNombres de las tablas de una base.
db_schemaColumnas y tipos de una tabla o de todas.
db_queryEjecuta una sentencia de solo lectura: SELECT, WITH, EXPLAIN, SHOW o DESCRIBE. Lo que escribe se rechaza.
db_executeEjecuta una sentencia que cambia datos o esquema. Pide tu aprobación antes, salvo que el chat esté en Acceso total y Preguntar antes de actuar fuera del dispositivo esté desactivado.
  • Las herramientas actúan sobre la última conexión que abriste, o sobre el motor local si no tienes nada más configurado. El modelo puede nombrar otra conexión de la lista.
  • En una base de la nube el chat respeta el interruptor Solo lectura de la consola y no ejecuta escrituras destructivas: te da el SQL para que lo ejecutes desde la consola SQL.
  • Los resultados que recibe el modelo son filas reales (200 como máximo en SQL). Las reglas de enmascarado no se aplican al chat. Una sexta herramienta de solo lectura, db_inspect, lee políticas, salud del esquema y SQL guardado: mira Herramientas de base de datos.

Gratis y Pro

Todo lo de esta página está en el plan gratuito, con estos límites (Pro los quita):

LímiteFreePro
Conexiones propias guardadas1 (no cuentan el motor local, las cuentas de proveedor ni las conexiones en memoria de Abrir en Database; sí cuentan las que añaden Abrir… o Pegar en Compartir y las ramas de PlanetScale abiertas)Ilimitadas
Consultas guardadas5Ilimitadas
Pestañas de la consola2Ilimitadas
Bases en el motor local1 (postgres)Ilimitadas
Tablas por conexión4 (cualquier motor; cuenta crear, importar o ejecutar CREATE TABLE)Ilimitadas
Comparar esquemas (SCHEMA_DIFF)Abre el muro ProIncluido
Copias programadas (SCHEDULED_BACKUP)Abre el muro Pro. Crear, restaurar, exportar e importar copias es gratis.Incluido
Todos los límites de arriba abren el mismo muro, titulado Base de Datos Pro, sea cual sea el que alcances. Dice «Desbloquea más bases de datos, tablas y consultas guardadas, comparación de esquemas y copias programadas.», enumera Más bases de datos, tablas y consultas guardadas, Comparación de esquemas (Schema Diff) y Backups programados automáticos, y tiene Seguir con plan básico, que lo cierra, y Desbloquear DB Pro, que abre el paywall. Los paneles son gratis: no tienen límite.

El resto no tiene límite de plan: el túnel SSH, todos los formatos de importación y exportación, el diagrama ER, los planes de ejecución (incluido Analizar de verdad), las funciones de IA, escribir en tus bases de la nube, las copias manuales y la restauración, la pantalla del motor, la monitorización, la seguridad, la auditoría y los paneles.

Los precios y la matriz completa Free / Pro están en Planes y precios.

Atajos de teclado

Solo con teclado físico, en una tablet en horizontal, dentro de la consola:

TeclasAcción
Ctrl+EnterEjecutar
Ctrl+Shift+EnterEjecutar la selección
Ctrl+T / Ctrl+WNueva pestaña / cerrar pestaña
Ctrl+SGuardar consulta
Ctrl+/Comentar o descomentar las líneas seleccionadas

Privacidad y seguridad

  • Sin servidor de PocketCode: los datos van de la app al motor local, a tu host (o a su host SSH de salto) o a la API del proveedor. Dos detalles: el nombre de un clúster mongodb+srv:// se resuelve con DNS sobre HTTPS contra dns.google (y después cloudflare-dns.com), y las funciones de IA llaman al proveedor que elegiste. Tus datos nunca pasan por un servidor de PocketCode. Solo con Cloud Sync activado y Conexiones (SSH/DB) marcada viajan a tu cuenta de PocketCode los metadatos de tus conexiones (nombre, host, puerto, motor y grupo; nunca usuario, contraseña ni TLS).
  • Dónde vive cada cosa: conexiones, consultas guardadas y carpetas, historial (500), registro de auditoría (1 000), pestañas de la consola, vistas guardadas, instantáneas de esquema, huellas de hosts SSH y favoritos son ficheros JSON en el almacén privado de la app, un conjunto por cuenta. Los proyectos de esquema son ficheros aparte en el mismo almacén privado.
  • Las contraseñas se guardan en el almacén cifrado de Android, por cuenta. El fichero de conexiones guarda host, puerto, base y usuario, nunca la contraseña. La app tiene desactivada la copia en la nube de Android.
  • El motor local solo acepta TCP desde el propio móvil y siempre con contraseña (SCRAM-SHA-256). Su contraseña es aleatoria y se guarda cifrada; sin ella el motor no arranca. El socket Unix está dentro del directorio privado de la app.
  • IA: no se envía nada a un proveedor antes de aceptar su diálogo de consentimiento. El asistente SQL envía el dialecto y los nombres de tablas y columnas (sin filas); la explicación del plan envía la consulta y su plan; las herramientas del chat envían las filas que leen.
  • Analítica, cuando está activada: el módulo informa del tipo de motor, cuánto tardó una consulta y cuántas filas devolvió, el formato y el número de filas de una exportación y una categoría de error. Nunca el SQL, nombres ni valores.
  • El enmascarado y el bloqueo biométrico se explican en Herramientas de base de datos.

Limitaciones

Lo que no funciona, y por qué, para que no te pille por sorpresa:

  • El motor local necesita un móvil ARM de 64 bits. No viene en compilaciones x86 (emuladores, Chromebooks x86).Dispositivo
  • MariaDB local no viene incluido: el código existe pero no viaja ningún paquete de MariaDB, así que nunca se ofrece.Aún no
  • El motor no se mantiene vivo en segundo plano; Android puede pararlo, y las copias programadas son tareas de WorkManager que el sistema puede posponer.Google Play
  • Sin psql ni pg_isready en la app (su librería readline es GPL-3).A propósito
  • Scripts: la consola envía todo el editor de una vez, y cada ejecución usa su propia conexión, así que BEGIN en una ejecución y COMMIT en la siguiente no forman una transacción.A propósito
  • Las ediciones en la rejilla se aplican sentencia a sentencia. Si una falla, las anteriores quedan aplicadas.A propósito
  • MySQL / MariaDB: sin listas de índices, claves ajenas ni disparadores, recuentos de filas estimados, autenticación con mysql_native_password y caching_sha2_password (el camino completo del segundo, solo con TLS), no ed25519, y nunca LOAD DATA LOCAL INFILE.​A propósito
  • Túnel SSH: solo reenvío de puerto local, solo PostgreSQL y MySQL / MariaDB, sin agente, sin saltos encadenados, sin clave con frase de paso.A propósito
  • El interruptor SSH se dibuja en el formulario de todos los tipos pero no hace nada fuera de PostgreSQL y MySQL / MariaDB.Aún no
  • Neon: el SQL por la cuenta funciona en proyectos con la base neondb y el rol neondb_owner por defecto.Terceros
  • Supabase: su API no da la contraseña de la base, así que una conexión PostgreSQL real necesita Usar una conexión directa y la contraseña una vez.Terceros
  • Las cuentas de proveedor necesitan red y el servicio conectado en Ajustes → Integraciones → Servicios conectados (o desde el Backend Manager). Un host mongodb+srv:// necesita además DNS sobre HTTPS.Requiere red
  • Diagrama ER, consola y planes no existen para MongoDB, Redis, Upstash ni Firestore.A propósito
  • Los planes medidos (Analizar de verdad) son solo del dialecto PostgreSQL; los planes de MySQL son estimaciones y los de SQLite no traen costes.A propósito
  • Las copias cubren solo el PostgreSQL local. Tus servidores y bases en la nube guardan sus copias en su proveedor.A propósito
  • El modo seguro no tiene interruptor: está siempre activo.A propósito
  • Operadores del filtro: BETWEEN tiene un solo campo de valor.Aún no
  • Buscar objetos en el menú ⋮ de la lista de tablas todavía no enseña resultados.Aún no
  • El árbol de esquema dibuja secciones de Funciones, Secuencias, Enums y Dependencias que se quedan vacías.Aún no
  • Usar en el proyecto: Revelar y Copiar URL no piden la huella aunque el bloqueo biométrico esté activo.Aún no
  • Algunos textos salen en inglés en todos los idiomas: Running / Stopped en la tarjeta del motor y los pasos del primer arranque («Preparing…», «Extracting…», «Setting up…», «Installing database…», «Verifying…», «Ready»).Aún no

Problemas frecuentes

Los títulos son los mensajes que enseña la app.

«PostgreSQL no viene en esta compilación para tu dispositivo»

El móvil no es ARM de 64 bits, así que el motor local no puede correr. Todo lo demás del módulo funciona.

«Motor parado» y «Arranca el motor PostgreSQL local para trabajar con sus tablas»

El motor está apagado. Pulsa Arrancar en esa pantalla, o en la tarjeta del motor de la pantalla de inicio.

La tarjeta del motor dice Stopped al volver

Android paró la app en segundo plano. Pulsa Arrancar; PostgreSQL se recupera solo si estaba escribiendo. Con Durabilidad activada, en el peor caso pueden faltar los últimos milisegundos de transacciones confirmadas.

echo $DATABASE_URL no imprime nada en la terminal

Arranca el motor y abre una sesión de terminal nueva. Una sesión abierta antes de arrancar el motor no ve las variables, y las sesiones SSH nunca las ven.

«El motor local está parado, así que no hay conexión que dar. Arráncalo y vuelve»

Usar en el proyecto necesita el motor en marcha. Arráncalo y vuelve a abrir la hoja.

«… aún no se puede probar desde la app (sin controlador)»

Probar conexión no tiene prueba para Turso, Upstash, Atlas ni Cloudflare D1. Abre la cuenta en su lugar: si la conexión está mal, lo verás ahí.

«La clave del servidor SSH ha cambiado. Conexión detenida…»

La huella del host de salto no coincide con la guardada la primera vez. Si reinstalaste el servidor es lo esperado; si no, puede que haya alguien en medio, así que no continúes.

Probar conexión falla en un servidor PostgreSQL con TLS

Verificar servidor comprueba el certificado con las autoridades en las que confía tu móvil. Si tu servidor usa un certificado propio, elige su CA con Elegir certificado CA…. Con Solo cifrar (sin verificar) la conexión va cifrada sin comprobar el certificado, y la pantalla te avisa.

«Aplicados %1$d de %2$d: …»

Una edición de la cola falló. Las anteriores quedan aplicadas (no hay transacción). Lee el error, corrígelo y aplica el resto de nuevo.

«La tabla ya tiene N filas. Una columna NOT NULL necesita un valor por defecto…»

Añadir columna queda deshabilitado hasta que das un Valor por Defecto a la columna NOT NULL: las filas existentes necesitan algo que guardar.

«No se pudieron aplicar los cambios: la tabla no tiene clave primaria utilizable…»

Este mensaje sale siempre en español. Significa que la tabla no tiene clave primaria utilizable (o que una fila la tiene a NULL), así que la app no puede identificar las filas con seguridad y no aplica nada.

«Solo lectura» está activado, así que esta escritura no se ha enviado. Desactívalo encima del editor para ejecutarla.

Estás en una base de Neon, Supabase, Turso o D1. Desactiva Solo lectura encima del editor y ejecuta de nuevo; te pedirá confirmar y, en las escrituras destructivas, tu huella.

Sale Operación Peligrosa en una consulta de la que me fío

El modo seguro mira el texto, no tu intención. Lee el SQL del diálogo y pulsa Ejecutar de Todos Modos.

«No hay ningún proveedor de IA conectado. Conecta uno en los ajustes de IA para que la consulta la escriba un modelo.»

La propuesta dice Sin conexión — generado por reglas, no por un modelo. Conecta un proveedor en los ajustes de IA (o elige un modelo para Asistente SQL) y pulsa Regenerar.

«El modelo no devolvió SQL»

El modelo respondió con un texto que no es SQL, así que no hay Aceptar. Lee su respuesta, elige otro modelo o reformula, y pulsa Regenerar.

«Escribe antes una consulta: el plan explica cómo se ejecutaría.»

Plan de ejecución necesita una consulta en el editor de la consola. Escribe una y abre el plan o pulsa Explicar.

«pg_stat_statements no está activo, así que no hay nada medido que enseñar.»

Activa Estadísticas de sentencias en los Ajustes del motor y guarda (reinicia el motor); después pulsa Activar en Salud.

«<motor> runs on a server, so its backups belong to that provider.»

Solo el PostgreSQL local se puede copiar desde el móvil. Para un servidor o una base en la nube usa las copias de su proveedor, o exporta sus tablas.

«La base “postgres” es la de mantenimiento del motor y no se puede eliminar.»

Eliminar base nunca se aplica a postgres ni a la base a la que estás conectado. Cambia antes a otra base, si la que quieres borrar es otra.

«Se deja de esperar la consulta. El servidor puede seguir ejecutándola.»

En Neon, Supabase, Turso y D1 Parar no puede cancelar una consulta en el servidor; solo deja de esperar. Revisa el proveedor si era pesada.

Sale un muro Base de Datos Pro al añadir una conexión, una pestaña, una tabla o una consulta guardada

Free permite 1 conexión, 5 consultas guardadas, 2 pestañas de consola, 1 base local y 4 tablas por conexión. El muro es el mismo para todas; Abrir una rama de PlanetScale, y Abrir… o Pegar en Compartir (mira Herramientas de base de datos), se detienen en esa misma conexión. Pro quita los límites.