// HTTP 인터페이스 · 분석

Mac, Windows 및 Linux용 ClickHouse 클라이언트

ClickHouse를 트랜잭션 데이터베이스인 척하지 않고 ClickHouse를 제대로 이해하는 네이티브 ClickHouse 클라이언트입니다: 정확한 와이드 정수, 인덱스가 프루닝한 파트와 그레인을 보여 주는 실행 계획, 쿼리 로그 인사이트, ClickHouse에 동등한 기능이 없으면 정직하게 거부합니다.

연결 방식
ClickHouse의 HTTP 인터페이스
기본 포트
8123 또는 TLS 사용 시 8443
로그인
ClickHouse 사용자명과 비밀번호
URL 붙여넣기
clickhouse://user:password@host:8123/database

SQLly가 ClickHouse에서 하는 일

ClickHouse에 대응하는 기능이 있는 SQLly 도구는 ClickHouse의 시스템 테이블을 기반으로 동작합니다. 대응이 없는 도구는 - ClickHouse에는 트랜잭션이 없고, 행 단위 업데이트도, 인덱스 사용 카운터도 없습니다 - 중간에 실패하는 대신 그 사실을 알려 줍니다.

모든 자릿수를 지키는 결과

결과는 ClickHouse가 보내는 대로 그리드로 스트리밍됩니다. 큰 정수와 소수는 정확한 자릿수를 그대로 유지하고, 배열·튜플·맵은 JSON 텍스트로 보이며, 다중 명령문 스크립트는 결과 집합이나 기록된 행 수를 각각 보고합니다.

스트리밍 결과 →

인덱스 가지치기를 보여 주는 실행 계획

예상 계획은 ClickHouse의 JSON EXPLAIN 그리고 각 인덱스가 프루닝한 파트와 그래뉼 개수를 보여줍니다 - 기본 키와 스킵 인덱스가 제 구실을 하고 있는지 알려주는 숫자입니다.

실행 계획 →

실시간 쿼리, 종료(Kill) 기능

활동 모니터는 현재 실행 중인 쿼리를 나열하고 종료할 수 있으며, 쿼리 탭에서 Cancel을 누르면 서버에서 쿼리를 중단할 수 있고, Query Insights는 쿼리 로그를 읽어 상위 쿼리와 최근 실패를 확인합니다.

활동 모니터 →

MergeTree의 특성을 지키는 구조 편집

테이블 구조 편집기는 ADD, DROP, RENAME 그리고 MODIFY COLUMN 데이터 스킵 인덱스까지 다루고, 키가 바뀐 부분은 수동 검토 대상으로 표시합니다. ClickHouse로의 데이터 전송은 MergeTree 테이블을 만듭니다.

데이터 전송 →

BACKUP, RESTORE 및 OPTIMIZE

백업 / 복원은 BACKUP 그리고 RESTORE DATABASE 을 서버의 백업 디스크에 저장하고, 유지 관리 메뉴가 실행하는 것은 OPTIMIZE TABLE … FINAL 테이블의 파트를 병합합니다.

백업 / 복원 →

사용자 및 권한, 스크립트화됨

읽기 전용 보안 뷰는 ClickHouse 사용자, 역할, 권한을 보여 주고 CREATE USER 그리고 GRANT 검토하고 실행할 문장으로 만들어 줍니다 - ClickHouse 접근 제어는 본래 자리인 SQL에 그대로 남습니다.

보안 →

ClickHouse에 연결

  1. SQLly 다운로드 macOS, Windows, Linux용은 다음에서 다운로드 페이지 그리고 실행하세요.
  2. 연결을 만들고 ClickHouse를 선택합니다. SQLly는 ClickHouse의 HTTP 인터페이스를 사용하므로 포트 기본값은 8123입니다(TLS 사용 시 8443).
  3. 호스트, 사용자, 비밀번호, 선택적으로 데이터베이스 입력, 또는 다음을 붙여넣거나 clickhouse://user:password@host:8123/database URL. 비밀번호는 OS 키체인에 저장됩니다.
  4. TLS 모드를 선택하세요 그리고 프라이빗 서버라면 SSH 터널, 프록시, Kubernetes 포트 포워딩도 됩니다 - PostgreSQL과 MySQL에서와 똑같이 동작합니다.
  5. 테스트, 저장 및 연결, 그런 다음 트리에서 데이터베이스를 둘러보고, 탐색기의 도구 하위 메뉴나 명령 팔레트에서 도구를 여세요.

ClickHouse의 모든 SQLly 도구

