본문으로 바로가기
본문으로 바로가기

DBeaver를 ClickHouse에 연결하기

Partner Integration

DBeaver는 여러 에디션으로 제공됩니다. 이 가이드에서는 DBeaver Community를 사용합니다. 다양한 에디션과 기능은 여기에서 확인할 수 있습니다. DBeaver는 JDBC를 사용하여 ClickHouse에 연결합니다.

참고

ClickHouse에서 Nullable(널 허용) 컬럼에 대한 지원이 개선된 DBeaver 23.1.0 이상 버전을 사용하십시오.

1. ClickHouse 정보 준비하기​

DBeaver는 HTTP(S)를 통한 JDBC를 사용하여 ClickHouse에 연결합니다. 다음 정보가 필요합니다.

  • 엔드포인트
  • 포트 번호
  • 사용자 이름
  • 비밀번호

2. DBeaver 다운로드​

DBeaver는 https://dbeaver.io/download/에서 다운로드할 수 있습니다.

3. 데이터베이스 추가​

  • Database > New Database Connection 메뉴 또는 Database Navigator의 New Database Connection 아이콘을 사용하여 Connect to a database 대화 상자를 엽니다.
새 데이터베이스 추가

  • Analytical을 선택한 다음 ClickHouse를 선택합니다.

  • JDBC URL을 구성합니다. Main 탭에서 Host, Port, Username, Password, Database를 설정합니다.

호스트 이름, 포트, 사용자, 비밀번호, 데이터베이스 이름 설정
  • 기본적으로 SSL > Use SSL 속성은 설정되어 있지 않습니다. ClickHouse Cloud 또는 HTTP 포트에서 SSL이 필요한 서버에 연결하는 경우 SSL > Use SSL을 활성화합니다.
필요한 경우 SSL 활성화
  • 연결을 테스트합니다.
연결 테스트

DBeaver에서 ClickHouse 드라이버가 설치되어 있지 않은 것을 감지하면 드라이버 다운로드를 제안합니다.

ClickHouse 드라이버 다운로드
  • 드라이버를 다운로드한 후 Test를 클릭하여 다시 연결을 테스트합니다.
연결 테스트

4. ClickHouse에서 쿼리 실행​

쿼리 편집기를 열어 쿼리를 실행합니다.

  • 연결을 마우스 오른쪽 버튼으로 클릭한 후 SQL Editor > Open SQL Script를 선택하여 쿼리 편집기를 엽니다:
SQL 편집기 열기
  • system.query_log에 대한 예시 쿼리:
예시 쿼리

다음 단계​

DBeaver의 기능을 알아보려면 DBeaver wiki를 참고하고, ClickHouse의 기능을 알아보려면 ClickHouse 문서를 참고하십시오.