PostgreSQL

允许连接到远程PostgreSQL服务。支持读写操作(SELECTINSERT查询),以在ClickHouse和PostgreSQL之间交换数据。

SHOW TABLESDESCRIBE TABLE查询的帮助下,从远程PostgreSQL实时访问表列表和表结构。

支持表结构修改(ALTER TABLE ... ADD|DROP COLUMN)。如果use_table_cache参数(参见下面的引擎参数)设置为1,则会缓存表结构,不会检查是否被修改,但可以用DETACHATTACH查询进行更新。

创建数据库

  1. CREATE DATABASE test_database
  2. ENGINE = PostgreSQL('host:port', 'database', 'user', 'password'[, `use_table_cache`]);

引擎参数

  • host:port — PostgreSQL服务地址
  • database — 远程数据库名次
  • user — PostgreSQL用户名称
  • password — PostgreSQL用户密码
  • use_table_cache — 定义数据库表结构是否已缓存或不进行。可选的。默认值: 0.

支持的数据类型

PostgerSQLClickHouse
DATEDate
TIMESTAMPDateTime
REALFloat32
DOUBLEFloat64
DECIMAL, NUMERICDecimal
SMALLINTInt16
INTEGERInt32
BIGINTInt64
SERIALUInt32
BIGSERIALUInt64
TEXT, CHARString
INTEGERNullable(Int32)
ARRAYArray

使用示例

ClickHouse中的数据库,与PostgreSQL服务器交换数据:

  1. CREATE DATABASE test_database
  2. ENGINE = PostgreSQL('postgres1:5432', 'test_database', 'postgres', 'mysecretpassword', 1);
  1. SHOW DATABASES;
  1. ┌─name──────────┐
  2. default
  3. test_database
  4. system
  5. └───────────────┘
  1. SHOW TABLES FROM test_database;
  1. ┌─name───────┐
  2. test_table
  3. └────────────┘

从PostgreSQL表中读取数据:

  1. SELECT * FROM test_database.test_table;
  1. ┌─id─┬─value─┐
  2. 1 2
  3. └────┴───────┘

将数据写入PostgreSQL表:

  1. INSERT INTO test_database.test_table VALUES (3,4);
  2. SELECT * FROM test_database.test_table;
  1. ┌─int_id─┬─value─┐
  2. 1 2
  3. 3 4
  4. └────────┴───────┘

在PostgreSQL中修改了表结构:

  1. postgre> ALTER TABLE test_table ADD COLUMN data Text

当创建数据库时,参数use_table_cache被设置为1,ClickHouse中的表结构被缓存,因此没有被修改:

  1. DESCRIBE TABLE test_database.test_table;
  1. ┌─name───┬─type──────────────┐
  2. id Nullable(Integer)
  3. value Nullable(Integer)
  4. └────────┴───────────────────┘

分离表并再次附加它之后,结构被更新了:

  1. DETACH TABLE test_database.test_table;
  2. ATTACH TABLE test_database.test_table;
  3. DESCRIBE TABLE test_database.test_table;
  1. ┌─name───┬─type──────────────┐
  2. id Nullable(Integer)
  3. value Nullable(Integer)
  4. data Nullable(String)
  5. └────────┴───────────────────┘