コンテンツへスキップ
オーラベースのロゴ
オーラベース

Supabase から移行する

クライアント API、RLS ポリシー、および Edge Functions は引き継がれます。 CLI は、Supabase ユーザーを bcrypt パスワード ハッシュとともにエクスポートし、プレーンな pg_dump (ステートメント、関数本体、COPY データ) を復元し、ユーザーをインポートします。このページには、各ステップが何を引き継ぎ、どこで停止するかが正確に記載されています。

ハウツーガイド10 分 読み取りレベル 中間2026/11/10 に改訂

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

Supabase と 95% 同一#

クライアント API、RLS ポリシー、認証モデル、およびストレージは Supabaseの規則に従っているため、アプリケーション コードはほとんど変更されません。以下の表は、何が同じで何が異なるかを示しています。

特徴互換性注記
createClient()同じ@supabase/supabase-js の代わりに @aurabase/aurabase-js をインポートします
.from().select()同じ同じチェーン可能な PostgREST API
RLS ポリシー同じPostgres SQL ポリシー。 to authenticated、 to anon 、および to service_role は、 aura_authenticated、 aura_anon 、および aura_service_roleのエイリアスとして受け入れられます。これらのロールは、プロジェクトのデータベース クラスターを使用して作成されます。その変更前に作成されたクラスターでは、aura_* ロール名を書き込みます。
auth.uid() および auth.role()同じクレームごとに互換性のあるヘルパー
auth.getUser()小さな違いdata は ユーザー (data.email) です。 Supabase は { data: { user } }を返します。 const { data: { user } } = await supabase.auth.getUser() として記述されたコードは、ここで user === undefined を取得します。 const { data: user } = await aura.auth.getUser() と記述します。
.rpc()同じPostgres 関数の同じシグネチャ
.storage.from().upload()同じS3と同じパスを持つ互換性のある API
.channel().on("postgres_changes")同じ同じ変更データ キャプチャ サーフェス
Edge Functions (Deno)同じ標準 Deno ランタイム。 Deno.serve() は書き換えなしで動作します
認証フック小さな違いHTTP Webhook と専用エンドポイント
サービスロールキー同じ同じ役割、同じスコープ

4 つのコマンドを順番に#

  1. のエクスポート — aura migrate export-supabase は、users.json (ユーザー、パスワード ハッシュ、OAuth ID) および dump.sql (public スキーマ、構造、およびデータのpg_dump) を書き込みます。
  2. を復元します — aura db restore dump.sql はリンクされたプロジェクトにダンプを再生します
  3. ユーザーをインポートします — aura auth import users.json;ユーザーは自分のIDとパスワードを保持します
  4. カットオーバー — アプリ内の URL とキーを切り替えます。 Edge Functions を変更せずにデプロイします
terminalbash
# 1. Supabase からエクスポートします (設定 > データベース > 接続文字列、`postgres` ロール)
aura migrate export-supabase --db-url "$SUPABASE_DB_URL" --output-dir ./supabase-export

# 2. リンクされた Aurabase プロジェクトにスキーマとデータを復元します。
aura link <project>
aura db restore ./supabase-export/dump.sql --dry-run   # 計画のみを解析して出力する
aura db restore ./supabase-export/dump.sql

# 3. ユーザーをパスワード ハッシュとともにインポートします。
aura auth import ./supabase-export/users.json

スキーマとデータを復元する#

aura migrate export-supabase は、ローカルの pg_dump を使用して pg_dump --schema=public --no-owner --no-acl --format=plain を実行します (PostgreSQL クライアント ツールをインストールします。それらがないと、コマンドは自分で実行するための正確な pg_dump 行を出力します)。

aura db restore <file.sql> は、プレーン SQL ダンプを psql と同じように読み取ります。ステートメントは文字列、引用符で囲まれた識別子、コメント、およびドルで囲まれた本体 ($$ … $$、 $fn$ … $fn$) の外側で分割され、 COPY … FROM stdin ブロックは \. 行まで読み取られ、psql メタコマンド (\connect) 、\restrict) はスキップされます。すると、次のようになります。

  • pg_dump が書き込む public. 修飾子を削除するため、テーブルはプロジェクト スキーマ (別のスキーマの場合は--source-schema) に配置されます。
  • Aurabase で意味のないものをスキップし、その理由を説明します: セッション設定 (SET、 set_config)、 Supabase ロールの OWNER TO、 GRANT/REVOKE 、 CREATE EXTENSION (拡張機能は Aurabaseによって管理されます)、 CREATE SCHEMA public。
  • 他のすべてをファイルの順序で実行し、は最初に失敗したステップ で停止し、その番号、ダンプ行、およびエラーが表示されます。原因を修正して --from <step>で再開するか、 --continue-on-error を渡して失敗したステップを通過して最後にリストを取得します。 --dry-run は何も実行せずに計画を出力します。

