Supabase에서 마이그레이션
클라이언트 API, RLS 정책 및 Edge Functions가 이어집니다. CLI는 bcrypt 비밀번호 해시를 사용하여 Supabase 사용자를 내보내고 일반 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 웹훅 및 전용 엔드포인트 |
| 서비스 역할 키 | 동일 | 동일한 역할, 동일한 범위 |
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에 의미가 없는 항목을 건너뛰고 그 이유를 설명합니다: 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 연결 1개 |
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.users 테이블에 유지하지 않으므로 REFERENCES auth.users(id)와 같은 외래 키가 실패합니다. --continue-on-error로 복원하고 해당 제약 조건 없이 user_id 열을 유지합니다. 사용자 ID는 아래 가져오기에 의해 보존되므로 값은 여전히 일치합니다.
사용자 및 비밀번호#
aura migrate export-supabase는 auth.users 및 auth.identities를 읽고 각 사용자에 대해 원본 ID, 이메일, email_verified, bcrypt 해시 encrypted_password의, 이름 및 메타데이터(raw_user_meta_data)를 씁니다. , 및 Supabase의 자체 provider/providers 키가 없는 raw_app_meta_data 및 연결된 OAuth ID(Google, GitHub…). 파일은 귀하만 읽을 수 있도록 작성되었습니다. 이 파일에는 비밀번호 해시가 포함되어 있으므로 가져온 후 삭제하세요.
aura auth import users.json는 사용자를 1,000명씩 일괄적으로 관리자 가져오기 API로 보내고 생성되지 않은 모든 줄을 인쇄합니다(이메일 또는 ID가 이미 존재하는 경우skipped, 이유와 함께 error). 다시 실행해도 안전합니다. 기존 사용자를 덮어쓰지 않습니다.
로그인 시 Aurabase Auth는 bcrypt 해시를 확인한 다음 이를 Argon2id 해시로 바꿉니다. 사용자는 비밀번호를 유지하고 아무 작업도 하지 않습니다. 가져오기에서는 비용이 4에서 12(Supabase는 10을 사용)인 bcrypt 해시 $2a$, $2b$ 및 $2y$와 제한된 매개변수가 있는 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' } }
)
})