본문으로 건너뛰기

ClickHouse 클라이언트

HTTP로 분석 쿼리를 실행하고, 실행 계획과 파이프라인을 확인하고, MergeTree 파트와 파티션을 관리하세요.

한눈에 보기

쿼리 언어
SQL
드라이버
Mac 앱에 포함
연결 방식
호스트 및 포트, SSH 터널, SSL/TLS
기본 포트
8123
최소 버전
없음
ClickHouse에 연결된 Mac의 TablePro. 분석 쿼리와 그 결과가 표시됩니다.

연결

호스트, HTTP 포트, 사용자, 선택적인 데이터베이스를 입력하세요. 재연결 없이 데이터베이스를 전환할 수 있으며, 열린 탭은 시작한 데이터베이스를 유지합니다.

SSL 모드를 선택하면 연결이 HTTPS로 전환됩니다. 포트가 443이나 ClickHouse Cloud가 쓰는 8443이면 Verify Identity가 켜져 CA 파일이나 시스템 신뢰 저장소로 인증서를 검사합니다. Verify CA에는 CA 파일이 필요하며, 클라이언트 인증서와 키로 상호 TLS를 요구하는 서버에 접근합니다.

TLS 없이 원격 서버에 접근한다면 네트워크로 평문 HTTP를 보내는 대신 SSH 터널을 사용하세요.

쿼리 및 편집

Explain 메뉴는 Plan, Pipeline, AST, Syntax, Estimate를 제공합니다. 들여쓰기 출력은 다이어그램이나 트리로 그려지며, Estimate는 쿼리가 읽을 행, 마크, 파트를 보여 줍니다. 실행 중인 쿼리는 지금까지 읽은 행 수를 표시하고, Stop은 KILL QUERY를 보내며, 연결의 쿼리 제한 시간이 서버에 전달됩니다.

삽입과 UPDATE, DELETE 변이는 그리드에서 실행됩니다. 저장 성공은 적용이 아니라 접수되었다는 뜻이므로 진행 상황은 system.mutations에서 확인하세요. 구체화된 뷰는 읽기 전용입니다. point와 ring 튜플은 지도 보기로 열리며, 자체 FORMAT 절이 있는 쿼리는 서버의 원시 출력을 한 열에 보여 주므로 그리드를 보려면 해당 절을 빼세요.

테이블, 파트 및 모니터링

테이블은 Structure, Indexes, DDL, Parts 탭으로 열립니다. Indexes는 정렬 키와 데이터 스킵 인덱스를, DDL은 엔진과 설정을 포함한 전체 CREATE TABLE을 보여 주며, Parts는 system.parts를 읽고 Optimize, Drop Partition, Detach Partition을 제공합니다. Structure 탭은 열을 변경하고 데이터 스킵 인덱스를 삭제합니다. 정렬 키와 기본 키는 테이블 생성 시 고정되므로 데이터 스킵 인덱스는 ALTER TABLE … ADD INDEX로 추가하고, 다른 변경은 테이블을 다시 만드세요.

Server Dashboard는 활성 쿼리, 병합, 파트 변이, 디스크 사용량을 보여 주고, 다른 세션을 종료하며, system.query_log에서 1초 넘게 걸린 완료 쿼리를 나열합니다.

이 페이지는 ClickHouse에만 해당하는 내용을 다룹니다. Safe Mode, AI 도우미, MCP 서버 등 TablePro의 나머지 기능은 기능 페이지에서 볼 수 있습니다.

그 밖에

  • 데이터 이동

    CSV, TSV, JSON, JSONL, XLSX 및 SQL 파일을 가져오고 테이블이나 결과를 CSV, JSON, SQL, XLSX, Markdown, HTML 및 XML로 내보내세요. 유효하지 않은 UTF-8 값이 하나라도 있는 열은 16진수로 표시됩니다. 텍스트로 읽으려면 toValidUTF8(column)을 선택하세요.

  • 제한 사항

    • ClickHouse의 HTTP 인터페이스로 연결하며 네이티브 TCP 프로토콜은 사용하지 않습니다.
    • TLS는 기본적으로 꺼져 있습니다. HTTPS를 사용하려면 연결 양식에서 SSL 모드를 선택하세요.
    • 외래 키와 트랜잭션은 없습니다.
    • SET 문은 다음 쿼리로 이어지지 않습니다.
  • 쿼리 하나의 설정은 어떻게 바꾸나요?

    SELECT … SETTINGS max_threads = 4처럼 쿼리에 SETTINGS 절을 넣으세요. 각 명령문은 별도의 HTTP 요청이므로 따로 실행한 SET은 다음 명령문에 남지 않습니다.

  • 9000 포트로 연결되지 않는 이유는 무엇인가요?

    9000은 ClickHouse의 네이티브 TCP 포트이며 TablePro는 이 포트를 쓰지 않습니다. HTTP 포트나 ClickHouse Cloud의 HTTPS 포트 8443으로 연결하세요. HTTP 인터페이스가 켜져 있으면 해당 포트의 /ping 요청에 Ok.가 반환됩니다.

TablePro 받기

이 페이지의 모든 기능은 무료입니다.