
두 데이터베이스 비교
Agent는 프로덕션 데이터베이스를 수정할 수 없습니다. 이는 프로덕션 데이터베이스를 안전하게 유지하기 위한 제한입니다.Agent는 개발 데이터베이스를 수정할 수 있습니다. 게시 시점에, Agent가 개발 데이터베이스의 구조(열/테이블 추가 및 삭제)에 적용한 모든 변경 사항은 프로덕션 데이터베이스에도 적용됩니다.언제든지 Database 도구를 열고, 프로덕션 데이터베이스를 선택한 다음 My Data를 열고 Edit을 토글하면 프로덕션 데이터를 수동으로 편집할 수 있습니다.
게시할 때 프로덕션 데이터베이스 만들기
게시된 앱은 빌드할 때 사용하는 개발 데이터베이스와는 별도로, 자체 프로덕션 데이터베이스를 갖게 됩니다.- 현재 인프라(Helium): 게시하는 동안 필요한 경우 Replit이 프로덕션 데이터베이스를 자동으로 만들어줍니다. 별도로 설정할 필요가 없습니다.
- 레거시 Neon 개발 데이터베이스: 게시 설정에서 프로덕션 데이터베이스를 직접 만듭니다. 게시하는 동안 Production database settings를 열고 Create production database를 켜세요. 개발 데이터를 함께 복사하려면 Set up your production database with your current development data를 추가로 켜세요.

Publishing의 프로덕션 데이터베이스 설정
프로덕션 데이터베이스를 안전하게 변경하기
데이터베이스 변경 사항이 포함된 업데이트를 게시할 때, 다운타임이나 데이터 손실을 피하려면 일부 변경 사항에 신중한 계획이 필요합니다.게시 중에 게시된 앱에서 짧은 다운타임이 발생할 수 있습니다. 데이터베이스 변경 사항을 적용하는 동안 충돌을 방지하고 데이터를 보호하기 위해 앱을 일시적으로 중지해야 할 때가 있습니다.
- 애플리케이션 코드가 여전히 참조하는 데이터베이스 열 제거
- 기존 코드가 처리할 수 없는 방식으로 열 데이터 타입 변경
- 기존 테이블에 기본값 없이 필수 필드 추가
- 기존 쿼리를 깨뜨리는 테이블 또는 열 이름 변경
- 기존 애플리케이션 로직을 거부할 수 있는 제약 조건 수정
배포 프리뷰로 변경 사항 테스트하기
배포 프리뷰는 실제 사용자에게 영향을 주기 전에 데이터베이스 변경 사항과 애플리케이션 업데이트를 테스트할 수 있는, 프로덕션 환경의 임시적이고 격리된 복사본입니다. 다음과 같은 용도로 사용하세요.- 데이터베이스 변경 사항이 적용된 상태에서 주요 사용자 흐름 전반에 걸쳐 앱이 계속 제대로 작동하는지 확인
- 기존 데이터가 올바르게 마이그레이션되었고 새 필드에 예상 값이 포함되어 있는지 확인
- 쿼리 응답 시간에서 성능 저하가 없는지 확인
청구 및 리소스 사용량
프로덕션 데이터베이스는 서버리스 데이터베이스 제공업체인 Neon을 통한 사용량 기반으로 청구됩니다. 데이터베이스는 5분간 활동이 없으면 유휴 상태로 전환되어 컴퓨팅 시간 청구가 일시 중지되며, 쿼리를 받으면 즉시 다시 활성화됩니다. Database 도구의 랜딩 화면에는 Billing Period와 Hours of Compute Used가 표시됩니다. 데이터베이스별 저장 공간 사용량을 보려면 해당 데이터베이스의 Settings 탭을 여세요. 모든 Replit App에서의 사용량을 확인하려면 Settings → Account → Account usage를 열고 PostgreSQL Storage와 PostgreSQL Compute 행을 확장하세요. Replit이 데이터베이스 사용량에 대해 청구하는 방법을 알아보려면 배포 및 데이터베이스 요금을 참고하세요.프로덕션 데이터베이스 제거하기
데이터베이스를 제거하는 방법
데이터베이스를 제거하는 방법
Database 도구에서:
- 데이터베이스를 선택한 다음 Settings 탭을 여세요
- Remove database를 선택하고 Yes, Remove database를 선택하여 확인하세요
레거시 개발 데이터베이스
2025년 12월 4일 이전에는 개발 데이터베이스가 Neon에서 호스팅되었습니다. 모든 새로운 개발 데이터베이스는 Replit 자체 인프라(Helium)에서 호스팅됩니다. 앱이 어느 쪽을 사용하는지는 Settings 탭에서 확인할 수 있습니다.DATABASE_URL에 neon.tech가 포함되어 있으면 레거시 Neon이고, helium이 포함되어 있으면 현재 인프라입니다.
데이터베이스 인프라 업그레이드
Replit은 개발 데이터베이스를 Neon에서 Replit 자체의 관리형 PostgreSQL 인프라인 Helium으로 업그레이드하고 있습니다. 이 업그레이드는 자동으로 진행되며, Project Editor에서 앱을 열 때 앱마다 한 번 실행되고, 모든 데이터를 보존합니다. 다음이 변경됩니다.- 더 낮은 지연 시간과 더 많은 저장 공간: 데이터베이스가 앱과 함께 Replit 인프라에서 실행되며, 저장 용량 한도가 10GB에서 20GB로 늘어납니다.
- 동일한 데이터베이스 엔진: Helium은 Neon과 동일한 버전인 PostgreSQL 16을 사용합니다. 쿼리, 스키마, 데이터가 동일하게 작동합니다.
- 연결이 자동으로 업데이트됨:
DATABASE_URL이 Helium을 가리키도록 업데이트됩니다. 이전 Neon 연결 문자열은 참고용으로 Secrets에NEON_DATABASE_URL로 저장됩니다. - 개별 PG 변수 제거:
PGHOST,PGPORT,PGUSER,PGPASSWORD가 제거됩니다. 대신DATABASE_URL을 사용하세요.
- 하드코딩된 Neon 연결 문자열:
neon.tech연결 문자열을 참조하는 코드를 대신DATABASE_URL환경 변수를 사용하도록 업데이트하세요. - 커스텀 PostgreSQL 역할: 역할과 권한은 자동으로 마이그레이션되지만 비밀번호는 복사할 수 없습니다. 새 데이터베이스에서 커스텀 역할의 비밀번호를 재설정하세요.
업그레이드 후 SSL 연결 오류
The server does not support SSL connections 같은 오류가 표시된다면, 연결 코드가 SSL 핸드셰이크를 강제하고 있는 것입니다. Neon은 SSL이 필요했지만, Helium은 앱과 함께 로컬에서 실행되며 SSL을 사용하지 않습니다. SSL 설정을 환경에 따라 조건부로 설정하세요.
데이터베이스를 공유한 포크된 앱
레거시 Neon 시스템에서는 앱을 포크하면 원본 앱의DATABASE_URL이 복사되어, 두 앱과 그 게시된 버전이 동일한 데이터베이스에 연결되었습니다. 공유된 레거시 데이터베이스는 2026년 6월 8일에 종료되었습니다. 게시된 앱이 작동을 멈추거나 데이터 접근 권한을 잃었다면 공유 데이터베이스를 사용하는 게시된 앱 수정하기 또는 지원팀 문의를 참고하세요.