新しいPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2変更履歴を参照 →

エンジニアリング · 6 分読み取り

Supabase を Aurabaseに移行し、 RLS はそのままにしておきます

Affane Daylami · Fondateur · 2026年9月20日

ブログに戻る

Supabase を使用していて、Aurabase を検討している場合 (詳細な比較を参照してください)、幸いなことに、最も難しいのは選択であるということです。以下の表は、移行での変更点を正確に示したものです。短いものですが、スキーマ、RLS ポリシー、SDK、認証、およびストレージは同じままです。

このページは自動翻訳されました。英語版が正式です。

Aurabaseでは、設計段階から強い制約を課しました。SDK サーフェスと RLS 規約は、 ドロップイン互換性のある と Supabaseでなければなりません。同じ createClient()、同じ .from().select().eq()、同じ SQL Postgres ポリシー。アイデアは、「辞めたいなら辞めればいい」というものです。私たちはそれを簡単にします。完全なプレイブックはこちらです。

#
事前監査

動くもの、残るもの

始める前に、何が変わり、何が変わらないのかをリストアップしてください。スポイラー:大多数が残っています。

Postgres スキーマ同じpg_dump → pg_restore。拡張機能、トリガー、関数、インデックスなど、すべてが対応します。
RLS ポリシー同じ同じ構文。 auth.uid()、auth.role()、auth.jwt() はそのまま動作します。
JavaScript SDK95%同一@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 · 私たちはあなたの方向性を見つけるお手伝いをします。
#
ステップ1

ターゲットの Aurabase プロジェクトを作成する

公式 CLI を使用して新しい Aurabase プロジェクトを作成し、このフォルダーをプロジェクトにリンクすると、次のコマンドが自動的に適用されます。

terminalbash
# 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
#
ステップ2

Supabaseをダンプし、 Aurabase を復元します

標準の pg_dump / pg_restore: Aurabase は、プロジェクトごとに直接 Postgres 接続文字列を公開します (スタジオ → 設定 → 接続)。中間変換は必要ありません。

terminalbash
# ダッシュボードから 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
#
ステップ3

ユーザーの移行

以前にここで述べたことと比較して修正すべき点: Aurabase は Argon2id でパスワードをハッシュしますが、Supabase (GoTrue) はデフォルトで bcrypt で独自のハッシュを行います。この 2 つの形式は互換性がありません。したがって、ほとんどの移行と同様に、ユーザーはパスワードを一度リセットする必要があります。

Aurabase は現在、 Supabaseからの一括インポート ツールを提供していません。 2 つのオプション: ユーザーに自分自身を再登録させる (同じ電子メール アドレスでsignUp)、またはパスワード リセットをトリガーする前に、管理者側で aura auth users create --email <email> を使用してユーザーを 1 つずつ再登録します。

情報

Supabase 側のアクティブ セッションは移植されません (技術的に不可能です。各プラットフォームは独自のキーで JWT に署名します)。ユーザーは新しいパスワードを使用して再度ログインする必要があります。

#
ステップ4

クライアントコードを適応させる

95% のケースでは検索/置換で十分です。

lib/supabase.ts → lib/aurabase.tstypescript
// 前 (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)
#
ステップ5

Edge Functions をデプロイする

Aurabase は、 Edge Functions用に 2 つのパスを提供します。 Studio コード エディター (Deno ランタイム、 Supabase と同じ - 関数をそのまま貼り付けます) と aura functions deployCLI です。これは、 Rust で記述され WASMでコンパイルされた関数の別のパスを目的としています。既存の Deno コードを書き換えずに移行するには、Studio を使用します。

functions/hello/index.tstypescript
// 機能は同じで、Studio エディタにそのまま貼り付けられます。
Deno.serve(async (req) => {
  const { name } = await req.json()
  return new Response(JSON.stringify({ hello: name }))
})
#
カットオーバー

DNSの切り替えと本番稼働の開始

考えられる戦略は 2 つあります。 99% の場合、最初の方法が推奨されます。

  1. 直接カットオーバー — 環境変数の NEXT_PUBLIC_AURABASE_URL と NEXT_PUBLIC_AURABASE_ANON_KEY を変更し、再デプロイします。ユーザーが再接続すると、すべてが機能します。ほとんどのプロジェクトに推奨されます。
  2. 一時二重書き込み — Supabase + Aurabase を 48 時間同時に書き込み、重要なテーブルの整合性を手動でチェック (行カウント、チェックサム) し、その後 Supabaseをシャットダウンします。重要なアプリに推奨されます。
#
ヘルプ

物事が行き詰まった場合はここにいます

大規模なプロジェクトや厳格なコンプライアンス制約がある場合、当社のチームが移行をサポートします。あなたのプロジェクトに合わせたオファーについてはお問い合わせください。

サポートのリクエスト →

導入の準備はできていますか?

5 分でバックエンドが完成します。

クレジット カードは不要 · 500 MB 無料 · 50,000 MAU