🏠
ClickHouse
분석 데이터베이스 데이터베이스 및 스토리지설치 명령어
npx clawhub@latest install clickhouse
설치 안내
1
환경 확인
Node.js 22 이상과 OpenClaw가 설치되어 있는지 확인하세요. 터미널에서 openclaw --version을 실행하여 확인할 수 있습니다.
2
설치 실행
위의 설치 명령어를 터미널에서 실행하세요. ClawHub가 자동으로 ClickHouse을(를) ~/.openclaw/skills/ 디렉토리에 다운로드하고 설치합니다.
3
설치 확인
openclaw skills list를 실행하여 설치된 스킬 목록을 확인하고, ClickHouse이(가) 목록에 표시되는지 확인하세요.
4
매개변수 설정 (선택사항)
아래 소개의 설정 안내에 따라 ~/.config/openclaw/openclaw.json5에 스킬 설정 항목을 추가하세요.
수동 설치 방법: Skill 폴더를
~/.openclaw/skills/ 또는 프로젝트의 skills/ 디렉토리에 복사하세요. 폴더에 SKILL.md 파일이 포함되어 있어야 합니다.
고성능 컬럼형 쿼리
테이블 구조 및 인덱스 탐색
쿼리 성능 분석 및 최적화 제안
상세 소개
ClickHouse MCP 서버는 ClickHouse 컬럼형 분석 데이터베이스에 대한 읽기 전용 쿼리 능력을 제공하며, 대규모 시계열 데이터 및 로그 데이터의 실시간 분석에 적합하여 초당 수십억 행의 쿼리 성능을 발휘합니다.
핵심 기능
- 읽기 전용 쿼리(run_select_query): SELECT 쿼리를 실행하며, 데이터 안전을 위해 자동으로 읽기 전용으로 제한. ClickHouse 고유 함수 및 구문 지원
- Schema 탐색: 데이터베이스, 테이블, 컬럼 정보 나열, 테이블 엔진 유형(MergeTree/ReplacingMergeTree 등) 및 파티션 설정 조회
- 쿼리 분석: 쿼리 실행 계획 및 성능 병목 분석, 최적화 제안 제공
- 시스템 정보: 클러스터 상태, 노드 정보, 시스템 지표 조회
설정 방법
{
"mcpServers": {
"clickhouse": {
"command": "npx",
"args": ["-y", "@clickhouse/mcp-server"],
"env": {
"CLICKHOUSE_HOST": "https://your-instance.clickhouse.cloud",
"CLICKHOUSE_USER": "default",
"CLICKHOUSE_PASSWORD": "your-password"
}
}
}
}
사용 시나리오
- 로그 분석: PB급 로그 데이터 쿼리 및 분석으로 문제 신속 파악
- 실시간 리포트: 시계열 데이터에 대한 실시간 집계 분석으로 리포트 생성
- 사용자 행동 분석: 클릭스트림 및 사용자 이벤트 데이터 분석
- 성능 모니터링: 애플리케이션 및 인프라 성능 지표 데이터 쿼리