Supabase から移行する
クライアント API、RLS ポリシー、および Edge Functions は引き継がれます。 CLI は、Supabase ユーザーを bcrypt パスワード ハッシュとともにエクスポートし、プレーンな pg_dump (ステートメント、関数本体、COPY データ) を復元し、ユーザーをインポートします。このページには、各ステップが何を引き継ぎ、どこで停止するかが正確に記載されています。
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 つのコマンドを順番に#
- のエクスポート —
aura migrate export-supabaseは、users.json(ユーザー、パスワード ハッシュ、OAuth ID) およびdump.sql(publicスキーマ、構造、およびデータのpg_dump) を書き込みます。 - を復元します —
aura db restore dump.sqlはリンクされたプロジェクトにダンプを再生します - ユーザーをインポートします —
aura auth import users.json;ユーザーは自分のIDとパスワードを保持します - カットオーバー — アプリ内の URL とキーを切り替えます。 Edge Functions を変更せずにデプロイします
# 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% 互換性があります。
// 標準 Deno 関数 — Aurabase でそのまま動作します
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(
JSON.stringify({ message: `Hello ${name}!` }),
{ headers: { 'content-type': 'application/json' } }
)
})