Перейти к содержимому
Логотип Аурабаза
аурабаза

Миграция с Supabase

Клиентский API, политики RLS и Edge Functions сохраняются. CLI экспортирует пользователей Supabase с их хешами паролей bcrypt, восстанавливает простой pg_dump (операторы, тела функций, данные COPY) и импортирует пользователей: на этой странице точно указано, что переносит каждый шаг и где он останавливается.

Практическое руководство10 мин читатьУровень среднийПересмотрено 10 нояб. 2026 г.

Эта страница была переведена автоматически. Английская версия является авторитетной.

95% то же, что и Supabase#

Клиентский API, политики RLS, модель аутентификации и хранилище соответствуют соглашениям Supabase, поэтому код приложения меняется очень мало. В таблице ниже указано, что совпадает, а что нет.

ОсобенностьСовместимостьПримечание
createClient()Такой жеИмпортируйте @aurabase/aurabase-js вместо @supabase/supabase-js.
.from().select()Такой жеТот же цепной API PostgREST
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 и выделенные конечные точки
Ролевой ключ службыТакой жеТа же роль, тот же объем

Четыре команды по порядку#

  1. Экспорт — aura migrate export-supabase записывает users.json (пользователи, хэши паролей, идентификаторы OAuth) и dump.sql (pg_dump схемы, структуры и данных public)
  2. Восстановить — aura db restore dump.sql воспроизводит дамп в связанный проект.
  3. Импортировать пользователей — aura auth import users.json; пользователи сохраняют свой идентификатор и пароль
  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 --schema=public --no-owner --no-acl --format=plain с вашим локальным pg_dump (установите клиентские инструменты PostgreSQL; без них команда печатает точную строку pg_dump для запуска самостоятельно).

aura db restore <file.sql> читает простой дамп SQL так же, как это делает psql: операторы разбиваются вне строк, идентификаторы в кавычках, комментарии и тела в долларовых кавычках ($$ … $$, $fn$ … $fn$), блоки COPY … FROM stdin считываются до строки \., а метакоманды psql (\connect, \restrict) пропускаются. Тогда это:

  • удаляет квалификатор public., который записывает pg_dump, поэтому таблицы попадают в схему проекта (--source-schema для другой схемы);
  • пропускает то, что не имеет смысла на Aurabase и говорит почему: настройки сеанса (SET, set_config), OWNER TO, GRANT/REVOKE ролей Supabase , CREATE EXTENSION (расширения управляются Aurabase), CREATE SCHEMA public;
  • выполняет все остальное в порядке файла, а останавливается на первом неудачном шаге с его номером, строкой дампа и ошибкой. Устраните причину и возобновите работу с помощью --from <step> или передайте --continue-on-error, чтобы пройти неудачные шаги и получить список в конце. --dry-run печатает план, ничего не выполняя.

Два пути, выбранные как aura db push:

Связанный проект, нет DATABASE_URLDATABASE_URL установлен (строка прямого подключения)
ТранспортОдин вызов API SQL для каждого оператора, проверенный сервером.Одно соединение PostgreSQL
COPY данныеПреобразовано в пакеты INSERT (500 строк).Протокол COPY, данные в виде дампа
Функции, триггеры, блоки DOОтказ от API SQL: создайте их с помощью aura db function create и aura db trigger createСозданный
Граница безопасностиПолитика изоляции сервера для проектаРоль PostgreSQL проекта (только собственная база данных, без суперпользователя, применяется безопасность на уровне строк)

На пути SQL API сервер также отклоняет строки E'…', ссылки на другие схемы и, в операторе, текст, который выглядит как запрещенная команда, даже внутри строкового литерала: строка данных, содержащая такой текст, завершается сбоем со своим номером шага. Используйте прямой путь для этих дампов. Строка прямого подключения находится в разделе Settings > Connection, когда ваше развертывание публикует прямой доступ PostgreSQL.

Восстановление выполняется последовательно : простой дамп SQL упорядочен (таблицы, затем данные, затем ограничения и индексы) и не имеет графа зависимостей для распараллеливания. Данные о пропускной способности не публикуются.

Внимание

Ссылки на auth.users не восстанавливаются как есть. Aurabase Auth не хранит своих пользователей в таблице auth.users, поэтому внешний ключ, такой как REFERENCES auth.users(id), не работает. Выполните восстановление с помощью --continue-on-error и сохраните столбцы user_id без этого ограничения: идентификаторы пользователей сохраняются при импорте ниже, поэтому значения по-прежнему совпадают.

Пользователи и пароли#

aura migrate export-supabase читает auth.users и auth.identities и записывает для каждого пользователя: исходный идентификатор, адрес электронной почты email_verified, bcrypt-хэш encrypted_password, имя и метаданные (raw_user_meta_data и raw_app_meta_data без собственных ключей Supabaseprovider/providers), а также связанные OAuth идентификаторы (Google, GitHub…). Файл доступен для чтения только вам: он содержит хэши паролей, удалите его после импорта.

aura auth import users.json отправляет пользователей пакетами по 1000 в API импорта администратора и печатает каждую не созданную строку (skipped, если адрес электронной почты или идентификатор уже существует, 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' } }
  )
})

Чтобы пойти дальше#