메인 콘텐츠로 건너뛰기
원격 MySQL 서버에 저장된 데이터에 대해 SELECTINSERT 쿼리를 실행할 수 있습니다.

구문

인수

인수는 이름이 지정된 컬렉션을 사용해 전달할 수도 있습니다. 이 경우 hostport는 별도로 지정해야 합니다. 프로덕션 환경에서는 이 방식을 권장합니다. =, !=, >, >=, <, <=와 같은 단순한 WHERE 절은 현재 MySQL 서버에서 실행됩니다. 그 외 조건과 LIMIT 샘플링 제약은 MySQL 쿼리가 완료된 후에만 ClickHouse에서 실행됩니다. 여러 레플리카를 지원하며, |로 나열해야 합니다. 예를 들면 다음과 같습니다:
또는

반환 값

원본 MySQL 테이블과 동일한 컬럼으로 이루어진 테이블 객체입니다.
MySQL의 일부 데이터 타입은 서로 다른 ClickHouse 타입으로 매핑될 수 있으며, 이는 쿼리 수준 설정 mysql_datatypes_support_level로 제어됩니다.
INSERT 쿼리에서 테이블 함수 mysql(...)를 컬럼 이름 목록이 포함된 테이블 이름과 구분하려면 FUNCTION 또는 TABLE FUNCTION 키워드를 사용해야 합니다. 아래 예시를 참조하십시오.

예시

MySQL 테이블:
ClickHouse에서 데이터 조회:
또는 이름이 지정된 컬렉션:

enable_compression

MySQL 프로토콜 연결에 대한 압축을 활성화합니다. 기본값: false. 이 설정은 다음에 적용됩니다.
  • mysql 테이블 함수;
  • MySQL 테이블 엔진;
  • MySQL 데이터베이스 엔진;
  • MySQL 통합에 사용되는 이름이 지정된 컬렉션.
활성화되면 ClickHouse가 해당 연결에 대해 압축을 요청합니다. 예시:
교체 및 삽입:
MySQL 테이블의 데이터를 ClickHouse 테이블로 복사:
또는 현재 최대 id 값을 기준으로 MySQL에서 증분 배치만 복사하는 경우:
마지막 수정일 2026년 7월 2일