跳到内容
光环标志
光环基地

从 Supabase 迁移

客户端 API、RLS 策略和 Edge Functions 继承。 CLI 导出您的 Supabase 用户及其 bcrypt 密码哈希值,恢复普通的 pg_dump(语句、函数体、COPY 数据)并导入用户:此页面准确说明了每个步骤进行的内容以及停止的位置。

操作指南10分钟 读取级别 中间修改于 2026年11月10日

该页面已自动翻译。英文版具有权威性。

与 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 和专用端点
服务角色键一样相同的角色,相同的范围

四个命令,按顺序排列#

  1. 导出 — aura migrate export-supabase 写入 users.json(用户、密码哈希值、OAuth 身份)和 dump.sql(public 架构、结构和数据的pg_dump)
  2. 恢复 — aura db restore dump.sql 将转储重播到链接的项目中
  3. 导入用户 — aura auth import users.json;用户保留他们的 ID 和密码
  4. Cutover — 切换应用程序中的 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 上没有意义的内容并说明原因: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_URLDATABASE_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% 兼容:

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' } }
  )
})

为了走得更远#