ClickHouse ODBC Driver

ODBC 표준 인터페이스 지원

이 드라이버는 ODBC API를 완전히 구현하여, ODBC를 지원하는 모든 응용 프로그램(예: Microsoft Power BI, Excel, Tableau 등)에서 ClickHouse 데이터에 접근할 수 있게 합니다.

다양한 연결 및 설정 옵션

드라이버는 connection string을 통해 다양한 파라미터를 설정할 수 있습니다. 주요 파라미터에는 서버 URL(Url), 사용자명(Username), 비밀번호(Password), 데이터베이스(Database), 타임아웃(Timeout), 압축(Compression) 등이 포함됩니다. 또한, SQL 호환성 설정(SqlCompatibilitySettings)을 통해 ClickHouse의 동작을 전통적인 관계형 데이터베이스에 더 가깝게 조정할 수 있습니다.

Power BI 통합 지원

Microsoft Power BI와의 통합이 지원됩니다. Power BI는 일반 ODBC 커넥터와 ClickHouse 커넥터 두 가지 연결 옵션을 제공하며, 모두 내부적으로 ODBC를 사용합니다. ClickHouse 커넥터는 DirectQuery 모드를 지원하여 대용량 데이터 세트와의 인터랙티브 대시보드에 적합합니다.

Windows에 드라이버 설치

최신 버전의 드라이버는 GitHub 릴리스 페이지에서 MSI 설치 파일을 다운로드하여 설치할 수 있습니다. 설치 후에는 Microsoft ODBC 데이터 원본 관리자 도구를 사용하여 드라이버를 등록하고 DSN(Data Source Name)을 구성해야 합니다.

연결 테스트 (PowerShell 예시)

설치 후 PowerShell 스크립트를 사용하여 드라이버가 올바르게 작동하는지 테스트할 수 있습니다. 다음은 기본적인 연결 테스트 스크립트입니다:

$url = “http://127.0.0.1:8123/”
$username = “default”
$password = “”
$conn = New-Object System.Data.Odbc.OdbcConnection(“Driver={ClickHouse ODBC Driver (Unicode)}; Url=$url; Username=$username; Password=$password”)
$conn.Open()
$cmd = $conn.CreateCommand()
$cmd.CommandText = “select version()”
$reader = $cmd.ExecuteReader()
$reader.Read()
$reader.GetValue(0)
$reader.Close()
$conn.Close()

최신 버전 및 업데이트

공식 문서에서는 ClickHouse 서버 버전 24.11 이상으로 업데이트할 것을 강력히 권장하고 있습니다. 드라이버는 현재 활발히 개발 중이며, 일부 ODBC 기능은 아직 완전히 구현되지 않았을 수 있습니다.

제한 사항 및 확인 사항

드라이버는 주로 ClickHouse 서버 버전 21.3에 대해 테스트되었습니다. 더 오래된 ClickHouse 서버 버전의 경우 Null 값 처리, Nullable 타입, 시간대 변환 등에서 일부 제한이 있을 수 있습니다. 또한, 응용 프로그램과 동일한 아키텍처(32비트 또는 64비트)의 드라이버를 설치해야 하며, 동일한 ODBC 드라이버 매니저 구현체(MDAC, UnixODBC, iODBC)를 사용해야 합니다. 읽기 전용(readonly=1)으로 설정된 사용자가 SQL 호환성 설정을 사용하려면, 서버 측 설정을 수정해야 합니다.