본문으로 건너뛰기

Data Mart

데이터 마트를 생성, 관리, 새로고침하는 API입니다. SQL 기반 데이터 마트 정의, 유효성 검사, 미리보기, 새로고침 이력 기능을 제공합니다.

엔드포인트​

GET /api/v1/data-marts​

설명: 데이터 마트 목록을 반환합니다. 페이지네이션을 지원합니다.

GET /api/v1/data-marts/{mart_id}​

설명: 특정 데이터 마트의 상세 정보를 반환합니다.

POST /api/v1/data-marts​

설명: 새 데이터 마트를 생성합니다. (HTTP 201)

요청 본문:

필드타입필수설명
namestringY마트 이름
sqlstringY마트 정의 SQL
schedulestringN새로고침 스케줄 (cron 표현식)

PUT /api/v1/data-marts/{mart_id}​

설명: 데이터 마트를 수정합니다.

DELETE /api/v1/data-marts/{mart_id}​

설명: 데이터 마트를 삭제합니다.

POST /api/v1/data-marts/{mart_id}/refresh​

설명: 데이터 마트를 즉시 새로고침합니다.

GET /api/v1/data-marts/{mart_id}/preview​

설명: 데이터 마트의 미리보기 데이터를 반환합니다.

POST /api/v1/data-marts/validate-sql​

설명: 데이터 마트 SQL의 유효성을 검사합니다.

GET /api/v1/data-marts/{mart_id}/history​

설명: 데이터 마트의 새로고침 이력을 반환합니다.

인증​

JWT Bearer 토큰이 필요합니다.

에러 코드​

코드설명
400잘못된 SQL 또는 마트 설정
404데이터 마트를 찾을 수 없음
500SQL 실행 또는 새로고침 실패