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

Подключение ClickHouse к Deepnote

Community Maintained

Deepnote — это совместный ноутбук для работы с данными, созданный для команд, чтобы находить и совместно использовать аналитические выводы. Помимо совместимости с Jupyter, он работает в облаке и предоставляет единое централизованное пространство для совместной работы и эффективной реализации проектов в области data science.

В этом руководстве предполагается, что у вас уже есть аккаунт Deepnote и запущенный экземпляр ClickHouse.

Интерактивный пример​

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

Запустить в Deepnote

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

  1. В Deepnote выберите раздел «Integrations» и нажмите на плитку ClickHouse.
Плитка интеграции ClickHouse
  1. Укажите параметры подключения к вашему экземпляру ClickHouse:

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

Параметр(ы)Описание
HOST и PORTОбычно используется порт 8443 при использовании TLS или 8123 при отсутствии TLS.
DATABASE NAMEПо умолчанию существует база данных default; используйте имя базы данных, к которой вы хотите подключиться.
USERNAME и PASSWORDПо умолчанию имя пользователя — default. Используйте имя пользователя, соответствующее вашему сценарию.

Сведения о вашем сервисе ClickHouse Cloud доступны в консоли ClickHouse Cloud. Выберите сервис и нажмите Connect:

Кнопка подключения сервиса ClickHouse Cloud

Выберите HTTPS. Параметры подключения отображаются в примере команды curl.

Параметры HTTPS-подключения ClickHouse Cloud

Если вы используете самостоятельное (self-managed) развертывание ClickHouse, параметры подключения задаются администратором ClickHouse.

Диалоговое окно с параметрами ClickHouse

ПРИМЕЧАНИЕ: Если ваше подключение к ClickHouse защищено списком контроля доступа по IP-адресам (IP Access List), возможно, вам потребуется разрешить IP-адреса Deepnote. Подробнее об этом читайте в документации Deepnote.

  1. Готово! ClickHouse интегрирован с Deepnote.

Использование интеграции с ClickHouse.​

  1. Для начала подключитесь к интеграции с ClickHouse в правой части блокнота.

    Диалоговое окно с информацией о ClickHouse

  2. Теперь создайте новый блок запроса ClickHouse и выполните запрос к базе данных. Результаты запроса будут сохранены в формате DataFrame и помещены в переменную, указанную в SQL-блоке.

  3. Вы также можете преобразовать любой существующий SQL-блок в блок ClickHouse.