JillionDB
DocumentaciónBase de datos en vivo

Documentación

Base de datos en vivo

Conecta tu base de datos real y JillionDB te avisará cuando no coincida con JillionDB. Pro y Enterprise.

Qué hace

JillionDB lee las definiciones de las tablas de tu base de datos PostgreSQL o MySQL y las compara con el esquema de tu proyecto. Si alguien cambió la base de datos fuera de JillionDB, o un cambio aprobado aún no se ha aplicado, ves cada diferencia en palabras claras.

Crea un usuario que no pueda leer datos

Ejecútalo una vez en tu base de datos, como administrador. Pon el nombre de tu base de datos y una contraseña larga.

PostgreSQL (Neon, Supabase, Amazon RDS y otros):

CREATE ROLE jilliondb_reader LOGIN PASSWORD 'choose-a-long-password';
GRANT CONNECT ON DATABASE your_database TO jilliondb_reader;
GRANT USAGE ON SCHEMA public TO jilliondb_reader;

MySQL:

CREATE USER 'jilliondb_reader'@'%' IDENTIFIED BY 'choose-a-long-password';
GRANT REFERENCES ON your_database.* TO 'jilliondb_reader'@'%';

PostgreSQL deja a cualquier usuario leer las definiciones de las tablas, y el permiso REFERENCES de MySQL las muestra sin permitir lecturas, así que ninguno de los dos usuarios ve tus datos.

Conecta

  1. Abre tu proyecto y pulsa el botón de base de datos en la barra.
  2. Pega la cadena de conexión de tu proveedor, con el usuario de arriba, o rellena los campos uno a uno.
  3. Elige el cifrado: Cifrado, con certificado comprobado para Neon, Supabase y la mayoría de bases alojadas, o Solo cifrado para proveedores con su propio certificado, como Amazon RDS.
  4. Pulsa Conectar y comprobar. JillionDB lee la base de datos y muestra si coincide.

Cuando no coinciden

La lista muestra lo que JillionDB cambiaría para igualar tu base de datos. Pulsa Igualar JillionDB para poner tu proyecto al día; el esquema actual se guarda antes como versión, para que puedas volver atrás. Si la que va por detrás es la base de datos, aplica tus migraciones como siempre y pulsa Comprobar ahora.

Con la comprobación automática activa, JillionDB vuelve a mirar cada pocas horas, y también cuando abres el proyecto tras una hora o más.

Si no conecta

Si tu base de datos solo acepta ciertas IP, permite 162.254.39.64. JillionDB no puede llegar a bases de datos en redes privadas; usa la dirección pública que te da tu proveedor.

Bases privadas, locales y SQLite: el puente

Si JillionDB no puede llegar a tu base de datos porque está en tu portátil, dentro de una red privada o es un archivo SQLite, usa el puente. Es un pequeño comando de código abierto que lee las definiciones de tablas donde está tu base de datos y envía solo eso a JillionDB. La contraseña de tu base de datos nunca sale de tu equipo y JillionDB nunca se conecta a ella.

  1. Abre tu proyecto, pulsa el botón de base de datos y elige Usar el puente.
  2. Pulsa Crear token y cópialo. Solo permite que el puente envíe definiciones de tablas a este proyecto.
  3. Ejecuta el comando donde se pueda llegar a tu base de datos, con tu propia cadena de conexión o la ruta a tu archivo SQLite.
npx jilliondb push --token jdbb_… --url postgresql://user:password@localhost:5432/app

El resultado aparece al instante, en tu terminal y en el proyecto. Añade --watch para que siga en marcha y envíe de nuevo cada 15 minutos, o ejecútalo en CI después de cada despliegue con --fail-on-drift para detener la compilación cuando tu base de datos y JillionDB no coincidan. Añade --print para ver exactamente lo que se enviaría, sin enviar nada.

El puente requiere Node 20 o posterior, o Node 22.13 o posterior para archivos SQLite. Puedes indicar el token con JILLIONDB_TOKEN y la base de datos con DATABASE_URL en lugar de escribirlos en el comando.

Desconectar

Pulsa Desconectar en la misma ventana. JillionDB borra el usuario guardado y deja de comprobar. Hasta entonces, la contraseña se guarda cifrada. También puedes borrar el usuario de tu base de datos cuando quieras.