이것은 앱이 메뉴를 켜고 끌 때 쓰는 것과 동일한 엔진 매트릭스입니다. 그러니 여기서 읽는 내용이 곧 실제 동작입니다. 어떤 도구가 ClickHouse에 맞지 않으면 앱이 이유를 알려주고, 이 문서도 마찬가지입니다.

SQLly 도구와 ClickHouse 지원 여부
도구 ClickHouse
탐색기, IntelliSense 및 호버 카드 예
예상 실행 계획 예 EXPLAIN json = 1, indexes = 1: 각 인덱스가 건너뛴 파트와 그래뉼을 보여줌.
활동 모니터 예 실행 중인 쿼리, Kill 지원.
쿼리 인사이트 예 쿼리 로그: 상위 쿼리와 최근 실패.
서버 대시보드 예
디스크 사용량 및 객체 브라우저 예
유지 관리 메뉴 예 OPTIMIZE TABLE … FINAL.
스키마 비교 및 스키마 히스토리 예
데이터 비교 예
데이터 전송 예 테이블은 MergeTree로 생성됩니다.
테스트 데이터 생성기 예
테이블 구조 편집기 예 열과 데이터 스킵 인덱스; 키 변경은 수동 검토 대상으로 표시됩니다.
보안 편집기(사용자, 역할, 권한) 부분적 CREATE USER와 GRANT 문을 스크립트로 만들어 주는 읽기 전용 뷰.
백업 / 복원 예 서버의 backups 디스크에 대해 BACKUP / RESTORE DATABASE를 실행합니다.
SSH 터널, 프록시 및 Kubernetes 포트 포워딩 예
읽기 전용 연결 예
결과 그리드에서 행 편집 아니요 ClickHouse에는 행 단위 UPDATE나 DELETE가 없습니다. 쿼리 탭에서 ALTER TABLE … UPDATE / DELETE를 사용하세요.
실제(실행) 계획 아니요 ClickHouse에는 EXPLAIN ANALYZE가 없습니다. 실행 결과의 행, 바이트, 메모리는 Query Insights에서 확인하세요.
인덱스 분석기 아니요 인덱스 사용 카운터 없음; 예상 실행 계획에서 인덱스 프루닝을 확인하세요.
데이터베이스 생성 및 삭제 대화 상자 아니요 쿼리 탭에서 CREATE DATABASE / DROP DATABASE 사용.
프로시저 모드 아니요 SQL Server와 PostgreSQL만 지원합니다.
SQL 에이전트, 확장 이벤트 및 안내형 디자이너 아니요 SQL Server 및 Azure SQL 전용입니다.
자동 롤백 안전 래핑 아니요 ClickHouse에는 트랜잭션이 없으므로 SQLly는 래퍼로 감싸 실행하는 것을 거부합니다.

SQLly에서 ClickHouse에 대한 질문

SQLly는 ClickHouse의 어떤 포트에 연결합니까?

SQLly는 ClickHouse의 HTTP 인터페이스로 통신합니다: 기본 포트는 8123이고 TLS 사용 시 8443입니다. SSH 터널, SOCKS 및 HTTP 프록시, Kubernetes 포트 포워드, 네 가지 TLS 모드는 PostgreSQL과 MySQL에서와 똑같이 작동합니다.

결과 그리드에서 ClickHouse 행을 편집할 수 있나요?

아니요. ClickHouse에는 행 수준의 UPDATE나 DELETE가 없기 때문에 그리드 내 행 편집은 제공되지 않습니다. 행을 변경하려면 쿼리 탭에서 ALTER TABLE … UPDATE 또는 DELETE를 사용하세요. 테이블 구조 편집기는 ADD, DROP, RENAME 및 MODIFY COLUMN과 데이터 스킵 인덱스는 처리할 수 있습니다.

실행 중인 ClickHouse 쿼리를 보고 중지할 수 있나요?

예. 활동 모니터는 실행 중인 쿼리를 나열해 종료할 수 있고, 쿼리 탭의 취소는 서버에서 쿼리를 중지하며, 쿼리 인사이트는 쿼리 로그를 읽어 상위 쿼리와 최근 실패를 보여 줍니다.

자동 롤백 설정이 ClickHouse에서 작동하지 않는 이유는 무엇인가요?

ClickHouse에는 트랜잭션이 없어 래퍼를 롤백해도 아무것도 되돌릴 수 없고 모든 변경이 그대로 남습니다. 이 설정을 켜면 SQLly는 ClickHouse 연결에서 문 실행을 거부하며 그 이유를 알려 줍니다. 안전하다는 착시를 주지 않기 위해서입니다.

// 내 ClickHouse에서 직접

ClickHouse를 돼지 집으로 데려오세요

SQLly는 macOS, Windows 및 Linux에서 무료로 시작할 수 있으며, 계정이 필요하지 않습니다.