ClickHouse
ClickHouse 데이터베이스에 연결하여 고성능 분석 쿼리를 실행할 수 있습니다.
주요 기능
- 고성능 분석 쿼리 실행
- 컬럼형 데이터베이스 최적화
- 대용량 데이터 처리
- 실시간 데이터 분석
- 집계 함수 및 윈도우 함수 지원
- 읽기 전용 모드 지원
기본 정보
인증 방식
사용자명/비밀번호를 사용하여 인증합니다.
입력 파라미터
- Host (필수): ClickHouse 서버 호스트
- Port (필수): ClickHouse 서버 포트 (기본값: 8123)
- Username (필수): ClickHouse 사용자명
- Password (필수): ClickHouse 비밀번호
- Database (선택): 연결할 데이터베이스명 (기본값: default)
- Connection Timeout (선택): 연결 타임아웃 시간 (기본값: 30000ms, 최대값: 60000ms)
- Use SSL (선택): SSL 연결 사용 여부
- Read Only (선택): 읽기 전용 모드 활성화 여부
지원하는 MCP 도구
execute_sql
ClickHouse 데이터베이스에 SQL 쿼리를 실행하고 결과를 반환합니다.
읽기 전용 모드에서는 다음 SQL 명령어만 허용됩니다:
SELECT
- 데이터 조회WITH
- CTE(Common Table Expression) 사용EXPLAIN
- 쿼리 실행 계획 조회ANALYZE
- 쿼리 분석SHOW
- 메타데이터 조회
결과 제한: 성능상의 이유로 최대 500행까지만 반환됩니다.
예를 들어,
- Prompt로 “사용자 테이블의 데이터를 조회해줘” 라고 입력하면,
- LLM은 MCP를 통해
SELECT * FROM users
쿼리를 실행합니다. - 그리고, Tool 호출 결과를 기반으로 채팅에서 응답합니다.
ClickHouse 연결 설정 방법
- ClickHouse 서버에 접근 가능한 사용자 계정을 준비합니다.
- 필요한 데이터베이스 권한을 부여합니다.
- 네트워크 접근 권한을 설정합니다.
- QueryPie AI에서 ClickHouse 통합을 선택합니다.
- 연결 정보를 입력하여 설정을 완료합니다.
주의사항
- ClickHouse 사용자 계정의 비밀번호는 안전하게 보관하세요.
- 필요한 최소한의 데이터베이스 권한만 부여하는 것을 권장합니다.
- 프로덕션 환경에서는 SSL 연결을 사용하는 것을 권장합니다.
- 대용량 쿼리 결과는 500행으로 제한되므로 적절한 LIMIT 절을 사용하세요.
- 읽기 전용 모드를 활성화하여 데이터 변경을 방지할 수 있습니다.
Last updated on