aura db pushのように選択された 2 つのパス:

リンクされたプロジェクト、DATABASE_URL なしDATABASE_URL セット (直接接続文字列)
輸送ステートメントごとに 1 つの SQL API 呼び出し、サーバーによって検証される1 つの PostgreSQL 接続
COPY データINSERT バッチ (500 行) に変換されましたCOPY プロトコル、ダンプされたデータ
関数、トリガー、DO ブロックSQL API によって が拒否されました。aura db function create および aura db trigger create を使用して作成してください。作成されました
安全境界線プロジェクトのサーバーの分離ポリシープロジェクトの PostgreSQL ロール (独自のデータベースのみ、スーパーユーザーなし、行レベルのセキュリティが適用されます)

SQL API パスでは、サーバーは E'…' 文字列、他のスキーマへの参照、およびステートメント内の禁止されたコマンドのように見えるテキスト (文字列リテラル内であっても) も拒否します。そのようなテキストを含むデータ行は、そのステップ番号で失敗します。これらのダンプには直接パスを使用してください。デプロイメントが直接 PostgreSQL アクセスを公開する場合、直接接続文字列は 設定 › 接続 にあります。

復元は を順次実行します: プレーン SQL ダンプは順序付けされ (テーブル、データ、制約とインデックスの順)、並列化する依存関係グラフはありません。スループットの数値は公開されていません。

注意

auth.users への参照は、そのままでは復元されません。 Aurabase Auth はユーザーを auth.users テーブルに保持しないため、REFERENCES auth.users(id) などの外部キーは失敗します。 --continue-on-error を使用して復元し、その制約なしで user_id 列を保持します。ユーザー ID は以下のインポートによって保持されるため、値は引き続き一致します。

ユーザーとパスワード#

aura migrate export-supabase は、 auth.users および auth.identities を読み取り、ユーザーごとに、元の ID、電子メール、 email_verified、 encrypted_passwordの bcrypt ハッシュ 、名前およびメタデータ (raw_user_meta_data、および raw_app_meta_data ) を書き込みます。 Supabase独自の provider/providers キーなし)、リンクされた OAuth は (Google、GitHub…) を識別します。ファイルはユーザーのみが読み取り可能に書き込まれます。パスワード ハッシュが保持されているため、インポート後に削除します。

aura auth import users.json は、1,000 人のバッチでユーザーを管理インポート API に送信し、作成されていないすべての行を出力します (電子メールまたは ID がすでに存在する場合はskipped、理由を含む error)。再度実行しても安全です。既存のユーザーが上書きされることはありません。

サインイン時に、Aurabase Auth は bcrypt ハッシュを検証し、それを Argon2id ハッシュに置き換えます。ユーザーはパスワードを保持し、何も行いません。インポートでは、コストが 4 ~ 12 の bcrypt ハッシュ $2a$、 $2b$ 、および $2y$ (Supabase は 10 を使用)、および制限されたパラメーターを持つ Argon2id ハッシュを受け入れます。他の形式は行ごとに拒否されます。 OAuth ユーザーは同じプロバイダーで再度サインインし、同じアカウントにアクセスします。

注意

引き継がれない: MFA 要素 (TOTP、電話)、アクティブなセッションとリフレッシュ トークン (すべてのユーザーが再度サインインする)、禁止、電話のみ、匿名および削除されたユーザー (エクスポートによってカウントおよびレポートされる)。 MFA を持つユーザーは、再度登録する必要があります。

ネイティブ Deno — 書き換えゼロ#

Aurabase は、標準の Deno ランタイムを実行します。 Deno.serve() を使用する関数は、変更しなくても 100% 互換性があります。

functions/hello.tstypescript
// 標準 Deno 関数 — Aurabase でそのまま動作します
Deno.serve(async (req) => {
  const { name } = await req.json()
  return new Response(
    JSON.stringify({ message: `Hello ${name}!` }),
    { headers: { 'content-type': 'application/json' } }
  )
})

さらに進むには#