> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-3a82795f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Позволяет подключаться к базам данных на удалённом сервере PostgreSQL.

# PostgreSQL

Позволяет подключаться к базам данных на удалённом [PostgreSQL](https://www.postgresql.org) сервере. Поддерживает операции чтения и записи (запросы `SELECT` и `INSERT`) для обмена данными между ClickHouse и PostgreSQL.

Обеспечивает доступ в реальном времени к списку таблиц и структуре таблиц на удалённом сервере PostgreSQL с помощью запросов `SHOW TABLES` и `DESCRIBE TABLE`.

Поддерживает изменение структуры таблиц (`ALTER TABLE ... ADD|DROP COLUMN`). Если параметр `use_table_cache` (см. раздел «Параметры движка» ниже) установлен в `1`, структура таблиц кэшируется и не проверяется на изменения, но может быть обновлена запросами `DETACH` и `ATTACH`.

<div id="creating-a-database">
  ## Создание базы данных
</div>

```sql theme={null}
CREATE DATABASE test_database
ENGINE = PostgreSQL('host:port', 'database', 'user', 'password'[, `schema`, `use_table_cache`]);
```

**Параметры движка**

* `host:port` — Адрес сервера PostgreSQL.
* `database` — Имя удалённой базы данных.
* `user` — Пользователь PostgreSQL.
* `password` — Пароль пользователя.
* `schema` — Схема PostgreSQL.
* `use_table_cache` — Определяет, кэшируется ли структура таблицы базы данных. Необязательный параметр. Значение по умолчанию: `0`.

<div id="data_types-support">
  ## Поддержка типов данных
</div>

| PostgreSQL       | ClickHouse                                           |
| ---------------- | ---------------------------------------------------- |
| DATE             | [Date](/ru/reference/data-types/date)                |
| TIMESTAMP        | [DateTime](/ru/reference/data-types/datetime)        |
| REAL             | [Float32](/ru/reference/data-types/float)            |
| DOUBLE           | [Float64](/ru/reference/data-types/float)            |
| DECIMAL, NUMERIC | [Decimal](/ru/reference/data-types/decimal)          |
| SMALLINT         | [Int16](/ru/reference/data-types/int-uint)           |
| INTEGER          | [Int32](/ru/reference/data-types/int-uint)           |
| BIGINT           | [Int64](/ru/reference/data-types/int-uint)           |
| SERIAL           | [UInt32](/ru/reference/data-types/int-uint)          |
| BIGSERIAL        | [UInt64](/ru/reference/data-types/int-uint)          |
| TEXT, CHAR       | [String](/ru/reference/data-types/string)            |
| INTEGER          | Nullable([Int32](/ru/reference/data-types/int-uint)) |
| ARRAY            | [Array](/ru/reference/data-types/array)              |

<div id="examples-of-use">
  ## Примеры использования
</div>

База данных в ClickHouse, которая обменивается данными с сервером PostgreSQL:

```sql theme={null}
CREATE DATABASE test_database
ENGINE = PostgreSQL('postgres1:5432', 'test_database', 'postgres', 'mysecretpassword', 'schema_name',1);
```

```sql theme={null}
SHOW DATABASES;
```

```text theme={null}
┌─name──────────┐
│ default       │
│ test_database │
│ system        │
└───────────────┘
```

```sql theme={null}
SHOW TABLES FROM test_database;
```

```text theme={null}
┌─name───────┐
│ test_table │
└────────────┘
```

Чтение данных из таблицы PostgreSQL:

```sql theme={null}
SELECT * FROM test_database.test_table;
```

```text theme={null}
┌─id─┬─value─┐
│  1 │     2 │
└────┴───────┘
```

Запись данных в таблицу PostgreSQL:

```sql theme={null}
INSERT INTO test_database.test_table VALUES (3,4);
SELECT * FROM test_database.test_table;
```

```text theme={null}
┌─int_id─┬─value─┐
│      1 │     2 │
│      3 │     4 │
└────────┴───────┘
```

Предположим, что структура таблицы в PostgreSQL была изменена:

```sql theme={null}
postgre> ALTER TABLE test_table ADD COLUMN data Text
```

Поскольку при создании базы данных параметр `use_table_cache` был установлен в значение `1`, структура таблицы в ClickHouse была кэширована и поэтому не была изменена:

```sql theme={null}
DESCRIBE TABLE test_database.test_table;
```

```text theme={null}
┌─name───┬─type──────────────┐
│ id     │ Nullable(Integer) │
│ value  │ Nullable(Integer) │
└────────┴───────────────────┘
```

После отсоединения таблицы и её повторного подключения структура была обновлена:

```sql theme={null}
DETACH TABLE test_database.test_table;
ATTACH TABLE test_database.test_table;
DESCRIBE TABLE test_database.test_table;
```

```text theme={null}
┌─name───┬─type──────────────┐
│ id     │ Nullable(Integer) │
│ value  │ Nullable(Integer) │
│ data   │ Nullable(String)  │
└────────┴───────────────────┘
```

<div id="related-content">
  ## Связанные материалы
</div>

* Блог: [ClickHouse и PostgreSQL — идеальное сочетание в мире данных — часть 1](https://clickhouse.com/blog/migrating-data-between-clickhouse-postgres)
* Блог: [ClickHouse и PostgreSQL — идеальное сочетание в мире данных — часть 2](https://clickhouse.com/blog/migrating-data-between-clickhouse-postgres-part-2)