DynamoDB를 로컬에서 실행할 수 있나요?
예. AWS는 Docker 이미지, Java 실행 파일 또는 Apache Maven 종속성으로 사용자 컴퓨터에서 실행되는 무료 다운로드 버전의 DynamoDB인 DynamoDB Local을 제공합니다. 웹 서비스와 동일한 API를 노출하므로 오프라인으로 개발하고 테스트한 다음, 코드가 AWS를 가리키도록 간단히 전환할 수 있습니다.
실행하는 세 가지 방법
- Docker 이미지 — 가장 일반적인 선택:
docker run한 번이면 로컬 포트에서 엔드포인트가 구동됩니다. - 다운로드 아카이브 — 직접 실행하는 Java 애플리케이션(JRE 필요).
- Apache Maven 종속성 — JVM 테스트 스위트에 임베드합니다.
로컬에서 개발하는 이유
데이터베이스가 컴퓨터에 자체 포함되므로 처리량, 데이터 스토리지, 데이터 전송 요금을 절약할 수 있으며 — 개발 중 인터넷 연결도 필요 없습니다. 배포할 준비가 되면 코드에서 로컬 엔드포인트를 제거하면 DynamoDB 웹 서비스를 가리킵니다.
차이점에 유의하세요
DynamoDB Local은 API를 에뮬레이트하지만 프로덕션 엔진은 아닙니다 — AWS는 사용 노트에 동작상의 차이를 문서화합니다(예를 들어 처리량이 강제되지 않음). 성능 모델이 아니라 기능적 개발/테스트 대체물로 취급하세요.
더 알아보기
DynamoDB Local 가이드는 설정을 단계별로 안내하며, 로컬 및 LocalStack 연결 가이드는 GUI를 여기에 연결하는 방법을 보여줍니다 — DynoTable은 AWS에 연결하는 것과 정확히 동일하게 로컬 엔드포인트에 연결합니다. 표현식 빌더로 첫 쿼리를 테스트하세요.
참고 자료
- Setting up DynamoDB local (downloadable version) — Amazon DynamoDB Developer Guide
- DynamoDB local usage notes — Amazon DynamoDB Developer Guide
- Deploying DynamoDB locally on your computer — Amazon DynamoDB Developer Guide
Last verified 2026-07-13 against the official AWS documentation linked above.