가장 빠른 시작 방법은 Agent에게 앱에 데이터베이스를 추가해 달라고 요청하는 것입니다. Agent가 연동을 설정하고, 데이터베이스 스키마를 만들고, 데이터를 저장하고 조회하도록 앱을 업데이트합니다.
기능
Replit 데이터베이스 도구는 다음 기능을 제공합니다:- 데이터베이스 도구: 내장 SQL 도구로 쿼리를 실행하고, 데이터베이스 스키마를 관리하고, 데이터를 시각화합니다
- 시간 여행: 롤백 기능을 사용하여 데이터베이스를 Agent 체크포인트 상태로 복원합니다
- 무료 스토리지: 모든 Replit 앱에 20GB의 무료 스토리지가 포함됩니다
- 환경 변수: Replit 앱의 환경 변수를 사용하여 데이터베이스에 안전하게 접근합니다
2025년 12월 4일 이전에는 개발 데이터베이스가 Neon에 호스팅되었으며 몇 가지 중요한 차이점이 있습니다.
자세한 내용은 레거시 Neon 개발 데이터베이스 섹션을 참조하세요.
사용법
프로젝트 편집기에서 직접 Replit 데이터베이스 도구에 접근할 수 있습니다. 다음 섹션에서 데이터베이스 설정 및 관리 방법을 안내합니다.Replit 데이터베이스 도구 접근 방법
Replit 데이터베이스 도구 접근 방법
왼쪽 도구 독에서:
모든 도구를 선택하여 프로젝트 편집기 도구 목록을 확인합니다.
데이터베이스를 선택합니다.
- 상단의
돋보기를 선택하여 검색 도구를 엽니다 - “Replit Database”를 입력하여 도구를 찾고 결과에서 선택합니다.
데이터베이스 추가
모든 Replit 앱에는 기본적으로 데이터베이스가 포함되어 있습니다. 프로젝트 편집기에서 데이터베이스 도구를 선택하여 접근할 수 있습니다.
Agent에게 Replit 앱에 PostgreSQL 데이터베이스를 추가해 달라고 요청하여 앱과 데이터베이스를 연동할 수 있습니다. Replit 앱이 저장해야 할 데이터에 대한 세부 사항을 포함하세요. Agent가 데이터베이스 스키마를 만들고 데이터베이스와 통신하도록 앱을 업데이트합니다.
데이터베이스를 이전 상태로 복원
롤백 기능을 사용하여 앱과 데이터베이스를 이전 상태로 되돌릴 수 있습니다. 이 기능을 사용하면 Agent가 만든 체크포인트 상태로 데이터베이스를 복원할 수 있습니다.
체크포인트 상태로 복원할 때 “추가 롤백 옵션”에서 “데이터베이스”를 선택하세요. 이렇게 하면 체크포인트 시점의 데이터베이스 상태로 복원됩니다.
데이터베이스 명령 실행
SQL 실행기는 데이터베이스에서 SQL 명령을 실행하고 결과를 확인할 수 있는 프로젝트 편집기 도구입니다.SQL 실행기 접근 방법
SQL 실행기 접근 방법
Replit 데이터베이스 도구에서:
- 내 데이터 탭을 선택합니다
SQL 실행기를 선택합니다
실행 버튼을 선택합니다:
데이터 시각적으로 탐색 및 수정
Replit 데이터베이스 도구에는 데이터를 시각적으로 탐색하고 수정할 수 있는 Drizzle Studio가 포함되어 있습니다. 이 시각화 도구는 구문 오류를 방지하고 다음 기능을 제공합니다:- 특정 정보에 집중하기 위한 데이터 필터링 및 정렬
- 외부 사용을 위한 파일로 데이터 내보내기
- 행 데이터 삽입 또는 수정
- 스키마, 테이블, 뷰, 열거형 생성 및 관리
연결 자격 증명 및 사용량 확인
데이터베이스 연결 자격 증명은 Replit 앱의 환경 변수로 저장됩니다. 이 자격 증명은 앱이 데이터베이스에 안전하게 연결하고 명령을 실행하는 데 사용됩니다.데이터베이스 연결 자격 증명 접근 방법
데이터베이스 연결 자격 증명 접근 방법
- 프로젝트 편집기에서 Replit 데이터베이스 도구로 이동합니다
- 개발 또는 프로덕션 데이터베이스를 선택합니다
설정 탭(기어 아이콘)을 선택합니다. 이 탭에서 데이터베이스의 연결 자격 증명과 스토리지 사용량을 확인할 수 있습니다.
환경 변수
개발 데이터베이스 연결을 위해 다음 환경 변수를 사용할 수 있습니다:DATABASE_URL: 데이터베이스에 연결하고 인증하는 방법
DATABASE_URL은 앱에서만 사용할 수 있으며, 유출되더라도 다른 사람이 데이터베이스에 접근하거나 수정하는 데 사용할 수 없습니다.
개발 데이터베이스가 여전히 레거시 Neon 인프라에 있다면 다음 추가 환경 변수도 사용할 수 있습니다:
PGHOST, PGUSER, PGPASSWORD, PGDATABASE, PGPORT. 이러한 개별 연결 변수는 Replit의 현재 인프라에서 호스팅되는 데이터베이스에는 제공되지 않습니다 — 대신 DATABASE_URL을 사용하세요.이
DATABASE_URL은 앱 범위로 제한되어 있으므로, 개발 데이터베이스는 본인 소유의 앱이나 외부 데이터베이스 뷰어를 포함하여 다른 앱에서 접근할 수 없습니다.
이 분리는 보안 모범 사례를 따르며 데이터베이스에 대한 무단 접근을 방지합니다.보안 기능
Agent를 사용하여 데이터베이스 연동을 추가하면 내장 보안 기능이 있는 ORM(Object-Relational Mapper)이 추가되어 모든 데이터베이스 통신을 처리합니다. 이 ORM 계층은 Agent의 보안 모범 사례 구현과 결합하여 다음 기능으로 앱을 보호합니다:- 스키마 검증: 데이터가 예상 형식을 준수하는지 확인
- 데이터 살균: 빌더 입력을 자동으로 정리하여 SQL 인젝션 공격 방지
레거시 개발 데이터베이스
2025년 12월 4일 이전에는 개발 데이터베이스가 Neon에 호스팅되었습니다. 이 데이터베이스는 이제 더 이상 사용되지 않으며 모든 새 개발 데이터베이스는 Replit 자체 데이터베이스 인프라에 호스팅됩니다.DATABASE_URL 환경 변수를 확인하여 개발 데이터베이스가 Neon에 호스팅되어 있는지 확인할 수 있습니다.
DATABASE_URL에 neon.tech/neondb가 포함되어 있으면 개발 데이터베이스가 아직 Neon에 호스팅되어 있는 것입니다.
helium/heliumdb가 포함되어 있으면 개발 데이터베이스가 Replit에 호스팅되어 있는 것입니다.| 기능 | Replit (현재) | Neon (레거시) |
|---|---|---|
| 호스팅 | Replit 자체 인프라에 호스팅 | Neon(서드파티 제공업체)에 호스팅 |
| 결제 | 모든 Replit 앱에 무료로 포함 | 사용량 기반 청구. 자세한 내용은 게시 및 데이터베이스 청구를 참조하세요. |
| 복원 기능 | 롤백 기능을 사용하여 데이터베이스를 모든 체크포인트로 복원 | PITR(포인트인타임 복구) — 백업 보존 기간 내의 임의 시점으로 복구. |
| 연결 보안 | 앱 내에서만 접근 가능, 공개적으로 노출되지 않음. | 전체 연결 문자열 사용 — 유출되면 누구나 데이터베이스에 접근하고 수정할 수 있음. |
| 리믹스 동작 | 리믹스 시 격리 및 보안을 위해 복사된 데이터가 있는 새 개발 데이터베이스 생성. | 리믹스 시 모든 복사본이 동일한 데이터베이스를 재사용하므로 리믹스의 변경 사항이 원본 앱에 영향을 줄 수 있음. |
| 데이터베이스 생성 | 각 Replit 앱마다 자동으로 생성. | 명시적 설정 필요. |
| 게시 워크플로 | 배포 또는 게시 시 환경 간 격리를 위해 프로덕션 데이터베이스 생성 필요. | 개발과 프로덕션이 동일한 데이터베이스를 공유하여 의도치 않은 개발 변경이 프로덕션 앱에 영향을 줄 수 있음. |