DataGrip을 ClickHouse에 연결하기

Community Maintained

DataGrip 시작 또는 다운로드

DataGrip은 https://www.jetbrains.com/datagrip/ 에서 다운로드할 수 있습니다.

HTTP(S)로 ClickHouse에 연결하려면 다음 정보가 필요합니다:

Parameter(s)	Description
`HOST` and `PORT`	일반적으로 TLS를 사용할 때는 포트가 8443이고, TLS를 사용하지 않을 때는 8123입니다.
`DATABASE NAME`	기본적으로 `default`라는 데이터베이스가 있으며, 연결하려는 데이터베이스의 이름을 사용합니다.
`USERNAME` and `PASSWORD`	기본값으로 사용자 이름은 `default`입니다. 사용하려는 용도에 적합한 사용자 이름을 사용합니다.

ClickHouse Cloud 서비스에 대한 세부 정보는 ClickHouse Cloud 콘솔에서 확인할 수 있습니다. 서비스를 선택한 다음 Connect를 클릭하십시오:

HTTPS를 선택하십시오. 연결 정보는 예제 curl 명령에 표시됩니다.

자가 관리형 ClickHouse를 사용하는 경우, 연결 정보는 ClickHouse 관리자가 설정합니다.

DataGrip을 실행한 다음 Data Sources and Drivers 대화 상자의 Data Sources 탭에서 + 아이콘을 클릭합니다.

ClickHouse를 선택합니다.

팁

연결을 추가하면 목록 순서가 변경되므로, 아직 ClickHouse가 목록의 맨 위에 있지 않을 수 있습니다.

Drivers 탭으로 전환하여 ClickHouse 드라이버를 로드합니다.

DataGrip은 다운로드 크기를 최소화하기 위해 드라이버를 기본으로 포함하지 않습니다. Drivers 탭에서 Complete Support 목록의 ClickHouse를 선택한 후 + 기호를 클릭합니다. 그런 다음 Provided Driver 옵션에서 Latest stable 드라이버를 선택합니다.

데이터베이스 연결 정보를 입력한 다음 Test Connection을 클릭합니다. 1단계에서 수집한 연결 정보를 사용하여 호스트 URL, 포트, 사용자 이름, 비밀번호, 데이터베이스 이름을 입력한 후 연결을 테스트합니다.

팁

프로토콜 접두사(예: https://) 없이 Host 필드에는 호스트 이름만 입력하십시오(예: your-host.clickhouse.cloud).

ClickHouse Cloud에 연결할 때는 호스트 아래에 있는 URL 필드에 ?ssl=true를 추가해야 합니다. 전체 JDBC URL은 다음과 같아야 합니다:

jdbc:clickhouse://your-host.clickhouse.cloud:8443/default?ssl=true

ClickHouse Cloud는 모든 연결에서 SSL 암호화를 요구합니다. ?ssl=true 파라미터가 없으면 자격 증명이 올바르더라도 「Connection reset」 오류가 발생합니다.

JDBC URL 설정에 대한 자세한 내용은 ClickHouse JDBC driver 저장소를 참조하십시오.

DataGrip에 대한 자세한 내용은 DataGrip 문서를 참조하십시오.