메인 콘텐츠로 건너뛰기
ClickHouse가 ODBC를 통해 외부 데이터베이스에 연결할 수 있도록 합니다. ODBC 연결을 안전하게 구현하기 위해 ClickHouse는 별도의 프로그램인 clickhouse-odbc-bridge를 사용합니다. ODBC 드라이버를 clickhouse-server에서 직접 로드하면 드라이버 문제로 인해 ClickHouse 서버가 비정상 종료될 수 있습니다. ClickHouse는 필요할 때 clickhouse-odbc-bridge를 자동으로 시작합니다. ODBC bridge 프로그램은 clickhouse-server와 동일한 패키지로 설치됩니다. 이 엔진은 널 허용 데이터 타입을 지원합니다.

테이블 생성하기

CREATE TABLE 쿼리에 대한 자세한 설명은 참고하십시오. 테이블 구조는 원본 테이블 구조와 다를 수 있습니다:
  • 컬럼 이름은 원본 테이블과 같아야 하지만, 일부 컬럼만 사용해도 되며 순서는 상관없습니다.
  • 컬럼 타입은 원본 테이블과 다를 수 있습니다. ClickHouse는 값을 ClickHouse 데이터 타입으로 CAST하려고 시도합니다.
  • external_table_functions_use_nulls 설정은 널 허용 컬럼을 처리하는 방식을 정의합니다. 기본값은 1입니다. 값이 0이면 테이블 함수는 널 허용 컬럼을 생성하지 않고 NULL 대신 기본값을 삽입합니다. 이는 배열 내부의 NULL 값에도 적용됩니다.
엔진 매개변수
  • datasourceodbc.ini 파일에서 연결 설정이 정의된 섹션 이름입니다.
  • external_database — 외부 DBMS의 데이터베이스 이름입니다.
  • external_tableexternal_database에 있는 테이블 이름입니다.
이러한 매개변수는 이름이 지정된 컬렉션을 사용해 전달할 수도 있습니다.

사용 예시

ODBC를 통해 로컬에 설치된 MySQL에서 데이터 가져오기 이 예시는 Ubuntu Linux 18.04 및 MySQL 서버 5.7에서 검증되었습니다. unixODBC와 MySQL Connector가 설치되어 있는지 확인하십시오. 기본적으로(패키지로 설치한 경우) ClickHouse는 clickhouse 사용자로 시작됩니다. 따라서 MySQL 서버에서 이 사용자를 생성하고 구성해야 합니다.
그런 다음 /etc/odbc.ini에서 연결을 설정합니다.
unixODBC에 포함된 isql 유틸리티를 사용하여 connection을 확인할 수 있습니다.
MySQL의 테이블:
MySQL 테이블의 데이터를 가져오는 ClickHouse 테이블:

관련 항목

마지막 수정일 2026년 6월 19일