Azure Cosmos DB Playground: 브라우저에서 쿼리를 배우고 실험하기
Source: Dev.to
위에 제공된 링크에 포함된 전체 텍스트를 알려주시면, 해당 내용을 한국어로 번역해 드리겠습니다. (코드 블록, URL 및 마크다운 형식은 그대로 유지됩니다.)
인터랙티브 브라우저 기반 환경으로 쿼리 학습, 테스트 및 공유
Azure Cosmos DB Playground는 Azure Cosmos DB SQL 쿼리를 학습하고 실험할 수 있는 인터랙티브한 브라우저 기반 도구입니다—설정, 설치 또는 클라우드 비용이 전혀 필요 없습니다. Azure Cosmos DB vNext 에뮬레이터에서 실행되며, 백그라운드에서는 오픈소스 codapi 프로젝트를 사용합니다.
플레이그라운드는 다음에 이상적입니다:
- 미리 로드된 데이터셋과 바로 실행할 수 있는 쿼리 예제 탐색
- 자체 JSON 데이터를 붙여넣거나 업로드하여 맞춤 시나리오 테스트
- 쿼리 결과를 즉시 확인하고 데이터나 쿼리를 실시간으로 수정
- 현재 데이터셋과 쿼리를 포함하는 공유 가능한 링크 생성
- 페이지 새로 고침 후 마지막 세션을 자동으로 복원
- 문서, 블로그, 튜토리얼 등에 삽입할 수 있는 인터랙티브하고 실행 가능한 예제 HTML 파일에 임베드
Note: This is an experimental project, not an official Microsoft or Azure offering. It is intended for learning and sharing, not for production use.
빠른 데모
시작하기
호스팅된 플레이그라운드를 방문하고 바로 실험을 시작하세요:
자체 인스턴스 배포
플레이그라운드를 Azure에서 실행하거나 Docker Compose를 사용해 로컬에서 실행할 수 있습니다. 이 프로젝트는 완전히 컨테이너화되어 있습니다; 자체 인스턴스를 설정하려면 GitHub 저장소의 배포 지침을 따르세요.
- HTTP(s) 액세스 구성: 보안 액세스를 활성화하기 위한 GitHub 지침을 확인하세요.
플레이그라운드 기능
- 예시 쿼리가 포함된 사전 로드된 데이터셋
- 사용자 정의 JSON 데이터를 업로드하거나 붙여넣기
- 즉시 결과 표시 및 실시간 편집
- 상태를 유지하는 공유 가능한 URL
- 자동 세션 복원
- 삽입 가능한 인터랙티브 예제
기능은 변동될 수 있습니다—최신 목록은 GitHub 저장소를 확인하세요.
Architecture Overview
+-------------------+ +-------------------+ +-------------------+
| User Browser | | nginx | | Codapi |
| (playground.html) | | (Reverse Proxy) | | (Sandbox Server) |
+-------------------+ +-------------------+ +-------------------+
|
v
+--------------------------+
| Ephemeral Query Container|
| (Python + Cosmos SDK) |
+--------------------------+
|
v
+--------------------------+
| Cosmos DB Emulator |
| (Docker Container) |
+--------------------------+핵심 구성 요소
Azure Cosmos DB vNext 에뮬레이터
로컬 Docker 컨테이너로 Azure Cosmos DB (SQL API) 서비스를 에뮬레이션하여 클라우드 리소스 없이도 쿼리와 데이터 모델을 실험할 수 있습니다.
Codapi
대화형 문서와 코드 예제를 위한 경량 샌드박스 서버입니다. 플레이그라운드에서 Codapi는:
- 각 쿼리 실행을 위해 격리된 Docker 컨테이너를 관리합니다
- 프론트엔드를 위한 JavaScript 위젯(
codapi-js)을 제공합니다 - 격리를 보장하기 위해 사용자 코드를 일시적인 환경에서 실행합니다
Query Execution Flow
- nginx가 프런트엔드를 제공하고 API 요청을 Codapi로 전달합니다.
- 각 쿼리 실행마다 Codapi가 임시 쿼리 Docker 컨테이너를 생성합니다.
- 이 컨테이너 안에서 Python 컴포넌트가 장시간 실행되는 Cosmos DB 에뮬레이터에 연결합니다.
- 임시 Cosmos DB 컨테이너가 생성되어 사용자의 데이터가 시드된 후, 쿼리가 실행되고 결과가 반환됩니다.
- 실행이 끝나면 임시 Cosmos DB 컨테이너와 쿼리 컨테이너가 모두 정리됩니다.
제한 사항
- 작은 규모의 데이터셋을 위해 설계되었으며, 데이터 양이 많아지면 성능이 저하될 수 있습니다.
- 프로덕션 워크로드용으로 설계되지 않았습니다.
- 제한 사항 및 제약 조건은 변경될 수 있으니 최신 정보를 위해 GitHub 저장소를 참고하십시오.
피드백 및 기여
제안이 있거나 기여하고 싶으신가요? GitHub 저장소를 방문하고, 이슈를 열거나, 풀 리퀘스트를 제출하세요.
즐거운 쿼리 되세요!