Перейти к основному содержимому
Перейти к основному содержимому

Интерфейс PostgreSQL

Not supported in ClickHouse Cloud

ClickHouse поддерживает протокол передачи данных PostgreSQL, который позволяет вам использовать клиенты Postgres для подключения к ClickHouse. В некотором смысле ClickHouse может притворяться экземпляром PostgreSQL - это позволяет подключать клиентское приложение PostgreSQL к ClickHouse, которое не поддерживается напрямую ClickHouse (например, Amazon Redshift).

Для включения протокола передачи данных PostgreSQL добавьте настройку postgresql_port в файл конфигурации вашего сервера. Например, вы можете определить порт в новом XML-файле в вашей папке config.d:

<clickhouse>
    <postgresql_port>9005</postgresql_port>
</clickhouse>

Запустите сервер ClickHouse и ищите сообщение в журнале, подобное следующему, которое упоминает Listening for PostgreSQL compatibility protocol:

{} <Information> Application: Listening for PostgreSQL compatibility protocol: 127.0.0.1:9005

Подключение psql к ClickHouse​

Следующая команда демонстрирует, как подключить клиент PostgreSQL psql к ClickHouse:

psql -p [port] -h [hostname] -U [username] [database_name]

Например:

psql -p 9005 -h 127.0.0.1 -U alice default
примечание

Клиент psql требует входа с паролем, поэтому вы не сможете подключиться, используя пользователя default без пароля. Либо назначьте пароль пользователю default, либо войдите как другой пользователь.

Клиент psql запрашивает пароль:

Password for user alice:
psql (14.2, server 22.3.1.1)
WARNING: psql major version 14, server major version 22.
         Some psql features might not work.
Type "help" for help.

default=>

И вот всё! Теперь у вас есть клиент PostgreSQL, подключенный к ClickHouse, и все команды и запросы выполняются на ClickHouse.

примечание

Протокол PostgreSQL в настоящее время поддерживает только пароли в открытом виде.

Использование SSL​

Если у вас настроены SSL/TLS на вашем экземпляре ClickHouse, то postgresql_port будет использовать те же настройки (порт общий как для защищенных, так и для незащищенных клиентов).

Каждый клиент имеет свой метод подключения с использованием SSL. Следующая команда демонстрирует, как передать сертификаты и ключ для безопасного подключения psql к ClickHouse:

psql "port=9005 host=127.0.0.1 user=alice dbname=default sslcert=/path/to/certificate.pem sslkey=/path/to/key.pem sslrootcert=/path/to/rootcert.pem sslmode=verify-ca"

Настройка аутентификации пользователей ClickHouse с SCRAM-SHA-256​

Для обеспечения безопасной аутентификации пользователей в ClickHouse рекомендуется использовать протокол SCRAM-SHA-256. Настройте пользователя, указав элемент password_scram_sha256_hex в файле users.xml. Хеш пароля должен быть сгенерирован с num_iterations=4096.

Убедитесь, что клиент psql поддерживает и согласовывает SCRAM-SHA-256 во время соединения.

Пример конфигурации для пользователя user_with_sha256 с паролем abacaba:

<user_with_sha256>
    <password_scram_sha256_hex>04e7a70338d7af7bb6142fe7e19fef46d9b605f3e78b932a60e8200ef9154976</password_scram_sha256_hex>
</user_with_sha256>

Просмотрите документацию PostgreSQL для получения дополнительной информации о их настройках SSL.