Ir para o conteúdo
Aura Logo
aurabase

Migrar de Supabase

A API do cliente, as políticas RLS e Edge Functions são transferidas. A CLI exporta seus usuários Supabase com seus hashes de senha bcrypt, restaura um pg_dump simples (instruções, corpos de função, dados COPY) e importa os usuários: esta página diz exatamente o que cada etapa carrega e onde ela para.

Guia prático10 min lidoNível intermediárioRevisado em 10 de nov. de 2026

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

95% igual a Supabase#

A API do cliente, as políticas RLS, o modelo de autenticação e o armazenamento seguem as convenções de Supabase, portanto o código do aplicativo muda muito pouco. A tabela abaixo indica o que é igual e o que não é.

RecursoCompatibilidadeNota
createClient()IgualImporte @aurabase/aurabase-js em vez de @supabase/supabase-js
.from().select()IgualMesma API PostgREST encadeada
Políticas RLSIgualPostgres Políticas SQL. to authenticated, to anon e to service_role são aceitos como apelidos de aura_authenticated, aura_anon e aura_service_role. Essas funções são criadas com o cluster de banco de dados do projeto; em um cluster criado antes dessa mudança, escreva os nomes das funções aura_*.
auth.uid() e auth.role()IgualAjudantes compatíveis reivindicação por reivindicação
auth.getUser()Pequena diferençadata é o usuário (data.email); Supabase retorna { data: { user } }. Código escrito como const { data: { user } } = await supabase.auth.getUser() obtém user === undefined aqui: escreva const { data: user } = await aura.auth.getUser()
.rpc()IgualMesma assinatura para funções Postgres
.storage.from().upload()IgualAPI compatível com S3 com caminhos idênticos
.channel().on("postgres_changes")IgualMesma superfície de captura de dados alterados
Edge Functions (Deno)IgualTempo de execução padrão Deno; Deno.serve() funciona sem reescrever
Ganchos de autenticaçãoPequena diferençaWebhooks HTTP e endpoints dedicados
Chave de função de serviçoIgualMesma função, mesmo escopo

Quatro comandos, em ordem#

  1. Exportar — aura migrate export-supabase grava users.json (usuários, hashes de senha, identidades OAuth) e dump.sql (pg_dump do esquema, estrutura e dados public)
  2. Restaurar — aura db restore dump.sql reproduz o dump no projeto vinculado
  3. Importar usuários — aura auth import users.json; os usuários mantêm seu ID e sua senha
  4. Cutover — troque o URL e as chaves em seu aplicativo; implante seu Edge Functions inalterado
terminalbash
# 1. Exportar de Supabase (Configurações > Banco de dados > string de conexão, função `postgres`)
aura migrate export-supabase --db-url "$SUPABASE_DB_URL" --output-dir ./supabase-export

# 2. Restaure o esquema e os dados no projeto Aurabase vinculado
aura link <project>
aura db restore ./supabase-export/dump.sql --dry-run   # analisar e imprimir apenas o plano
aura db restore ./supabase-export/dump.sql

# 3. Importe os usuários, com seus hashes de senha
aura auth import ./supabase-export/users.json

Restaurar o esquema e os dados#

aura migrate export-supabase executa pg_dump --schema=public --no-owner --no-acl --format=plain com seu pg_dump local (instale as ferramentas cliente PostgreSQL; sem elas, o comando imprime a linha pg_dump exata para executar você mesmo).

