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

Соединение встраиваемых с ClickHouse

Community Maintained

В встраиваемых вы определяете Модели Данных и Компоненты в коде (хранятся в вашем собственном кодовом репозитории) и используете наш SDK, чтобы сделать их доступными для вашей команды в мощном конструкторе без кода встраиваемых.

Конечный результат — возможность предоставлять быстрые, интерактивные аналитические решения для клиентов непосредственно в вашем продукте; разработанные вашей продуктовой командой; созданные вашей инженерной командой; поддерживаемые вашими командами, работающими с клиентами и данными. Именно так это и должно быть.

Встроенная безопасность на уровне строк означает, что каждый пользователь видит только те данные, которые ему разрешено видеть. А два уровня полностью настраиваемого кеширования означают, что вы можете предоставлять быстрые аналитические решения в реальном времени в больших масштабах.

1. Соберите ваши данные для соединения​

Чтобы подключиться к ClickHouse с помощью HTTP(S), вам нужна следующая информация:

  • ХОСТ и ПОРТ: как правило, порт составляет 8443 при использовании TLS или 8123 при отсутствии TLS.

  • НАЗВАНИЕ БАЗЫ ДАННЫХ: по умолчанию существует база данных с именем default, используйте имя базы данных, к которой вы хотите подключиться.

  • ИМЯ ПОЛЬЗОВАТЕЛЯ и ПАРОЛЬ: по умолчанию имя пользователя равно default. Используйте имя пользователя, соответствующее вашему случаю.

Сведения о вашем ClickHouse Cloud-сервисе доступны в консоли ClickHouse Cloud. Выберите сервис, к которому вы будете подключаться, и нажмите Подключиться:

Выберите HTTPS, и детали доступны в примере команды curl.

Если вы используете самоуправляемый ClickHouse, детали подключения устанавливаются вашим администратором ClickHouse.

2. Создайте тип соединения с ClickHouse​

Вы добавляете подключение к базе данных с использованием API встраиваемых. Это соединение используется для подключения к вашему сервису ClickHouse. Вы можете добавить соединение, используя следующий вызов API:

Выше представлено действие CREATE, но все операции CRUD доступные.

apiKey можно найти, нажав "Опубликовать" на одной из ваших панелей управления встраиваемыми.

name — это уникальное имя для идентификации этого соединения.

  • По умолчанию ваши модели данных будут искать соединение с именем "default", но вы можете предоставить своим моделям разные data_source имена, чтобы поддерживать соединение разных моделей данных с разными соединениями (просто укажите имя data_source в модели)

type сообщает встраиваемым, какой драйвер использовать

  • Здесь вы хотите использовать clickhouse, но вы можете подключить несколько различных источников данных к одной рабочей области встраиваемых, так что вы можете использовать и другие, например: postgres, bigquery, mongodb и т. д.

credentials — это объект JavaScript, содержащий необходимые учетные данные, ожидаемые драйвером

  • Эти данные надежно шифруются и используются только для получения именно тех данных, которые вы описали в своих моделях данных. Встраиваемые настоятельно рекомендуют создавать пользователя базы данных только для чтения для каждого соединения (встраиваемые будут только читать из вашей базы данных, а не писать).

Чтобы поддержать соединение с различными базами данных для prod, qa, test и т. д. (или поддержать различные базы данных для разных клиентов), вы можете назначить каждое соединение окружению (см. Environments API).