Миграция с Supabase
Клиентский API, политики RLS и Edge Functions сохраняются. CLI экспортирует пользователей Supabase с их хешами паролей bcrypt, восстанавливает простой pg_dump (операторы, тела функций, данные COPY) и импортирует пользователей: на этой странице точно указано, что переносит каждый шаг и где он останавливается.
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 и выделенные конечные точки |
| Ролевой ключ службы | Такой же | Та же роль, тот же объем |
Четыре команды по порядку#
- Экспорт —
aura migrate export-supabaseзаписываетusers.json(пользователи, хэши паролей, идентификаторы OAuth) иdump.sql(pg_dumpсхемы, структуры и данныхpublic) - Восстановить —
aura db restore dump.sqlвоспроизводит дамп в связанный проект. - Импортировать пользователей —
aura auth import users.json; пользователи сохраняют свой идентификатор и пароль - 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 --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_URL | DATABASE_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% совместимы без изменений:
// Стандартная функция Deno — работает как есть на Aurabase.
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(
JSON.stringify({ message: `Hello ${name}!` }),
{ headers: { 'content-type': 'application/json' } }
)
})