Источник словаря PostgreSQL

Пример настроек:

DDL
Файл конфигурации

SOURCE(POSTGRESQL(
    port 5432
    host 'postgresql-hostname'
    user 'postgres_user'
    password 'postgres_password'
    db 'db_name'
    table 'table_name'
    replica(host 'example01-1' port 5432 priority 1)
    replica(host 'example01-2' port 5432 priority 2)
    where 'id=10'
    invalidate_query 'SQL_QUERY'
    query 'SELECT id, value_1, value_2 FROM db_name.table_name'
))

<source>
  <postgresql>
      <host>postgresql-hostname</hoat>
      <port>5432</port>
      <user>clickhouse</user>
      <password>qwerty</password>
      <db>db_name</db>
      <table>table_name</table>
      <where>id=10</where>
      <invalidate_query>SQL_QUERY</invalidate_query>
      <query>SELECT id, value_1, value_2 FROM db_name.table_name</query>
  </postgresql>
</source>

Поля настроек:

Параметр	Описание
`host`	Хост сервера PostgreSQL. Его можно указать для всех реплик или отдельно для каждой из них (внутри `<replica>`).
`port`	Порт сервера PostgreSQL. Его можно указать для всех реплик или отдельно для каждой из них (внутри `<replica>`).
`user`	Имя пользователя PostgreSQL. Его можно указать для всех реплик или отдельно для каждой из них (внутри `<replica>`).
`password`	Пароль пользователя PostgreSQL. Его можно указать для всех реплик или отдельно для каждой из них (внутри `<replica>`).
`replica`	Раздел с конфигурацией реплик. Таких разделов может быть несколько.
`replica/host`	Хост PostgreSQL.
`replica/port`	Порт PostgreSQL.
`replica/priority`	Приоритет реплики. При попытке подключения ClickHouse перебирает реплики в порядке приоритета. Чем меньше число, тем выше приоритет.
`db`	Имя базы данных.
`table`	Имя таблицы.
`where`	Критерий отбора. Синтаксис условий такой же, как в предложении `WHERE` в PostgreSQL. Например, `id > 10 AND id < 20`. Необязательно.
`invalidate_query`	Запрос для проверки состояния словаря. Необязательно. Подробнее см. в разделе Обновление данных словаря с помощью LIFETIME.
`background_reconnect`	Переподключаться к реплике в фоновом режиме, если соединение не удалось. Необязательно.
`query`	Пользовательский запрос. Необязательно.
`sslmode`	Режим TLS/SSL, передаваемый в `libpq`: `disable`, `allow`, `prefer`, `require`, `verify-ca` или `verify-full`. Если не задан, применяется значение `prefer` по умолчанию для `libpq`. Необязательно.
`sslrootcert_pem`	Содержимое CA‑сертификата, по которому проверяется сертификат сервера PostgreSQL. Необязательно.
`sslcert_pem`	Содержимое клиентского сертификата для аутентификации на основе сертификатов. Необязательно.
`sslkey_pem`	Содержимое закрытого ключа, соответствующего `sslcert_pem`. Необязательно.
`sslrootcert`, `sslcert`, `sslkey`	Те же учетные данные в виде путей к файлам на сервере. Допускается только для словаря, определенного в файле конфигурации сервера, или через именованную коллекцию, определенную в нем; см. ниже. Необязательно.

Поля table и where нельзя использовать вместе с полем query. При этом должно быть указано либо поле table, либо поле query.

sslrootcert, sslcert и sslkey указывают имена файлов, которые сервер открывает с использованием собственных привилегий, поэтому они допустимы только для словаря, определённого в файле конфигурации сервера, или через определённую в нём именованную коллекцию. Словарь, созданный запросом CREATE DICTIONARY, вместо этого должен передавать содержимое в sslrootcert_pem, sslcert_pem и sslkey_pem. Эти значения маскируются в журналах и запросах SHOW так же, как пароли.

SQL Reference

Data Types

Engines

Functions

Formats

Settings

System Tables

Data Lakes

Источник словаря PostgreSQL