NOVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Veja o changelog →

Engenharia · 6 minutos de leitura

Migre Supabase para Aurabase, mantenha seu RLS

Affane Daylami · Fondateur · 20 de setembro de 2026

Voltar ao blog

Se você está em Supabase e está de olho em Aurabase (veja nossa comparação detalhada), a boa notícia é que o mais difícil é escolher. A tabela abaixo lista exatamente o que muda em uma migração — e é curta: esquema, políticas RLS, SDK, autenticação e armazenamento permanecem os mesmos.

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

Em Aurabase, nos demos uma forte restrição desde o estágio de design: a superfície do SDK e as convenções RLS tinham que ser compatíveis com com Supabase. As mesmas políticas createClient(), mesmas .from().select().eq(), mesmas SQL Postgres . A ideia: se você quiser ir embora, vá embora – nós tornamos isso trivial. Aqui está o manual completo.

#
Auditoria prévia

O que se move, o que fica

Antes de começar, liste o que mudará e o que permanecerá. Spoiler: a maioria permanece.

Esquema PostgresMESMOpg_dump → pg_restore. Extensões, gatilhos, funções, índices – vale tudo.
RLS PolíticasMESMOMesma sintaxe. auth.uid(), auth.role(), auth.jwt() funcionam como estão.
SDK JavaScript95% IDÊNTICOSubstitua @supabase/supabase-js por @aurabase/aurabase-js. A mesma API encadeada.
Fluxos de autenticaçãoMESMOsignUp, signInWithPassword, signInWithOAuth, mfa — mesmos nomes, mesmas assinaturas.
API de armazenamentoMESMOaura.storage.from(bucket).upload(...) · compatibilidade S3 · políticas RLS transferíveis.
Tempo realMESMOchannel().on("postgres_changes", ...) inalterado. Presença + transmissão igual.
Edge FunctionsMESMODeno.serve() colado como está no editor do Studio. A CLI terá funções implantadas voltadas para um caminho separado (Rust compilado para WASM).
PainelDIFERENTEStudio Aurabase · ajudamos você a se orientar.
#
Passo 1

Crie o projeto Aurabase de destino

Crie um novo projeto Aurabase com a CLI oficial e vincule esta pasta ao projeto para que os comandos a seguir sejam aplicados a ele automaticamente.

terminalbash
# Aurabase conta + CLI
npm i -g @aurabase/cli
aura login

# Crie o projeto (mecanismo Postgres)
aura projects create my-app --engine postgres

# Vincule esta pasta ao projeto criado
aura link --project-id <uuid-du-projet>

# Recuperar as chaves de API do projeto vinculado
aura projects api-keys
#
Etapa 2

Despejar Supabase, restaurar Aurabase

Um pg_dump / pg_restore padrão: Aurabase expõe uma string de conexão direta Postgres para cada projeto (Studio → Configurações → Conexão), sem necessidade de transformação intermediária.

terminalbash
# Recuperar a string de conexão Supabase do painel
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"

# Despejo de esquema público (sem esquemas de sistema Supabase)
pg_dump "$SUPABASE_DB_URL" \
  --schema=public \
  --no-owner --no-acl \
  --format=custom \
  -f supabase-dump.pgdump

# Recuperar string de conexão Aurabase (Studio → Configurações → Conexão)
# O parâmetro ?search_path= é OBRIGATÓRIO: ele direciona para o esquema do seu projeto
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"

# Restaurar com pg_restore padrão
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump

# Regenerar tipos TypeScript
aura db generate > src/aurabase.types.ts
#
Etapa 3

Migrar usuários

Um ponto a ser corrigido em comparação com o que afirmamos aqui anteriormente: Aurabase faz hash de senhas com Argon2id, mas Supabase (GoTrue) faz hash por padrão com bcrypt — os dois formatos não são intercambiáveis. Portanto, seus usuários terão que redefinir a senha uma vez, como acontece com a maioria das migrações.

Aurabase atualmente não oferece uma ferramenta de importação em massa de Supabase. Duas opções: permitir que seus usuários se registrem novamente (signUp com o mesmo endereço de e-mail) ou recriá-los um por um no lado do administrador com aura auth users create --email <email> antes de acionar uma redefinição de senha.

Informações

As sessões ativas no lado Supabase não são portadas (tecnicamente impossível — cada plataforma assina seus JWTs com sua própria chave). Os usuários precisarão fazer login novamente, com sua nova senha.

#
Etapa 4

Adapte o código do cliente

Uma pesquisa/substituição é suficiente para 95% dos casos.

lib/supabase.ts → lib/aurabase.tstypescript
// ANTES (Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)

// DEPOIS (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)

// O resto do código não muda:
await aura.from('posts').select('*').eq('author_id', userId)
#
Etapa 5

Implantar Edge Functions

Aurabase oferece dois caminhos para Edge Functions: o editor de código Studio (tempo de execução Deno, igual a Supabase - cole sua função como está) e a CLI aura functions deploy, que visa um caminho separado para funções escritas em Rust e compiladas em WASM. Para migrar o código Deno existente sem reescrever, use o Studio.

functions/hello/index.tstypescript
// Funciona da mesma forma, colado como está no editor do Studio
Deno.serve(async (req) => {
  const { name } = await req.json()
  return new Response(JSON.stringify({ hello: name }))
})
#
Corte

Mudança de DNS e lançamento de produção

Duas estratégias possíveis. O primeiro é recomendado para 99% dos casos.

  1. Transferência direta - altere NEXT_PUBLIC_AURABASE_URL e NEXT_PUBLIC_AURABASE_ANON_KEY em seus env vars, reimplante. Os usuários se reconectam, tudo funciona. Recomendado para a maioria dos projetos.
  2. Gravação dupla temporária - escreva Supabase + Aurabase simultaneamente por 48 horas, verifique a consistência das tabelas críticas manualmente (contagem de linhas, somas de verificação) e, em seguida, desligue Supabase. Preferido para aplicativos críticos.
#
Ajuda

Estamos aqui se as coisas ficarem presas

Para projetos grandes ou com restrições rígidas de conformidade, nossa equipe pode apoiá-lo na migração. Contacte-nos para uma oferta à medida do seu projeto.

Solicitar suporte →

PRONTO PARA IMPLEMENTAR?

Seu back-end em cinco minutos.

Não é necessário cartão de crédito · 500 MB grátis · 50.000 MAU