aura db restore <file.sql> lê um SQL simples dump da mesma forma que psql: as instruções são divididas fora de strings, identificadores entre aspas, comentários e corpos entre aspas em dólares ($$ … $$, $fn$ … $fn$), blocos COPY … FROM stdin são lidos até sua linha \. e meta-comandos psql (\connect, \restrict) são ignorados. Então:

  • remove o qualificador public. que pg_dump grava, para que as tabelas cheguem ao esquema do projeto (--source-schema para outro esquema);
  • pula o que não tem significado em Aurabase e diz o porquê: configurações de sessão (SET, set_config), OWNER TO, GRANT/REVOKE das funções Supabase, CREATE EXTENSION (as extensões são gerenciadas por Aurabase), CREATE SCHEMA public;
  • executa todo o resto na ordem do arquivo e para na primeira etapa com falha com seu número, sua linha de dump e o erro. Corrija a causa e continue com --from <step> ou passe --continue-on-error para passar pelas etapas com falha e obter a lista no final. --dry-run imprime o plano sem executar nada.

Dois caminhos, escolhidos como aura db push:

Projeto vinculado, não DATABASE_URLDATABASE_URL conjunto (string de conexão direta)
TransporteUma chamada de API SQL por instrução, validada pelo servidorUma conexão PostgreSQL
Dados COPYConvertido em lotes INSERT (500 linhas)Protocolo COPY, dados despejados
Funções, gatilhos, blocos DORecusado pela API SQL: crie-os com aura db function create e aura db trigger createCriado
Limite de segurançaA política de isolamento do servidor para o projetoA função PostgreSQL do projeto (somente seu próprio banco de dados, sem superusuário, aplica-se a segurança em nível de linha)

No caminho da API SQL, o servidor também recusa strings E'…', referências a outros esquemas e, em uma instrução, texto que pareça um comando proibido, mesmo dentro de uma string literal: uma linha de dados contendo tal texto falha com seu número de etapa. Use o caminho direto para esses dumps. A cadeia de conexão direta está em Configurações › Conexão quando sua implantação publica acesso direto PostgreSQL.

A restauração é executada sequencialmente: um dump SQL simples é ordenado (tabelas, depois dados, depois restrições e índices) e não possui gráfico de dependência para paralelizar. Nenhum valor de rendimento é publicado.

Atenção

Referências a auth.users não são restauradas como estão. Aurabase Auth não mantém seus usuários em uma tabela auth.users, portanto, uma chave estrangeira como REFERENCES auth.users(id) falha. Restaure com --continue-on-error e mantenha as colunas user_id sem essa restrição: os IDs dos usuários são preservados pela importação abaixo, portanto os valores ainda correspondem.

Usuários e senhas#

aura migrate export-supabase lê auth.users e auth.identities e escreve, para cada usuário: o id original, o email, email_verified, o bcrypt hash de encrypted_password, o nome e os metadados (raw_user_meta_data e raw_app_meta_data sem as próprias chaves provider/providers de Supabase) e as identidades OAuth vinculadas (Google, GitHub…). O arquivo é legível apenas por você: ele contém hashes de senha, exclua-o após a importação.

aura auth import users.json envia os usuários em lotes de 1.000 para a API de importação administrativa e imprime todas as linhas que não são criadas (skipped quando o email ou o id já existe, error com o motivo). Executá-lo novamente é seguro: os usuários existentes nunca são substituídos.

No login, Aurabase Auth verifica o hash bcrypt e o substitui por um hash Argon2id: seus usuários mantêm suas senhas e não fazem nada. A importação aceita hashes bcrypt $2a$, $2b$ e $2y$ com um custo de 4 a 12 (Supabase usa 10) e hashes Argon2id com parâmetros limitados; qualquer outro formato é recusado linha por linha. Os usuários OAuth fazem login novamente com o mesmo provedor e acessam a mesma conta.

Atenção

Não transportado: MFA fatores (TOTP, telefone), sessões ativas e tokens de atualização (cada usuário faz login novamente), banimentos, usuários apenas por telefone, anônimos e excluídos (contados e relatados pela exportação). Os usuários com MFA devem se inscrever novamente.

Nativo Deno – zero reescritas#

Aurabase executa um tempo de execução Deno padrão. Suas funções usando Deno.serve() são 100% compatíveis sem modificação:

functions/hello.tstypescript
// Função Deno padrão — funciona como está em 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 mais longe#