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

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

Community Maintained

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

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

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

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

Запустить в Deepnote

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

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

To connect to ClickHouse with HTTP(S) you need this information:

Parameter(s)Description
HOST and PORTTypically, the port is 8443 when using TLS or 8123 when not using TLS.
DATABASE NAMEOut of the box, there is a database named default, use the name of the database that you want to connect to.
USERNAME and PASSWORDOut of the box, the username is default. Use the username appropriate for your use case.

The details for your ClickHouse Cloud service are available in the ClickHouse Cloud console. Select a service and click Connect:

ClickHouse Cloud service connect button

Choose HTTPS. Connection details are displayed in an example curl command.

ClickHouse Cloud HTTPS connection details

If you are using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.

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

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

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

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

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

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

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

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