从 Supabase 迁移
客户端 API、RLS 策略和 Edge Functions 继承。 CLI 导出您的 Supabase 用户及其 bcrypt 密码哈希值,恢复普通的 pg_dump(语句、函数体、COPY 数据)并导入用户:此页面准确说明了每个步骤进行的内容以及停止的位置。
与 Supabase 95% 相同#
客户端 API、RLS 策略、身份验证模型和存储遵循 Supabase的约定,因此应用程序代码更改很少。下表列出了相同和不同的内容。
| 特点 | 兼容性 | 注意事项 |
|---|---|---|
createClient() | 一样 | 导入 @aurabase/aurabase-js 而不是 @supabase/supabase-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 和专用端点 |
| 服务角色键 | 一样 | 相同的角色,相同的范围 |
四个命令,按顺序排列#
- 导出 —
aura migrate export-supabase写入users.json(用户、密码哈希值、OAuth 身份)和dump.sql(public架构、结构和数据的pg_dump) - 恢复 —
aura db restore dump.sql将转储重播到链接的项目中 - 导入用户 —
aura auth import users.json;用户保留他们的 ID 和密码 - Cutover — 切换应用程序中的 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 上没有意义的内容并说明原因:Supabase 角色的会话设置(
SET、set_config)、OWNER TO、GRANT/REVOKE、CREATE EXTENSION(扩展由 Aurabase管理)、CREATE SCHEMA public; - 按文件顺序运行其他所有内容,并且 在第一个失败步骤 处停止,并显示其编号、转储行和错误。修复原因并使用
--from <step>恢复,或通过--continue-on-error跳过失败的步骤并在最后获取列表。--dry-run打印计划而不执行任何操作。
两条路径,选择如 aura db push:
链接项目,没有 DATABASE_URL | DATABASE_URL 设置(直接连接字符串) | |
|---|---|---|
| 交通 | 每条语句一次 SQL API 调用,由服务器验证 | 一个 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,当电子邮件或 ID 已存在时为 error 以及原因)。再次运行它是安全的:现有用户永远不会被覆盖。
登录时,Aurabase Auth 会验证 bcrypt 哈希,然后将其替换为 Argon2id 哈希:您的用户保留其密码并且不执行任何操作。导入接受 bcrypt 哈希值 $2a$、 $2b$ 和 $2y$ ,成本为 4 到 12 (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' } }
)
})