Saltar al contenido
Logotipo de Aurabase
aurabase

Migrar desde Supabase

La API del cliente, las políticas RLS y Edge Functions se transfieren. La CLI exporta sus usuarios Supabase con sus hashes de contraseña de bcrypt, restaura un pg_dump simple (declaraciones, cuerpos de funciones, COPIAR datos) e importa los usuarios: esta página dice exactamente qué se transfiere cada paso y dónde se detiene.

Guía práctica10 min leerNivel intermedioRevisado el 10 nov 2026

Esta página fue traducida automáticamente. La versión en inglés es autorizada.

95% igual que Supabase#

La API del cliente, las políticas RLS, el modelo de autenticación y el almacenamiento siguen las convenciones de Supabase, por lo que el código de la aplicación cambia muy poco. La siguiente tabla indica qué es igual y qué no.

CaracterísticaCompatibilidadNota
createClient()Lo mismoImportar @aurabase/aurabase-js en lugar de @supabase/supabase-js
.from().select()Lo mismoMisma API PostgREST encadenable
RLS políticasLo mismoPostgres Políticas SQL. to authenticated, to anon y to service_role se aceptan como alias de aura_authenticated, aura_anon y aura_service_role. Estos roles se crean con el clúster de base de datos del proyecto; en un clúster creado antes de ese cambio, escriba los nombres de las funciones aura_*.
auth.uid() y auth.role()Lo mismoAyudantes compatibles reclamo por reclamo
auth.getUser()Diferencia menordata es el usuario (data.email); Supabase devuelve { data: { user } }. El código escrito como const { data: { user } } = await supabase.auth.getUser() obtiene user === undefined aquí: escriba const { data: user } = await aura.auth.getUser()
.rpc()Lo mismoMisma firma para funciones Postgres
.storage.from().upload()Lo mismoS3-API compatible con rutas idénticas
.channel().on("postgres_changes")Lo mismoMisma superficie de captura de datos de cambio
Edge Functions (Deno)Lo mismoTiempo de ejecución estándar Deno; Deno.serve() funciona sin reescribir
Ganchos de autenticaciónDiferencia menorWebhooks HTTP y puntos finales dedicados
Clave de rol de servicioLo mismoMismo rol, mismo alcance

Cuatro comandos, en orden#

  1. Exportar — aura migrate export-supabase escribe users.json (usuarios, hash de contraseña, identidades OAuth) y dump.sql (pg_dump del esquema, estructura y datos public)
  2. Restaurar — aura db restore dump.sql reproduce el volcado en el proyecto vinculado
  3. Importar usuarios — aura auth import users.json; Los usuarios conservan su identificación y contraseña.
  4. Cutover: cambia la URL y las claves en tu aplicación; implemente su Edge Functions sin cambios
terminalbash
# 1. Exportar desde Supabase (Configuración > Base de datos > cadena de conexión, función `postgres`)
aura migrate export-supabase --db-url "$SUPABASE_DB_URL" --output-dir ./supabase-export

# 2. Restaure el esquema y los datos en el proyecto Aurabase vinculado
aura link <project>
aura db restore ./supabase-export/dump.sql --dry-run   # analizar e imprimir solo el plan
aura db restore ./supabase-export/dump.sql

# 3. Importar los usuarios, con sus hashes de contraseña.
aura auth import ./supabase-export/users.json

Restaurar el esquema y los datos.#

aura migrate export-supabase ejecuta pg_dump --schema=public --no-owner --no-acl --format=plain con su pg_dump local (instale las herramientas cliente PostgreSQL; sin ellas, el comando imprime la línea pg_dump exacta para ejecutar usted mismo).

aura db restore <file.sql> lee un volcado de SQL simple de la misma manera que lo hace psql: las declaraciones se dividen fuera de cadenas, identificadores entrecomillados, comentarios y cuerpos cotizados en dólares ($$ … $$, $fn$ … $fn$), los bloques COPY … FROM stdin se leen hasta su línea \. y los metacomandos psql (\connect, \restrict) se omiten. Entonces:

  • elimina el calificador public. que escribe pg_dump, por lo que las tablas aterrizan en el esquema del proyecto (--source-schema para otro esquema);
  • omite lo que no tiene significado en Aurabase y dice por qué: configuración de sesión (SET, set_config), OWNER TO, GRANT/REVOKE de los roles Supabase, CREATE EXTENSION (las extensiones son administradas por Aurabase), CREATE SCHEMA public;
  • ejecuta todo lo demás en el orden del archivo y se detiene en el primer paso fallido con su número, su línea de volcado y el error. Solucione la causa y continúe con --from <step>, o pase --continue-on-error para superar los pasos fallidos y obtener la lista al final. --dry-run imprime el plan sin ejecutar nada.

