Aura Logo
aurabasedocumentos
documentos›Guias›Migração para Firebase

Migrar do Firebase

Guia passo a passo para migrar dados do Firestore, usuários do Firebase Auth e buckets para a infraestrutura aberta e de alto desempenho do Aurabase.

11 min lido·Nível intermediário·Revisado em 19 de ago. de 2026
Este texto em inglês foi gerado automaticamente a partir do original em francês e ainda não foi revisado.
Esta página foi traduzida automaticamente. A versão em inglês é oficial.
#
Comparação

Blocos Firebase correspondentes

Aurabase substitui cada componente proprietário do Firebase por tecnologia padrão, aberta e de auto-hospedagem, sem dependência de fornecedor:

FirebaseAurabaseVantagem Aurabase

Cloud FirestorePostgreSQL equivalente superior (relacional + SQL) OU Aurabase NoSQL (estilo MongoDB)

Firebase AuthMesmo e enriquecido Mesmo suporte OAuth, MFA TOTP, links mágicos, senha

Firebase StorageAPI REST S3 MinIO igual e enriquecida com transformações de imagem dinâmicas

Cloud FunctionsFunções SameEdge Padrão Deno (Deno.serve()) + WASM

Security RulesSuperiorPostgres RLS (Row-Level Security) avaliado diretamente na base

Firebase Realtime DBSameAurabase Realtime (CDC, Presença, Transmissão via NATS/WebSockets)

#
Mapa

Roteiro de 4 etapas

  1. Esquema e Dados — Escolha do modelo (coleções PostgreSQL relacional ou NoSQL) e importação (15 min)
  2. Autenticação — Exporte usuários do Firebase Auth e importe hashes scrypt/bcrypt sem redefinir (10 min)
  3. Arquivos de armazenamento — Sincronização de buckets do Cloud Storage com o Aurabase Storage (variável dependendo do volume)
  4. Substituição do SDK — Substituindo firebase/* por @aurabase/aurabase-js
#
Dados

Do Firestore ao Aurabase

Você pode normalizar seus dados em PostgreSQL para aproveitar o poder do SQL e a digitação estrita ou importá-los diretamente para o mecanismo NoSQL Document Store do Aurabase:

import-firestore.shbash
# 1. Exporte o Firestore para arquivo JSONL
npx firestore-export --serviceAccount credentials.json --output firestore-export.jsonl

# 2. Importe para o mecanismo Aurabase NoSQL
aura db nosql-import firestore-export.jsonl --collection users --project-id <id>

# 3. Gerando tipos TypeScript completos
aura db generate > src/aurabase.types.ts
#
Autenticação

Migração de usuários sem complicações

Graças ao suporte aos algoritmos de hash de senha do Firebase (scrypt, bcrypt, Argon2id), seus usuários mantêm suas credenciais sem precisar redefinir a senha:

migrate-auth.shbash
# Exportando usuários da CLI do Firebase
firebase auth:export users.json --format=JSON --project my-firebase-app

# Importe para Aurabase Auth (preserva hashes e tokens)
aura auth import users.json --provider firebase --env prod
#
Armazenamento

Sincronizando buckets S3

Aurabase Storage usa uma API S3 padrão. Você pode sincronizar seus arquivos continuamente do Google Cloud Storage com o utilitário rclone ou aws-cli:

sync-buckets.shbash
# Transferência direta do GCS para o armazenamento Aurabase
rclone sync gcs:my-firebase-bucket s3:aurabase-storage-bucket \
  --s3-endpoint https://api.aurabase.cloud/v1/storage/$PROJECT_ID \
  --s3-access-key-id $SERVICE_ROLE_KEY \
  --progress
#
Código

Substituindo o SDK do cliente

comparison.tstypescript
// ANTES (Firebase)
import { getFirestore, doc, getDoc } from 'firebase/firestore'
const snap = await getDoc(doc(db, 'users', 'u1'))
const user = snap.data()

// DEPOIS (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
const { data: user } = await aura.from('users').select('*').eq('id', 'u1').single()
Última atualização · 19 de ago. de 2026