제품
기능
하나의 기본 단위와 그 주변의 수명주기. 여기 있는 항목은 모두 출시되어 프로덕션에서 돌아가고 문서화되어 있습니다.
기본 단위
격리된 데이터베이스 셀
프로젝트마다 전용 PostgreSQL 프로세스. 스토리지, 자격 증명, CPU·메모리 한도도 전용입니다. 공유 데이터베이스 안의 스키마가 아닙니다.
Postgres 16 / 17 / 18직접 연결과 풀링 연결
직접 포트에는 평범한 postgres:// URL, 풀링 포트에는 서버리스와 엣지 런타임용 트랜잭션 풀러. 같은 데이터베이스에 문이 둘.
5432 / 6432확장 기능
셀 단위로 켜는 선별 카탈로그. 패키지 버전에 뒤처지지 않도록 데이터베이스 안에서 최신으로 유지됩니다.
카탈로그격리와 보안
사설 네트워크 네임스페이스, 표준 셀의 아웃바운드 차단, SCRAM은 보관이 아니라 중계, API 키는 해시로만 저장.
구조상
작업 흐름
프리뷰 데이터베이스
데이터베이스 전체 사본을 덤프가 아니라 복제로. 수명이 정해져 있고, 풀 리퀘스트마다 하나씩, 병합되면 정리됩니다.
복제가져오기와 마이그레이션
다른 매니지드 제공자나 자체 서버에서 데이터베이스를 옮겨 오세요. 전환 시점까지 동기화를 유지하는 팔로우 모드가 있습니다.
거의 무중단스키마 도구와 타입 생성
CLI에서 스키마를 덤프하고 비교하며, 실행 중인 데이터베이스에서 TypeScript 타입·Zod 스키마·Drizzle 정의를 생성합니다.
ts / zod / drizzleStudio
대시보드 안의 SQL 편집기. 스키마 탐색과 린팅을 제공합니다. WHERE 없는 UPDATE나 DELETE는 실행 전에 멈추고 클릭 한 번으로 복원 지점을 만들 수 있으며, 모든 쓰기는 확인을 거칩니다.
브라우저에서
에이전트
에이전트가 하는 설정
프롬프트 하나로 Claude Code, Cursor, Copilot이 호스팅된 런북을 따라 CLI를 설치하고 셀을 프로비저닝하고 env 파일을 씁니다. 승인은 브라우저 탭에서 한 번이면 됩니다.
agents.mdMCP 서버
stdio 또는 원격 HTTP 위의 도구가 대시보드와 같은 API를 호출합니다. 프로젝트, 연결, SQL, 스키마, 프리뷰, 백업, 복원 지점, 가져오기, 워크스페이스까지.
@capydb/mcp브라우저 도구
WebMCP를 지원하는 브라우저에서는 대시보드가 이미 로그인한 세션 위에 에이전트용 도구를 등록합니다. 키도 서버도 필요 없고, 모든 쓰기는 대화상자의 승인을 기다립니다.
WebMCP에이전트 안전 루프
범위가 없는 쓰기는 실행 전에 거부됩니다. WHERE 없는 UPDATE나 DELETE, 그리고 TRUNCATE입니다. 잘못된 변경은 프리뷰로 복원되며 프로덕션 위에 덮어쓰지 않습니다. 프로덕션 덮어쓰기는 어떤 표면에서도 에이전트 도구가 아닙니다.
복원 지점
키-값
K/V 저장소
데이터베이스와 같은 리전에서, 자체 격리된 셀 안에서 동작하는 키-값 저장소입니다. 속도 제한, 세션, 큐, 캐시에 사용하거나 데이터베이스 없이 단독으로 사용할 수 있습니다.
Valkey 기반속도 제한
@upstash/ratelimit을 통한 슬라이딩 윈도, 고정 윈도, 토큰 버킷 제한기입니다. 데이터베이스 바로 옆, 같은 리전에 있는 저장소에 질의합니다.
슬라이딩 윈도이미 쓰고 있는 클라이언트
Upstash REST 프로토콜과 RESP를 모두 지원합니다. @upstash/redis는 REST로 기본 설정 그대로 동작합니다. Redis 클라이언트는 TLS로 연결하며 호스트 이름을 TLS 서버 이름(SNI)으로 보내야 합니다. redis-py와 go-redis는 알아서 보내고, ioredis와 redis-cli는 설정 하나가 필요합니다. 새로 도입할 CapyDB 전용 클라이언트는 없습니다.
Redis® OSS 호환
운영
백업과 특정 시점 복원
노드 밖으로의 지속적 아카이빙과 보관 기간 내 임의 시점 복원, 그리고 그 복원이 실제로 되는지 확인하는 정기 검증.
PITR모니터링
셀별 리소스 사용량, 연결 수, 쿼리 단위 드릴다운. 장애에 실제로 선행하는 조건에 알림을 걸 수 있습니다.
셀 단위알림
장애에 실제로 선행하는 조건 — 스토리지 압박, 오래된 백업, 연결 포화 — 을 이메일이나 직접 운영하는 웹훅으로.
웹훅 / 이메일유휴 시 일시 중지
건드리지 않은 셀은 잠들어 노드 자원을 더 이상 쓰지 않습니다. 다음 연결이 깨우며, 보통 약 0.3초 걸립니다.
스케일 투 제로