[Документация Yandex Cloud](../../index.md) > [Yandex Managed Service for ClickHouse®](../index.md) > [Пошаговые инструкции](index.md) > Логи и мониторинг > Подключение из DataLens

# Подключение к кластеру ClickHouse® из DataLens

[Yandex DataLens](../../datalens/concepts/index.md) — это сервис для [бизнес-аналитики](../../glossary/business-analytics.md). Сервис позволяет загружать и обрабатывать данные, визуализировать их для анализа и проверки гипотез. Он может помочь вам при принятии маркетинговых решений для вашего продукта.

Чтобы использовать существующий кластер в качестве источника данных для DataLens:
1. [Активируйте Yandex DataLens](#activate-datalens).
1. [Разрешите доступ из DataLens к кластеру](#allow-access).
1. [Создайте подключение к кластеру в DataLens](#create-connector).

## Активировать DataLens {#activate-datalens}

Подключить кластер к DataLens внутри облака можно только, если DataLens активирован в том же каталоге, что и кластер.

Если DataLens активирован в другом каталоге, кластер можно подключить как внешний ресурс при условии, что к кластеру есть публичный доступ. [Подробнее о подключении из другого каталога](../../datalens/operations/connection/create-clickhouse.md).

{% note alert "Ограничение" %}

В облаке можно создать только один экземпляр DataLens.

{% endnote %}

{% list tabs group=instructions %}

- Консоль управления {#console}

    1. В [консоли управления](https://kz.console.yandex.cloud) перейдите на страницу каталога.
    1. Перейдите в сервис **DataLens**.
    1. Нажмите кнопку **Активировать DataLens**.

{% endlist %}

Экземпляр DataLens будет активирован в выбранном каталоге.

## Разрешить доступ из DataLens к кластеру {#allow-access}

Чтобы DataLens мог подключаться к кластеру и работать с данными в нем, включите опцию **Доступ из DataLens** при [создании кластера](cluster-create.md) или [изменении его настроек](update.md#change-additional-settings).

## Создать подключение к кластеру {#create-connector}

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. Убедитесь, что сервис **DataLens** [активирован](#activate-datalens) в нужном каталоге и доступ к кластеру из него [разрешен](#allow-access).
  1. Перейдите в сервис **Managed Service for ClickHouse**.
  1. Нажмите на имя нужного кластера и выберите вкладку **DataLens**.
  1. Нажмите кнопку **Создать подключение**.

     {% cut "У меня нет кнопки «Создать подключение»" %}

     
     Если вместо кнопки **Создать подключение** вы видите сообщение «DataLens ещё не активирован», значит вы либо еще не активировали DataLens, либо подключили его в другом каталоге. Чтобы подключить кластер к экземпляру DataLens из другого каталога, воспользуйтесь [инструкцией](../../datalens/operations/connection/create-clickhouse.md) в документации DataLens.


     {% endcut %}

  1. Задайте [настройки подключения](#connector-settings).
  1. Проверьте, что настройки заданы корректно, нажав кнопку **Проверить подключение**.
  1. После успешной проверки подключения нажмите кнопку **Создать**.

{% endlist %}

После создания подключения вы сможете:
* [Изменить](#update-connector) или [удалить](#delete-connector) это подключение.
* [Создавать датасеты](../../datalens/dataset/index.md) с данными кластера, используя это подключение.
* Визуализировать датасеты с помощью [чартов](../../datalens/concepts/chart/index.md) и [дашбордов](../../datalens/concepts/dashboard.md).


Попробуйте [визуализировать данные из ClickHouse®](../../tutorials/datalens/data-from-ch-visualization.md).


## Просмотреть список подключений кластера {#connectors-list}

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором находится кластер.
  1. Перейдите в сервис **Managed Service for ClickHouse**.
  1. Нажмите на имя нужного кластера и выберите вкладку **DataLens**.

     {% cut "Моего подключения нет в списке" %}

     Если нужного подключения нет в списке, значит кластер подключен к DataLens как внешний источник. [Подробнее о работе DataLens](../../datalens/index.md).

     {% endcut %} 

{% endlist %}

## Изменить подключение к кластеру {#update-connector}

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором находится кластер.
  1. Перейдите в сервис **Managed Service for ClickHouse**.
  1. Нажмите на имя нужного кластера и выберите вкладку **DataLens**.
  1. Выберите подключение из списка.

     {% cut "Моего подключения нет в списке" %}

     Если нужного подключения нет в списке, значит кластер подключен к DataLens как внешний источник. [Подробнее о работе DataLens](../../datalens/index.md).

     {% endcut %} 

  1. Измените [настройки](#connector-settings).
  1. Проверьте, что настройки заданы корректно, нажав кнопку **Проверить подключение**.
  1. После успешной проверки подключения нажмите кнопку **Сохранить**.

{% endlist %}

## Удалить подключение к кластеру {#delete-connector}

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором находится кластер.
  1. Перейдите в сервис **Managed Service for ClickHouse**.
  1. Нажмите на имя нужного кластера и выберите вкладку **DataLens**.
  1. Выберите подключение из списка.

     {% cut "Моего подключения нет в списке" %}

     Если нужного подключения нет в списке, значит кластер подключен к DataLens как внешний источник. [Подробнее о работе DataLens](../../datalens/index.md).

     {% endcut %} 

  1. Нажмите на значок ![image](../../_assets/console-icons/ellipsis.svg) вверху страницы и выберите **Удалить**.
  1. В открывшемся окне нажмите кнопку **Удалить**.

{% endlist %}

## Настройки подключения {#connector-settings} 

{% list tabs group=instructions %}

- Консоль управления {#console}

  В [консоли управления](https://kz.console.yandex.cloud) при [создании](#create-connector) или [изменении](#update-connector) подключения к кластеру:
  1. Задайте имя подключения.
  1. Выберите вкладку **Выбрать в каталоге**.
  1. Выберите кластер и его хост из выпадающих списков, либо [создайте новый кластер](cluster-create.md) в каталоге с DataLens, нажав на кнопку **Создать новый**.
  1. Выберите пользователя из выпадающего списка.
  1. Введите пароль этого пользователя.

     Значения настроек **Порт HTTP-интерфейса**, **HTTPS**, **Время жизни кеша в секундах** и **Уровень доступа SQL-запросов** оставьте без изменений.

{% endlist %}

{% cut "Кластер и DataLens находятся в разных каталогах" %}

Если кластер и DataLens находятся в разных каталогах, используйте настройки из [инструкции](../../datalens/operations/connection/create-clickhouse.md) в документации DataLens.

{% endcut %}

Если для пользователя задана [настройка **Read only**](cluster-users.md#setting-readonly), убедитесь, что значение настройки — `0` или `2`. В противном случае подключение работать не будет.

_ClickHouse® является зарегистрированным товарным знаком [ClickHouse, Inc](https://clickhouse.com)._