개발 및 프로덕션 데이터베이스

​

두 데이터베이스 비교

​

게시할 때 프로덕션 데이터베이스 만들기

• 현재 인프라(Helium): 개발 데이터베이스에 데이터가 있는 경우, 게시할 때 Replit이 프로덕션 데이터베이스를 자동으로 만들어줍니다.
• 레거시 Neon 개발 데이터베이스: 게시 설정에서 프로덕션 데이터베이스를 직접 만듭니다. 게시하는 동안 Database settings를 열고 Create production database를 켜세요. 개발 데이터를 함께 복사하려면 Set up your production database with your current development data를 추가로 켜세요.

​

앱이 사용하는 데이터베이스 확인하기

• Project Editor: 워크스페이스, Shell, Agent 세션에서 DATABASE_URL은 개발 데이터베이스를 가리킵니다. Replit이 자동으로 연결하므로 현재 인프라에서는 Secrets에 표시되지 않습니다.
• 게시된 앱: 게시하면 앱은 프로덕션 데이터베이스를 가리키는 별도의 DATABASE_URL을 갖게 됩니다.

​

Agent에게 확인 요청하기

Check which database my app uses, without showing any secret values or changing anything:
1. Find the environment variable my code reads to connect to its database (for example DATABASE_URL) and show me the file and line.
2. Check whether my Secrets include a DATABASE_URL I added myself or any other database connection, and list only the names.
3. Run a read-only query on my production database: list its tables and show the five newest rows in my main table, so I can compare them with my live app.

​

Database 도구와 Publishing에서 확인하기

1

프로덕션 데이터베이스 열기

Database 도구에서 All Databases 옆의 데이터베이스 메뉴를 열고 Production을 선택하세요.

2

라이브 앱의 레코드 찾기

My Data를 열고 게시된 앱에서 최근에 만든 항목(예: 새 계정이나 주문)을 찾아보세요. 보인다면 게시된 앱이 이 데이터베이스에 기록하고 있는 것입니다. 프로덕션은 읽기 전용 모드로 열리므로 탐색해도 안전합니다.

3

연결 설정 비교하기

프로덕션 데이터베이스의 Settings 탭을 열고 Connection string을 찾으세요. 그런 다음 Publishing을 열고 Adjust settings를 선택한 뒤 Production app secrets 아래에서 DATABASE_URL을 찾으세요. 각 값을 표시하여 두 값이 같은 호스트를 가리키는지 확인하세요. 대부분의 앱에서는 엔드포인트 ID, 즉 ep-로 시작하는 부분이 같다는 뜻입니다. 풀링된 주소는 ID 뒤에 -pooler가 붙으므로 전체 문자열이 정확히 일치하지 않아도 됩니다.

두 값 모두 데이터베이스 비밀번호를 포함합니다. 직접 비교하고, 채팅, 지원 티켓, 스크린샷에 붙여넣지 마세요.

4

다른 데이터베이스가 있는지 Secrets 확인하기

Secrets를 여세요. Replit의 기본 제공 연결은 여기에 표시되지 않습니다. 직접 추가한 DATABASE_URL이나 SUPABASE_DATABASE_URL 같은 다른 데이터베이스 연결이 보인다면, 앱이 대신 그 데이터베이스를 사용하고 있을 수 있습니다. 코드가 어느 것을 읽는지 Agent에게 물어보세요. NEON_DATABASE_URL 시크릿은 데이터베이스 인프라 업그레이드 중에 저장된 이전 개발 데이터베이스 연결입니다. 코드가 이를 읽는 경우에만 앱이 사용합니다.

​

결과의 의미

​

연결 풀링

​

프로덕션 데이터베이스를 안전하게 변경하기

• 여전히 데이터가 들어 있는 열 또는 테이블 제거
• 기존 값이 변환되지 않으면 실패할 수 있는 열 데이터 타입 변경
• 이미 행이 있는 테이블에 기본값 없이 필수 필드 추가
• 테이블 또는 열 이름 변경: Publish가 물어볼 때 이름 변경을 확인하지 않으면 데이터가 삭제됩니다
• 기존 행이 위반할 수 있는 테이블에 고유 제약 조건 추가

​

게시 프리뷰로 변경 사항 테스트하기

• 데이터베이스 변경 사항이 적용된 상태에서 주요 사용자 흐름 전반에 걸쳐 앱이 계속 제대로 작동하는지 확인
• 기존 데이터가 올바르게 마이그레이션되었고 새 필드에 예상 값이 포함되어 있는지 확인
• 쿼리 응답 시간에서 성능 저하가 없는지 확인

​

청구 및 리소스 사용량

​

프로덕션 데이터베이스 제거하기

​

레거시 개발 데이터베이스

​

데이터베이스 인프라 업그레이드

• 더 낮은 지연 시간과 더 많은 저장 공간: 데이터베이스가 앱과 함께 Replit 인프라에서 실행되며, 저장 용량 한도가 10GB에서 20GB로, Pro 및 Enterprise 요금제에서는 50GB로 늘어납니다.
• 동일한 데이터베이스 엔진: 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 연결 오류

// Before (breaks after upgrade)
const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  ssl: { rejectUnauthorized: false },
});

// After (works in both development and production)
const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  ssl:
    process.env.NODE_ENV === "production"
      ? { rejectUnauthorized: false }
      : false,
});

​

데이터베이스를 공유한 포크된 앱

​

다음 단계

• Publish가 프로덕션 데이터베이스를 업데이트하는 방법: 게시할 때 스키마 변경 사항을 검토, 테스트, 승인합니다.
• 데이터 복구: 개발 또는 프로덕션 데이터를 복원합니다.
• 연결 세부 정보: 데이터베이스의 연결 문자열을 찾습니다.
• 데이터로 작업하기: 데이터를 탐색, 편집, 쿼리합니다.