Dos caminos, elegidos como aura db push:

Proyecto vinculado, no DATABASE_URLDATABASE_URL conjunto (cadena de conexión directa)
TransporteUna llamada a la API de SQL por declaración, validada por el servidorUna conexión PostgreSQL
COPY datosConvertido a lotes INSERT (500 filas)Protocolo COPY, datos volcados
Funciones, disparadores, bloques DORechazado por la API SQL: créelos con aura db function create y aura db trigger createCreado
Límite de seguridadLa política de aislamiento del servidor para el proyecto.La función PostgreSQL del proyecto (solo su propia base de datos, sin superusuario, se aplica la seguridad de nivel de fila)

En la ruta de la API de SQL, el servidor también rechaza cadenas E'…', referencias a otros esquemas y, en una declaración, texto que parece un comando prohibido, incluso dentro de una cadena literal: una fila de datos que contiene dicho texto falla con su número de paso. Utilice la ruta directa para esos volcados. La cadena de conexión directa está en Configuración › Conexión cuando su implementación publica acceso directo PostgreSQL.

La restauración ejecuta secuencialmente: se ordena un volcado de SQL simple (tablas, luego datos, luego restricciones e índices) y no tiene ningún gráfico de dependencia para paralelizar. No se publica ninguna cifra de rendimiento.

Atención

Las referencias a auth.users no se restauran tal como están. Aurabase Auth no mantiene a sus usuarios en una tabla auth.users, por lo que una clave externa como REFERENCES auth.users(id) falla. Restaure con --continue-on-error y mantenga las columnas user_id sin esa restricción: la importación a continuación conserva los identificadores de usuario, por lo que los valores aún coinciden.

Usuarios y contraseñas#

aura migrate export-supabase lee auth.users y auth.identities y escribe, para cada usuario: el id original, el correo electrónico email_verified, el hash bcrypt de encrypted_password, el nombre y los metadatos (raw_user_meta_data, y raw_app_meta_data sin las claves provider/providers propias de Supabase), y las identidades OAuth vinculadas (Google, GitHub…). El archivo está escrito y solo usted puede leerlo: contiene hashes de contraseña, elimínelo después de la importación.

aura auth import users.json envía los usuarios en lotes de 1000 a la API de importación de administrador e imprime cada línea que no se crea (skipped cuando el correo electrónico o la identificación ya existe, error con el motivo). Ejecutarlo nuevamente es seguro: los usuarios existentes nunca se sobrescriben.

Al iniciar sesión, Aurabase Auth verifica el hash bcrypt y luego lo reemplaza con un hash Argon2id: sus usuarios conservan su contraseña y no hacen nada. La importación acepta hashes bcrypt $2a$, $2b$ y $2y$ con un costo de 4 a 12 (Supabase usa 10) y hashes Argon2id con parámetros acotados; cualquier otro formato se rechaza línea por línea. Los usuarios de OAuth inician sesión nuevamente con el mismo proveedor y acceden a la misma cuenta.

Atención

No transferido: MFA factores (TOTP, teléfono), sesiones activas y tokens de actualización (cada usuario inicia sesión una vez más), prohibiciones, usuarios solo por teléfono, anónimos y eliminados (contados y reportados por la exportación). Los usuarios con MFA deben inscribirse nuevamente.

Nativo Deno: cero reescrituras#

Aurabase ejecuta un tiempo de ejecución estándar Deno. Sus funciones usando Deno.serve() son 100% compatibles sin modificaciones:

functions/hello.tstypescript
// Función estándar Deno: funciona tal cual en Aurabase
Deno.serve(async (req) => {
  const { name } = await req.json()
  return new Response(
    JSON.stringify({ message: `Hello ${name}!` }),
    { headers: { 'content-type': 'application/json' } }
  )
})

para ir más lejos#