Aurabaseでは、設計段階から強い制約を課しました。SDK サーフェスと RLS 規約は、 ドロップイン互換性のある と Supabaseでなければなりません。同じ createClient()、同じ .from().select().eq()、同じ SQL Postgres ポリシー。アイデアは、「辞めたいなら辞めればいい」というものです。私たちはそれを簡単にします。完全なプレイブックはこちらです。
動くもの、残るもの
始める前に、何が変わり、何が変わらないのかをリストアップしてください。スポイラー:大多数が残っています。
| Postgres スキーマ | 同じ | pg_dump → pg_restore。拡張機能、トリガー、関数、インデックスなど、すべてが対応します。 |
|---|---|---|
| RLS ポリシー | 同じ | 同じ構文。 auth.uid()、auth.role()、auth.jwt() はそのまま動作します。 |
| JavaScript SDK | 95%同一 | @supabase/supabase-js を @aurabase/aurabase-js に置き換えます。同じチェーン可能な API。 |
| 認証フロー | 同じ | SignUp、signInWithPassword、signInWithOAuth、mfa — 同じ名前、同じ署名。 |
| ストレージAPI | 同じ | aura.storage.from(bucket).upload(...) · 互換性のある S3 · 転送可能な RLS ポリシー。 |
| リアルタイム | 同じ | channel().on("postgres_changes", ...) は変更されません。プレゼンス + ブロードキャストは同じです。 |
| Edge Functions | 同じ | Deno.serve() は、Studio エディターにそのまま貼り付けられます。 CLI には、別のパス (Rust が WASMにコンパイルされる) を対象とした関数がデプロイされます。 |
| ダッシュボード | 違う | Studio Aurabase · 私たちはあなたの方向性を見つけるお手伝いをします。 |
ターゲットの Aurabase プロジェクトを作成する
公式 CLI を使用して新しい Aurabase プロジェクトを作成し、このフォルダーをプロジェクトにリンクすると、次のコマンドが自動的に適用されます。
# Aurabase アカウント + CLI
npm i -g @aurabase/cli
aura login
# プロジェクトの作成 (Postgres エンジン)
aura projects create my-app --engine postgres
# このフォルダーを作成したプロジェクトにリンクします
aura link --project-id <uuid-du-projet>
# リンクされたプロジェクトの API キーを取得します
aura projects api-keys
Supabaseをダンプし、 Aurabase を復元します
標準の pg_dump / pg_restore: Aurabase は、プロジェクトごとに直接 Postgres 接続文字列を公開します (スタジオ → 設定 → 接続)。中間変換は必要ありません。
# ダッシュボードから Supabase 接続文字列を取得します。
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"
# パブリック スキーマ ダンプ (Supabase システム スキーマなし)
pg_dump "$SUPABASE_DB_URL" \
--schema=public \
--no-owner --no-acl \
--format=custom \
-f supabase-dump.pgdump
# Aurabase 接続文字列を取得します (Studio → 設定 → 接続)
# ?search_path= パラメータは必須です。プロジェクトのスキーマにルーティングされます。
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"
# 標準の pg_restore で復元する
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump
# TypeScript 型を再生成する
aura db generate > src/aurabase.types.ts
ユーザーの移行
以前にここで述べたことと比較して修正すべき点: Aurabase は Argon2id でパスワードをハッシュしますが、Supabase (GoTrue) はデフォルトで bcrypt で独自のハッシュを行います。この 2 つの形式は互換性がありません。したがって、ほとんどの移行と同様に、ユーザーはパスワードを一度リセットする必要があります。
Aurabase は現在、 Supabaseからの一括インポート ツールを提供していません。 2 つのオプション: ユーザーに自分自身を再登録させる (同じ電子メール アドレスでsignUp)、またはパスワード リセットをトリガーする前に、管理者側で aura auth users create --email <email> を使用してユーザーを 1 つずつ再登録します。
Supabase 側のアクティブ セッションは移植されません (技術的に不可能です。各プラットフォームは独自のキーで JWT に署名します)。ユーザーは新しいパスワードを使用して再度ログインする必要があります。
クライアントコードを適応させる
95% のケースでは検索/置換で十分です。
// 前 (Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)
// 後 (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)
// コードの残りの部分は変更されません。
await aura.from('posts').select('*').eq('author_id', userId)
Edge Functions をデプロイする
Aurabase は、 Edge Functions用に 2 つのパスを提供します。 Studio コード エディター (Deno ランタイム、 Supabase と同じ - 関数をそのまま貼り付けます) と aura functions deployCLI です。これは、 Rust で記述され WASMでコンパイルされた関数の別のパスを目的としています。既存の Deno コードを書き換えずに移行するには、Studio を使用します。
// 機能は同じで、Studio エディタにそのまま貼り付けられます。
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(JSON.stringify({ hello: name }))
})
DNSの切り替えと本番稼働の開始
考えられる戦略は 2 つあります。 99% の場合、最初の方法が推奨されます。
- 直接カットオーバー — 環境変数の
NEXT_PUBLIC_AURABASE_URLとNEXT_PUBLIC_AURABASE_ANON_KEYを変更し、再デプロイします。ユーザーが再接続すると、すべてが機能します。ほとんどのプロジェクトに推奨されます。 - 一時二重書き込み — Supabase + Aurabase を 48 時間同時に書き込み、重要なテーブルの整合性を手動でチェック (行カウント、チェックサム) し、その後 Supabaseをシャットダウンします。重要なアプリに推奨されます。
物事が行き詰まった場合はここにいます
大規模なプロジェクトや厳格なコンプライアンス制約がある場合、当社のチームが移行をサポートします。あなたのプロジェクトに合わせたオファーについてはお問い合わせください。