데이터베이스: PostgreSQL, MySQL, Valkey.
프로젝트용 관리형 데이터베이스: 연결 변수, 최근 7일 내 원하는 분 단위 시점으로 복원, 디스크 알림, 외부 접속, 테이블·쿼리·가져오기·내보내기가 있는 데이터 탭, 읽기 복제본을 안내합니다.
프로젝트에 데이터베이스를 추가하면 애플리케이션이 자동으로 연결됩니다. 비밀번호를 복사할 필요가 없습니다. 백업, 복원, 디스크 알림도 모두 관리해 드립니다.
개요 → 서비스 → 서비스 추가를 누른 다음 선택하세요.
| 엔진 | 용도 |
|---|---|
| PostgreSQL 17 | 대부분의 애플리케이션 |
| MySQL 8.4 | MySQL용으로 만든 애플리케이션 |
| Valkey 8 | 큐, 캐시, 세션을 위한 Redis 호환 저장소 — Horizon, Celery, BullMQ, Sidekiq |
이름(예: db)을 정하고 리소스를 선택하세요. 새 데이터베이스는 메모리 1GB, CPU 1코어, 디스크 10GB로 시작하며 요금은 **월 ₩14,704**입니다. 다른 서비스와 같은 방식으로 요금이 정해집니다. 메모리 GB당 ₩8,822, 코어당 ₩5,882, 메모리 1GB당 디스크 10GB 포함, 초과분은 **GB당 ₩221**입니다.
연결: 설정할 것이 없습니다
프로젝트의 서비스는 프로젝트 사설 네트워크 안에서 이름으로 데이터베이스에 접속합니다. 접속 정보는 이미 변수로 들어 있습니다.
- PostgreSQL / MySQL:
DATABASE_URL,DB_CONNECTION,DB_HOST,DB_PORT,DB_DATABASE,DB_USERNAME,DB_PASSWORD, PostgreSQL은 추가로PGHOST,PGPORT,PGDATABASE,PGUSER,PGPASSWORD. - Valkey:
REDIS_URL,REDIS_HOST,REDIS_PORT,REDIS_PASSWORD,REDIS_CLIENT. - 모든 데이터베이스는
RIVERVO_<NAME>_URL도 제공합니다. 이름이db인 데이터베이스는RIVERVO_DB_URL입니다.
데이터베이스의 개요 → 연결에 호스트, 포트, 데이터베이스, 사용자와 프로젝트가 받는 변수 목록이 표시됩니다. 애플리케이션은 다음 배포 때 변수를 가져옵니다.
두 번째 데이터베이스. 종류별로 첫 번째 데이터베이스만 일반적인 변수 이름을 받습니다. 프로젝트에 이미 데이터베이스가 있으면 새 데이터베이스는 자체 RIVERVO_<NAME>_URL만 추가하고, 애플리케이션은 계속 첫 번째 데이터베이스를 사용합니다. 전환하려면 변수 탭에서 DATABASE_URL과 DB_*를 새 데이터베이스의 값으로 설정하세요.
백업과 분 단위 시점 복원
PostgreSQL과 MySQL은 연속으로 백업됩니다. 모든 변경 사항이 발생하는 즉시 저장되므로 최근 7일 내 원하는 분 단위 시점으로 되돌릴 수 있습니다. 매일 전체 사본도 만듭니다. 모든 데이터는 데이터베이스와 분리되어 암호화된 상태로 보관됩니다.
복원 방법: 데이터베이스의 백업 탭 → 특정 시점으로 복원에서 날짜와 시간(기간 시작부터 몇 분 전까지의 원하는 분)을 선택한 다음 이 시점으로 복원을 누르세요. 아래 목록에는 매일 사본(과 지금 백업으로 만든 사본)이 있으며, 각각 복원할 수 있습니다.
복원하기 전에 항상 현재 상태를 먼저 백업하므로 복원은 언제든 되돌릴 수 있습니다. 복원하는 동안 데이터베이스를 잠시 사용할 수 없으며, 진행 상황은 관리 패널에 표시됩니다.
Valkey는 매일 백업되며, 최근 7일분과 4주분을 보관합니다.
복원은 계정 소유자와 애플리케이션 관리자가 할 수 있습니다.
애플리케이션 자체 백업
메인 애플리케이션에는 디스크에 보관하는 파일(예: 업로드 파일이나 Laravel SQLite 데이터베이스)을 위한 별도의 백업 탭이 있습니다. 매일 백업되어 암호화된 상태로 보관되며, 최근 7일분과 4주분을 보관합니다. 지금 백업으로 언제든 추가 사본을 만들 수 있습니다.
디스크: 고정 한도와 경고
데이터베이스 디스크는 선택한 크기 그대로입니다. 사용량이 **80%**와 **90%**에 도달하면, 그리고 가득 차면 다시 이메일(Telegram을 연결했다면 Telegram)로 알려 드립니다. 디스크가 가득 차도 데이터베이스는 멈추지 않고 계속 응답하지만, 디스크를 늘릴 때까지 새 데이터를 저장할 수 없습니다.
디스크 추가: 데이터베이스의 설정 → 리소스에서 디스크 슬라이더를 움직이고 적용을 누르세요. 잠깐이면 완료되며 재시작이 필요 없습니다.
외부 접속
기본적으로 데이터베이스에는 프로젝트의 서비스만 접속할 수 있습니다. 내 컴퓨터, BI 도구, 다른 서버에서 접속하려면 데이터베이스의 개요 → 외부 접속 → 접속 허용을 여세요.
- 접속을 허용할 주소를 추가하세요. 단일 IP(
203.0.113.7) 또는 네트워크(198.51.100.0/24)를 입력할 수 있습니다. 내 주소 추가를 누르면 지금 사용 중인 주소가 추가됩니다. - 주소 저장. 관리 패널에 외부 호스트, 포트, 연결 문자열이 표시됩니다.
외부 연결은 데이터베이스 자체 주소용 인증서로 암호화됩니다.
- PostgreSQL은 암호화된 외부 연결만 허용합니다.
- Valkey는 TLS 연결만 허용합니다.
- MySQL은 암호화를 제공합니다. 클라이언트에서 켜세요(SSL 모드 “required”).
접속 차단을 누르면 외부 연결이 즉시 끊기며, 프로젝트의 서비스는 그대로 작동합니다. 접속 허용과 차단은 계정 소유자와 애플리케이션 관리자가 할 수 있습니다.
데이터 탭
모든 데이터베이스에는 데이터 탭이 있어, 아무것도 설치하지 않고 데이터를 보고 작업할 수 있습니다.
테이블과 쿼리 (PostgreSQL, MySQL)
- 테이블 — 원하는 테이블을 페이지당 50행씩 읽기 전용으로 볼 수 있습니다. 테이블 찾기로 목록을 필터링합니다.
- SQL 편집기 — 데이터베이스 자체 사용자로 쿼리를 실행합니다. 읽기 쿼리는 바로 실행되고, 데이터를 변경하는 문은 확인을 요청합니다. 쿼리당 최대 30초, 1,000행입니다.
키와 명령 (Valkey)
패턴(예: user:*)으로 키를 찾아보고 값을 확인하며, 일반 Valkey 구문으로 명령을 한 번에 하나씩 실행할 수 있습니다. 데이터를 변경하는 명령은 확인을 요청합니다. FLUSHALL, FLUSHDB, CONFIG, SHUTDOWN, DEBUG와 스크립트는 여기서 사용할 수 없습니다.
가져오기
데이터 → 가져오기 및 내보내기 → 데이터 가져오기에서 세 가지 소스 중 하나를 선택하세요.
- 파일에서 —
.sql또는.sql.gz, PostgreSQL은pg_dump -Fc아카이브(.dump)도 가능합니다. 최대 2GB(데이터베이스 디스크 크기 이하)이며, 업로드가 끝날 때까지 페이지를 열어 두세요. - 링크에서 — 로그인 없이 열리는 덤프 파일 링크(예: 스토리지의 임시 링크). 큰 덤프는 스트리밍되므로 디스크에 들어가는 크기라면 모두 가능합니다.
- 다른 데이터베이스에서 — 인터넷에서 접속 가능한 같은 종류의 다른 데이터베이스: PostgreSQL에서 PostgreSQL로, MySQL 또는 MariaDB에서 MySQL로. 먼저 연결을 확인한 다음 데이터를 바로 복사합니다. 비밀번호는 이 복사에만 사용되며 보관하지 않습니다.
가져오기 전에는 항상 현재 데이터를 백업하므로 언제든 백업 탭에서 복원할 수 있습니다. 가져온 테이블과 기타 객체는 같은 이름의 기존 객체를 대체하며, 나머지는 그대로 유지됩니다. 그동안 데이터베이스는 계속 작동하며 페이지를 닫아도 됩니다.
내보내기
내보내기 → 사본 만들기를 누르면 새 사본을 준비합니다. PostgreSQL은 아카이브(.dump, pg_restore로 복원), MySQL은 압축 SQL 파일(.sql.gz)입니다. 사본이 준비되면 다운로드 링크가 표시되며 24시간 동안 유효합니다.
권한
데이터 탭(데이터 조회, 편집기에서 변경, 가져오기와 내보내기)은 계정 소유자와 애플리케이션에서 개발자 또는 관리자 역할을 가진 사람이 사용할 수 있습니다. 뷰어 역할은 데이터를 볼 수 없습니다. 애플리케이션 접근 권한을 참고하세요.
읽기 복제본 (PostgreSQL, MySQL)
읽기 복제본은 모든 변경 사항을 몇 초 안에 따라가는 데이터베이스 사본입니다. 보고서, 분석, 내보내기 등 무거운 읽기 작업을 복제본으로 보내면 기본 데이터베이스는 쓰기 작업에서 빠른 속도를 유지합니다.
데이터베이스의 개요 → 읽기 복제본 → 읽기 복제본 추가. 데이터베이스당 최대 2개의 복제본을 만들 수 있습니다.
- 복제본은 전체 데이터 사본을 보관하므로 디스크가 기본 데이터베이스 이상이어야 합니다.
- 프로젝트는 복제본 이름에 따른 자체 변수
RIVERVO_<NAME>_URL을 받으며,DATABASE_URL은 기본 데이터베이스를 그대로 가리킵니다. - 첫 복사는 데이터 크기에 따라 몇 분이 걸리며, 그동안 기본 데이터베이스는 계속 작동합니다.
- 복제본은 읽기 쿼리만 받습니다. 백업과 시점 복원은 기본 데이터베이스에서만 가능합니다.
- 관리 패널에 복제 지연이 표시됩니다(최신 상태 또는 초 단위 지연). 5분 동안 1분 넘게 지연되면 알려 드리고 직접 원인을 살펴봅니다.
복제본도 다른 서비스와 마찬가지로 자체 리소스에 따라 요금이 청구됩니다.
복제본 승격
복제본의 설정 → 승격. 복제본은 기본 데이터베이스 추적을 영구히 멈추고, 쓰기를 받기 시작하며, 자체 백업을 갖게 됩니다. 약 1분이 걸립니다. 프로젝트의 DATABASE_URL은 원래 데이터베이스를 그대로 가리킵니다. 애플리케이션을 승격된 데이터베이스로 옮기려면 변수 탭에서 DATABASE_URL과 DB_*를 변경하세요.