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.
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ística | Compatibilidad | Nota |
|---|---|---|
createClient() | Lo mismo | Importar @aurabase/aurabase-js en lugar de @supabase/supabase-js |
.from().select() | Lo mismo | Misma API PostgREST encadenable |
| RLS políticas | Lo mismo | Postgres 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 mismo | Ayudantes compatibles reclamo por reclamo |
auth.getUser() | Diferencia menor | data 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 mismo | Misma firma para funciones Postgres |
.storage.from().upload() | Lo mismo | S3-API compatible con rutas idénticas |
.channel().on("postgres_changes") | Lo mismo | Misma superficie de captura de datos de cambio |
| Edge Functions (Deno) | Lo mismo | Tiempo de ejecución estándar Deno; Deno.serve() funciona sin reescribir |
| Ganchos de autenticación | Diferencia menor | Webhooks HTTP y puntos finales dedicados |
| Clave de rol de servicio | Lo mismo | Mismo rol, mismo alcance |
Cuatro comandos, en orden#
- Exportar —
aura migrate export-supabaseescribeusers.json(usuarios, hash de contraseña, identidades OAuth) ydump.sql(pg_dumpdel esquema, estructura y datospublic) - Restaurar —
aura db restore dump.sqlreproduce el volcado en el proyecto vinculado - Importar usuarios —
aura auth import users.json; Los usuarios conservan su identificación y contraseña. - Cutover: cambia la URL y las claves en tu aplicación; implemente su Edge Functions sin cambios
# 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 escribepg_dump, por lo que las tablas aterrizan en el esquema del proyecto (--source-schemapara 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/REVOKEde 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-errorpara superar los pasos fallidos y obtener la lista al final.--dry-runimprime el plan sin ejecutar nada.
Dos caminos, elegidos como aura db push:
Proyecto vinculado, no DATABASE_URL | DATABASE_URL conjunto (cadena de conexión directa) | |
|---|---|---|
| Transporte | Una llamada a la API de SQL por declaración, validada por el servidor | Una conexión PostgreSQL |
COPY datos | Convertido a lotes INSERT (500 filas) | Protocolo COPY, datos volcados |
Funciones, disparadores, bloques DO | Rechazado por la API SQL: créelos con aura db function create y aura db trigger create | Creado |
| Límite de seguridad | La 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.
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.
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:
// 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' } }
)
})