Community연구 & 데이터 분석github.com

FrankChen021/datastoria

AI 기반 ClickHouse 콘솔: 클러스터 진단, 쿼리 생성 및 최적화, 데이터 시각화를 지원합니다.

datastoria란 무엇인가요?

이 스킬은 ClickHouse 데이터베이스를 위한 AI 네이티브 콘솔 도구로, 개발자와 데이터 엔지니어가 클러스터 상태를 진단하고, SQL 쿼리를 생성 및 최적화하며, 데이터를 시각화할 수 있도록 도와줍니다. 주요 기능으로는 클러스터 상태 모니터링, 쿼리 성능 분석, 인덱스 및 스키마 추천, 그리고 데이터 시각화 대시보드 제공 등이 포함됩니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼과 호환되며, 자연어 명령을 통해 복잡한 ClickHouse 작업을 간편하게 수행할 수 있습니다. SKILL.md 문서에는 설치 방법, 설정, 사용 예시 및 API 참조가 상세히 기술되어 있어 사용자가 쉽게 시작할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add FrankChen021/datastoria

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

datastoria은(는) 무엇을 하나요?

AI 기반 ClickHouse 콘솔: 클러스터 진단, 쿼리 생성 및 최적화, 데이터 시각화를 지원합니다.

기능

  • 클러스터 진단: 클릭하우스 클러스터의 상태를 자동으로 진단하고 잠재적 문제를 식별합니다.
  • 쿼리 생성: 자연어 설명을 기반으로 최적화된 SQL 쿼리를 생성합니다.
  • 쿼리 최적화: 기존 쿼리를 분석하고 성능 개선을 위한 인덱스, 파티셔닝, 재작성 제안을 제공합니다.
  • 데이터 시각화: 쿼리 결과를 차트, 그래프, 테이블로 자동 시각화합니다.

설치 및 설정

  1. 최신 릴리스를 GitHub 릴리스 페이지에서 다운로드합니다.
  2. 환경 변수 CLICKHOUSE_HOST, CLICKHOUSE_PORT, CLICKHOUSE_USER, CLICKHOUSE_PASSWORD를 설정합니다.
  3. 다운로드한 바이너리를 실행합니다.
export CLICKHOUSE_HOST=localhost
export CLICKHOUSE_PORT=9000
export CLICKHOUSE_USER=default
export CLICKHOUSE_PASSWORD=비밀번호
./datastoria

사용 예시

클러스터 진단

datastoria diagnose

쿼리 생성

datastoria query "지난 7일 동안의 일일 활성 사용자 수를 보여주는 쿼리를 생성해줘"

쿼리 최적화

datastoria optimize "SELECT * FROM events WHERE event_date > '2024-01-01'"

데이터 시각화

datastoria visualize "SELECT toDate(timestamp) as day, count(*) as cnt FROM events GROUP BY day"

API 참조

  • diagnose – 클러스터 상태 진단
  • query – 자연어로 쿼리 생성
  • optimize – 쿼리 최적화 제안
  • visualize – 쿼리 결과 시각화

라이선스

MIT 라이선스 하에 제공됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

관련 스킬