본문으로 건너뛰기

TablePro를 매일 쓰시나요? 라이선스로 유료 기능을 사용하고 다음 릴리스 개발을 지원하세요. 라이선스 구매라이선스로 TablePro 후원하기

Mac용 ClickHouse 클라이언트

ClickHouse HTTP 인터페이스로 분석 SQL을 실행하고 쿼리 계획, 파이프라인과 예상 행 수를 확인하며 Parts 탭에서 MergeTree 파트와 파티션을 관리합니다. 긴 쿼리는 읽은 행 수를 보고하고 Stop은 서버에서 종료합니다.

Mac에서 사용 가능Mac 앱에 드라이버 포함

ClickHouse MergeTree 테이블의 Parts 탭. 파티션과 파트 및 각 행 수가 나열됩니다.

한눈에 보기

쿼리 언어
SQL
드라이버
Mac 앱에 포함
연결 방식
호스트 및 포트, SSH 터널, SSL/TLS
기본 포트
8123
iPhone과 iPad
열리지 않음

연결

호스트, HTTP 포트, 사용자와 선택적으로 데이터베이스를 입력합니다. 데이터베이스는 바로 전환되고 열린 탭은 시작한 데이터베이스에 남습니다. View > Sidebar as Tree는 서버의 데이터베이스를 펼칠 수 있는 트리로 표시합니다.

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

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

쿼리 및 편집

각 쿼리는 고유 ID와 진행 요청을 보내 긴 쿼리도 읽은 행 수를 보고합니다. Stop은 그 ID의 KILL QUERY를 보내며 연결의 쿼리 제한 시간도 서버에 전달됩니다.

Explain 메뉴는 Plan, Pipeline, AST, Syntax와 Estimate를 제공합니다. 들여쓰기 출력은 다이어그램이나 트리로 표시되며 Estimate는 읽을 행, 마크와 파트를 보여 줍니다.

그리드 편집은 Preview SQL 확인 후 INSERT, ALTER TABLE … UPDATE와 ALTER TABLE … DELETE로 전송됩니다. ClickHouse는 갱신·삭제를 백그라운드 뮤테이션으로 실행하므로 저장은 접수이지 적용 완료가 아닙니다. system.mutations에서 진행을 확인하며 구체화된 뷰는 읽기 전용입니다.

ClickHouse point나 ring 튜플 결과는 지도 보기로 열립니다. 자체 FORMAT 절을 가진 쿼리는 서버 원시 출력을 한 열에 보여 주므로 그리드를 보려면 해당 절을 빼세요.

테이블, 파트 및 파티션

테이블에는 Structure, Indexes, DDL과 Parts 탭이 있습니다. Indexes는 정렬 키와 데이터 스킵 인덱스를, DDL은 엔진·설정을 포함한 전체 CREATE TABLE을 보여 줍니다.

Parts는 system.parts의 모든 파트를 파티션, 행 수, 디스크 크기, 수정 시간과 active 플래그와 함께 나열하고 Optimize, Drop Partition과 Detach Partition을 실행합니다.

Structure 탭은 열 추가·수정·삭제와 데이터 스킵 인덱스 삭제를 지원합니다. 정렬 키와 기본 키는 생성 시 고정되므로 데이터 스킵 인덱스 추가는 ALTER TABLE … ADD INDEX를 쓰고 다른 변경은 테이블을 다시 만듭니다.

모니터링

Server Dashboard는 활성 쿼리·병합, 파트 뮤테이션과 디스크 사용량을 보여 주며 다른 세션마다 Terminate Session을 제공합니다. 느린 쿼리는 system.query_log에서 최근 완료한 1초 초과 쿼리를 읽습니다.

데이터 이동

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

iPhone과 iPad

iPhone과 iPad 앱에는 ClickHouse 드라이버가 없습니다. Mac에서 동기화한 ClickHouse 연결은 목록에 표시되지만 열리지 않습니다.

제한 사항

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

ClickHouse 관련 질문

쿼리 하나의 설정은 어떻게 바꾸나요?

SELECT … SETTINGS max_threads = 4처럼 쿼리 자체에 SETTINGS 절을 넣으세요. 각 구문은 세션 없는 HTTP 요청이므로 별도 SET은 다음 구문에 남지 않습니다.

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

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

TablePro 다운로드

Mac 앱은 무료로 다운로드하고 사용할 수 있습니다. Starter나 Team 플랜은 선택 기능을 추가합니다.
Mac용 다운로드

macOS 13 Ventura 이상 필요