데이터베이스 업그레이드

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

​

변경되는 사항

• 낮은 지연 시간: 데이터베이스가 앱과 함께 Replit 인프라에서 실행되어 연결 시간 단축
• 더 많은 스토리지: 스토리지 한도가 10 GB에서 20 GB로 증가
• 동일한 데이터베이스 엔진: Helium은 Neon과 동일한 버전인 PostgreSQL 16을 사용 — 쿼리, 스키마, 데이터가 동일하게 작동
• 원활한 연결: DATABASE_URL 환경 변수가 자동으로 업데이트되어 Helium을 가리킴
• Neon 연결 저장: 이전 Neon 연결 문자열이 참조용으로 Secrets의 NEON_DATABASE_URL에 저장됩니다. 이전 Neon 데이터베이스는 업그레이드 후 앱에서 더 이상 사용되지 않으며 임시 유예 기간 후 삭제될 예정입니다.

​

업그레이드 중 예상되는 사항

1. “데이터베이스를 업그레이드하는 중” 메시지와 함께 진행 화면이 나타납니다
2. 데이터가 Neon에서 Helium으로 안전하게 복사됩니다. 전송 중 데이터가 변경되거나 손실되지 않습니다.
3. 소요 시간은 데이터베이스 크기에 따라 다릅니다 — 대용량 데이터베이스의 경우 몇 분에서 몇 시간이 걸릴 수 있습니다
4. 탭을 열어두거나 닫고 나중에 돌아올 수 있습니다
5. 업그레이드가 완료되면 확인 대화 상자가 나타납니다: “데이터베이스를 업그레이드했습니다!”

​

업그레이드 후 해야 할 일

• 하드코딩된 Neon 연결 문자열: 코드에서 neon.tech 연결 문자열을 직접 참조하는 경우, JavaScript에서는 process.env.DATABASE_URL, Python에서는 os.environ['DATABASE_URL']과 같이 DATABASE_URL 환경 변수를 사용하도록 업데이트하세요.
• 사용자 정의 PostgreSQL 역할: Neon에서 사용자 정의 데이터베이스 역할을 생성한 경우, 해당 역할과 권한이 자동으로 마이그레이션됩니다. 단, 역할 비밀번호는 복사할 수 없으므로 새 Helium 데이터베이스에서 사용자 정의 역할의 비밀번호를 재설정해야 합니다.
• 개별 PG 환경 변수: PGHOST, PGPORT, PGUSER, PGPASSWORD 환경 변수는 업그레이드 후 제거됩니다. 연결에 필요한 모든 정보가 포함된 DATABASE_URL 연결 문자열을 사용하세요.

​

문제 해결

​

업그레이드 후 SSL 연결 오류

// 이전 (업그레이드 후 작동 안 함)
const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  ssl: { rejectUnauthorized: false },
});

// 이후 (개발 및 프로덕션 모두에서 작동)
const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  ssl:
    process.env.NODE_ENV === "production"
      ? { rejectUnauthorized: false }
      : false,
});

​

공유 데이터베이스를 사용하는 배포된 앱

​

다음 단계

• 공유 데이터베이스를 사용하는 게시된 앱 수정

• 게시된 앱이 여전히 이전 Neon 연결을 사용하는지 확인하는 방법
• 프로덕션 데이터베이스 생성과 함께 게시 또는 재게시를 사용하는 경우
• 게시된 앱이 이전 공유 데이터베이스에 의존하는 경우 데이터를 수동으로 내보내고 가져오는 방법
• 다운타임, 활성 쓰기, 사용자 정의 PostgreSQL 역할에 대한 중요 주의 사항

​

자주 묻는 질문

​

다음 단계

• 데이터베이스: Replit 데이터베이스 도구와 데이터베이스 관리 방법 알아보기
• 프로덕션 데이터베이스: 프로덕션 데이터베이스가 개발 데이터베이스와 어떻게 다른지 이해하기