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.
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 é.
| Recurso | Compatibilidade | Nota |
|---|---|---|
createClient() | Igual | Importe @aurabase/aurabase-js em vez de @supabase/supabase-js |
.from().select() | Igual | Mesma API PostgREST encadeada |
| Políticas RLS | Igual | Postgres 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() | Igual | Ajudantes compatíveis reivindicação por reivindicação |
auth.getUser() | Pequena diferença | data é 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() | Igual | Mesma assinatura para funções Postgres |
.storage.from().upload() | Igual | API compatível com S3 com caminhos idênticos |
.channel().on("postgres_changes") | Igual | Mesma superfície de captura de dados alterados |
| Edge Functions (Deno) | Igual | Tempo de execução padrão Deno; Deno.serve() funciona sem reescrever |
| Ganchos de autenticação | Pequena diferença | Webhooks HTTP e endpoints dedicados |
| Chave de função de serviço | Igual | Mesma função, mesmo escopo |
Quatro comandos, em ordem#
- Exportar —
aura migrate export-supabasegravausers.json(usuários, hashes de senha, identidades OAuth) edump.sql(pg_dumpdo esquema, estrutura e dadospublic) - Restaurar —
aura db restore dump.sqlreproduz o dump no projeto vinculado - Importar usuários —
aura auth import users.json; os usuários mantêm seu ID e sua senha - Cutover — troque o URL e as chaves em seu aplicativo; implante seu Edge Functions inalterado
# 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.quepg_dumpgrava, para que as tabelas cheguem ao esquema do projeto (--source-schemapara 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/REVOKEdas 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-errorpara passar pelas etapas com falha e obter a lista no final.--dry-runimprime o plano sem executar nada.
Dois caminhos, escolhidos como aura db push:
Projeto vinculado, não DATABASE_URL | DATABASE_URL conjunto (string de conexão direta) | |
|---|---|---|
| Transporte | Uma chamada de API SQL por instrução, validada pelo servidor | Uma conexão PostgreSQL |
Dados COPY | Convertido em lotes INSERT (500 linhas) | Protocolo COPY, dados despejados |
Funções, gatilhos, blocos DO | Recusado pela API SQL: crie-os com aura db function create e aura db trigger create | Criado |
| Limite de segurança | A política de isolamento do servidor para o projeto | A 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.
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.
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:
// 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' } }
)
})