DBeaver를 ClickHouse에 연결

DBeaver는 멀티 플랫폼 데이터베이스 도구입니다.

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

ClickHouse의 Nullable 컬럼 지원이 개선된 DBeaver 23.1.0 이상 버전을 사용하십시오.

​

1. ClickHouse 연결 정보 수집

DBeaver는 HTTP(S) 기반 JDBC를 사용해 ClickHouse에 연결하므로 다음 정보가 필요합니다.

• endpoint
• 포트 번호
• 사용자 이름
• 비밀번호

​

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이 필요한 server에 연결하는 경우 SSL > Use SSL을 켭니다:

• 연결을 테스트합니다:

DBeaver가 ClickHouse 드라이버가 설치되지 않은 것을 감지하면 드라이버를 다운로드하도록 안내합니다:

• 드라이버를 다운로드한 후 연결을 다시 Test합니다:

​

4. ClickHouse에서 쿼리하기

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

• 연결을 마우스 오른쪽 버튼으로 클릭한 다음 SQL Editor > Open SQL Script를 선택하여 쿼리 편집기를 엽니다.

• system.query_log에 대한 예시 쿼리:

​

다음 단계

DBeaver의 기능은 DBeaver 위키에서, ClickHouse의 기능은 ClickHouse 문서에서 확인하십시오.