JDBC 테이블 엔진
JDBC 테이블 엔진
clickhouse-jdbc-bridge에는 실험적 코드가 포함되어 있으며 더 이상 지원되지 않아요. 안정성 문제와 보안 취약점이 있을 수 있으니 사용 시 주의하세요. ClickHouse는 임시(ad-hoc) 쿼리 시나리오(Postgres, MySQL, MongoDB 등)에 더 나은 대안을 제공하는 내장 테이블 함수를 사용할 것을 권장해요.
이 엔진은 JDBC를 통해 ClickHouse가 외부 데이터베이스에 연결할 수 있게 해줘요. JDBC 연결을 구현하기 위해 ClickHouse는 데몬으로 실행해야 하는 별도 프로그램 clickhouse-jdbc-bridge를 사용해요.
이 엔진은 Nullable 데이터 타입을 지원해요.
출처: 문서
본문
테이블 생성하기
CREATE TABLE [IF NOT EXISTS] [db.]table_name
(
columns list...
)
ENGINE = JDBC(datasource, external_database, external_table)
엔진 매개변수
datasource— 외부 DBMS의 URI 또는 이름. URI 형식:jdbc:<driver_name>://<host_name>:<port>/?user=<username>&password=<password>. MySQL 예시:jdbc:mysql://localhost:3306/?user=root&password=root.external_database— 외부 DBMS의 데이터베이스 이름 또는 명시적으로 정의된 테이블 스키마(예시 참고)external_table— 외부 데이터베이스의 테이블 이름 또는select * from table1 where column1=1같은 select 쿼리- 이 매개변수들은 named collections로도 전달할 수 있어요
사용 예시
MySQL 서버에서 콘솔 클라이언트로 직접 연결해 테이블 만들기:
mysql> CREATE TABLE `test`.`test` (
-> `int_id` INT NOT NULL AUTO_INCREMENT,
-> `int_nullable` INT NULL DEFAULT NULL,
-> `float` FLOAT NOT NULL,
-> `float_nullable` FLOAT NULL DEFAULT NULL,
-> PRIMARY KEY (`int_id`));
Query OK, 0 rows affected (0,09 sec)
mysql> insert into test (`int_id`, `float`) VALUES (1,2);
Query OK, 1 row affected (0,00 sec)
mysql> select * from test;
+------+----------+-----+----------+
| int_id | int_nullable | float | float_nullable |
+------+----------+-----+----------+
| 1 | NULL | 2 | NULL |
+------+----------+-----+----------+
1 row in set (0,00 sec)
ClickHouse 서버에서 테이블을 만들고 그 데이터 선택하기:
CREATE TABLE jdbc_table
(
`int_id` Int32,
`int_nullable` Nullable(Int32),
`float` Float32,
`float_nullable` Nullable(Float32)
)
ENGINE JDBC('jdbc:mysql://localhost:3306/?user=root&password=root', 'test', 'test')
SELECT *
FROM jdbc_table
┌─int_id─┬─int_nullable─┬─float─┬─float_nullable─┐
│ 1 │ ᴺᵁᴸᴸ │ 2 │ ᴺᵁᴸᴸ │
└────────┴──────────────┴───────┴────────────────┘
INSERT INTO jdbc_table(`int_id`, `float`)
SELECT toInt32(number), toFloat32(number * 1.0)
FROM system.numbers