---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.0
alternate:
  - en/quickstart
  - ru/quickstart
  - href: ru/quickstart.md
    type: text/markdown
    title: Markdown version
csp:
  - script-src:
      - https://mc.yandex.ru
    img-src:
      - https://mc.yandex.ru
    connect-src:
      - https://mc.yandex.ru
      - wss://mc.yandex.ru
    child-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-ancestors:
      - 'blob:'
      - https://mc.yandex.ru
canonical: ru/quickstart.html
title: Как начать работать с DataLens On-premises
description: >-
  Следуя данной инструкции, вы сможете начать работать с DataLens On-premises —
  подключиться к источнику данных, создать свой первый датасет, построить
  несколько чартов для визуализации данных и разместить их на дашборде.
vcsPath: ru/quickstart.md
---

# Как начать работать с DataLens On-premises


В этом разделе описано, как подключиться к источнику данных, создать свой первый [датасет](dataset/index.md), построить несколько [чартов](concepts/chart/index.md) для визуализации данных и разместить их на [дашборде](concepts/dashboard.md).

Чтобы начать работать с DataLens, воспользуйтесь [инструкцией по развертыванию](./concepts/create-instance.md).



Для доступа к сервису необходимо пройти [аутентификацию](security/user-account.md#auth) в DataLens.

Если у вас нет учетной записи в DataLens, обратитесь к администратору сервиса.




## Создайте воркбук {#create-workbook}

Все объекты в DataLens размещаются в специальных контейнерах — [воркбуках и коллекциях](./workbooks-collections/index.md):

* **Воркбук** — хранит [подключения](./concepts/connection/index.md), [датасеты](./dataset/index.md), [чарты](./concepts/chart/index.md) и [дашборды](./concepts/dashboard.md).
* **Коллекция** — контейнер для группировки воркбуков и других коллекций.

Чтобы создать воркбук:

1. Перейдите на страницу сервиса.
1. В правом верхнем углу нажмите **Создать** → **Создать воркбук**.
1. Введите название воркбука — `Quick start`.
1. Нажмите кнопку **Создать**.


## Создайте подключение {#create-connection}

[Подключение](./concepts/connection/index.md) содержит информацию о параметрах доступа к источнику данных. Например, IP-адрес хоста БД, порт. На базе подключения вы можете создавать датасеты.

Чтобы создать подключение:




1. В правом верхнем углу воркбука нажмите **Создать** → <!-- diplodoc:svg ![image](_assets/console-icons/thunderbolt.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="m7.836 6 .76-2.027L9.336 2H5.5a.72.72 0 0 0-.664.45L2.513 8.257a.177.177 0 0 0 .164.243h4.965l-.732 2.013-1.082 2.975a.382.382 0 0 0 .637.392l6.956-7.391A.29.29 0 0 0 13.21 6H7.835m2.727-3 .235-.627A1.386 1.386 0 0 0 9.5.5h-4c-.906 0-1.72.552-2.057 1.393L1.12 7.7A1.677 1.677 0 0 0 2.677 10H5.5l-.545 1.5-.537 1.475a1.882 1.882 0 0 0 3.14 1.933l6.956-7.391A1.79 1.79 0 0 0 13.21 4.5H10z" clip-rule="evenodd"/></svg> **Подключение**.
1. Выберите подключение **ClickHouse®**.

   1. В открывшемся окне укажите параметры подключения:

      * Имя хоста — `rc1a-ckg8nrosr2lim5iz.mdb.yandexcloud.net`.
      * Порт HTTP-интерфейса — `8443` (по умолчанию).
      * Имя пользователя — `samples_ro`.
      * Пароль — `MsgfcjEhJk`.

   1. Включите опцию **Уровень доступа SQL-запросов** → **SQL на чтение**.

      ![image](_assets/datalens/operations/connection/create-sample-connection-ent.png)

   1. Нажмите кнопку **Проверить подключение** и убедитесь, что появился зеленый значок.
   1. Нажмите кнопку **Создать подключение**.
   1. Введите название подключения — `Sample ClickHouse`.
   1. Нажмите кнопку **Создать**.


Дождитесь сохранения подключения.

## Создайте датасет {#create-dataset}

[Датасет](./dataset/index.md) описывает набор данных и его структуру. Он создается на основе подключения к источнику данных. Набор данных датасета используется при создании виджетов:

* [чартов](./concepts/chart/index.md) — для визуализации данных;
* [селекторов](./dashboard/selector.md) — для фильтрации данных.

Чтобы создать датасет на базе подключения `Sample ClickHouse`:

1. На странице подключения в правом верхнем углу нажмите кнопку **Создать датасет**.


1. Перенесите на рабочую область таблицу `MS_SalesMiniTable`.

   ![drag-table](_assets/datalens/quickstart/drag-table-os.png)

1. Перейдите на вкладку **Поля**.



1. Создайте показатель с суммой заказа. Для этого в столбце **Агрегация** для поля `Sales` выберите значение **Сумма**.

   ![dataset-sales-sum](_assets/datalens/quickstart/dataset-sales-sum-os.png)

1. Создайте показатель с количеством заказов:

   1. Переименуйте поле `OrderID` в `OrderCount`: нажмите на имя поля, удалите текущее имя и введите новое.
   1. В столбце **Агрегация** для поля `OrderCount` выберите значение **Количество уникальных**.

1. Для поля `ShopAddressCoord` измените тип данных: в столбце **Тип** выберите значение **Геоточка**.

   ![dataset-sales-geotype](_assets/datalens/quickstart/dataset-sales-geotype-os.png)

1. Сохраните датасет:

   1. В правом верхнем углу нажмите кнопку **Сохранить**.
   1. Введите название датасета — `Sales Dataset` и нажмите кнопку **Создать**.

      ![create-dataset](_assets/datalens/quickstart/create-dataset-os.png)

## Создайте чарт — столбчатая диаграмма {#create-column-chart}

[Чарт](./concepts/chart/index.md) — это визуализация данных из датасета в виде таблицы, диаграммы или картограммы.

Чтобы создать чарт на основе датасета `Sales Dataset`:

1. На странице датасета в правом верхнем углу нажмите кнопку **Создать чарт**.
1. Добавьте в чарт подкатегорию товаров. Для этого из раздела **Измерения** перетащите поле `ProductSubcategory` в секцию **X**.
1. Добавьте в чарт показатель продаж. Для этого из раздела **Показатели** перетащите поле `Sales` в секцию **Y**.
1. Отсортируйте чарт по убыванию показателя продаж — из раздела **Показатели** перетащите поле `Sales` в секцию **Сортировка**.
1. Сохраните чарт:

   1. В правом верхнем углу нажмите кнопку **Сохранить**.
   1. В открывшемся окне введите название чарта `Продажи по подкатегориям` и нажмите кнопку **Сохранить**.

      ![create-chart-1](_assets/datalens/quickstart/create-column-chart-os.png)

## Создайте чарт — диаграмма с областями {#create-area-chart}

1. Создайте копию чарта, созданного на предыдущем шаге:

   1. В правом верхнем углу нажмите значок <!-- diplodoc:svg ![save-button](_assets/console-icons/chevron-down.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M2.97 5.47a.75.75 0 0 1 1.06 0L8 9.44l3.97-3.97a.75.75 0 1 1 1.06 1.06l-4.5 4.5a.75.75 0 0 1-1.06 0l-4.5-4.5a.75.75 0 0 1 0-1.06" clip-rule="evenodd"/></svg> → **Сохранить как копию**.

      ![chart-save-as](_assets/datalens/quickstart/chart-save-as-os.png)

   1. В открывшемся окне введите название нового чарта `Продажи по неделям` и нажмите кнопку **Сохранить**.

1. Выберите тип визуализации **Диаграмма с областями**.

   ![type-chart-select](_assets/datalens/quickstart/type-chart-select-os.png)

1. Замените подкатегории товаров на дату заказа на оси X. Для этого из раздела **Измерения** перетащите поле `OrderDate` в секцию **X** и наведите его над полем `ProductSubcategory`, пока то не станет красным.
1. Добавьте в чарт категорию товаров. Для этого из раздела **Измерения** перетащите поле `ProductCategory` в секцию **Цвета**.
1. Отобразите чарт по неделям:

   1. В секции **X** нажмите на иконку с календарем у поля `OrderDate`.
   1. В поле **Группировка** выберите **Округление** → **Неделя**.

      ![chart-week-grouping](_assets/datalens/quickstart/chart-week-grouping-os.png)

   1. Нажмите кнопку **Применить**.

1. Уберите сортировку по показателю продаж — в секции **Сортировка** напротив поля `Sales` нажмите значок <!-- diplodoc:svg ![save-button](_assets/console-icons/xmark.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M3.47 3.47a.75.75 0 0 1 1.06 0L8 6.94l3.47-3.47a.75.75 0 1 1 1.06 1.06L9.06 8l3.47 3.47a.75.75 0 1 1-1.06 1.06L8 9.06l-3.47 3.47a.75.75 0 0 1-1.06-1.06L6.94 8 3.47 4.53a.75.75 0 0 1 0-1.06" clip-rule="evenodd"/></svg> (значок появляется при наведении указателя на поле).
1. В правом верхнем углу нажмите кнопку **Сохранить**.

   ![create-chart-2](_assets/datalens/quickstart/create-area-chart-os.png)



## Создайте чарт — круговая диаграмма {#create-pie-chart}

1. Создайте копию чарта, созданного на предыдущем шаге:

   1. В правом верхнем углу нажмите значок <!-- diplodoc:svg ![save-button](_assets/console-icons/chevron-down.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M2.97 5.47a.75.75 0 0 1 1.06 0L8 9.44l3.97-3.97a.75.75 0 1 1 1.06 1.06l-4.5 4.5a.75.75 0 0 1-1.06 0l-4.5-4.5a.75.75 0 0 1 0-1.06" clip-rule="evenodd"/></svg> → **Сохранить как копию**.
   1. В открывшемся окне введите название нового чарта `Продажи по категориям` и нажмите кнопку **Сохранить**.

1. Выберите тип визуализации **Круговая диаграмма**.
1. Добавьте в чарт категорию товаров. Для этого из раздела **Измерения** перетащите поле `ProductCategory` в секцию **Цвет**.
1. Проверьте, что в чарте есть показатель продаж. Для этого убедитесь, что в секции **Показатели** находится поле `Sales`, иначе перетащите его из раздела **Показатели**.
1. Добавьте подпись к показателям:

   1. Из раздела **Показатели** перетащите поле `Sales` в секцию **Подписи**.
   1. Нажмите на значок слева от названия показателя.
   1. В открывшемся окне для настройки **Значение подписи** выберите `В процентах` и нажмите кнопку **Применить**.

      ![value-as-percentage](_assets/datalens/quickstart/value-as-percentage-os.png)

1. В правом верхнем углу нажмите кнопку **Сохранить**.

   ![create-chart-3](_assets/datalens/quickstart/create-pie-chart-os.png)


## Создайте дашборд и добавьте на него чарты {#create-dashboard}

[Дашборд](./concepts/dashboard.md) — страница или набор страниц, на которых размещены виджеты. Позволяет собрать в одном месте чарты, добавить к ним поясняющие [надписи](./dashboard/widget.md#text) и [заголовки](./dashboard/widget.md#title).

Чтобы создать дашборд:


1. Перейдите в воркбук `Quick start` — нажмите его название в пути до чарта.

   ![chart-settings](_assets/datalens/quickstart/bread-crumbs-os.png)

1. В правом верхнем углу нажмите **Создать** → <!-- diplodoc:svg ![image](_assets/console-icons/layout-cells-large.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M12 3.5H8.75v3.75h4.75V5A1.5 1.5 0 0 0 12 3.5m1.5 5.25H8.75v3.75H12a1.5 1.5 0 0 0 1.5-1.5zm-6.25-1.5V3.5H4A1.5 1.5 0 0 0 2.5 5v2.25zM2.5 8.75h4.75v3.75H4A1.5 1.5 0 0 1 2.5 11zM4 2a3 3 0 0 0-3 3v6a3 3 0 0 0 3 3h8a3 3 0 0 0 3-3V5a3 3 0 0 0-3-3z" clip-rule="evenodd"/></svg> **Дашборд**.



1. На панели в нижней части страницы зажмите <!-- diplodoc:svg ![image](_assets/console-icons/chart-column.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><g clip-path="url(#svg-6yhi2vv7__a)"><path fill="currentColor" fill-rule="evenodd" d="M11.5 3.5h2a.5.5 0 0 1 .5.5v8a.5.5 0 0 1-.5.5h-2a.5.5 0 0 1-.5-.5V4a.5.5 0 0 1 .5-.5m-2.5 9a.5.5 0 0 0 .5-.5V7a.5.5 0 0 0-.5-.5H7a.5.5 0 0 0-.5.5v5a.5.5 0 0 0 .5.5zm-4.5 0A.5.5 0 0 0 5 12v-2a.5.5 0 0 0-.5-.5h-2a.5.5 0 0 0-.5.5v2a.5.5 0 0 0 .5.5zm-1 1.5h-1a2 2 0 0 1-2-2v-2a2 2 0 0 1 2-2h2q.26 0 .5.063V7a2 2 0 0 1 2-2h2q.26 0 .5.063V4a2 2 0 0 1 2-2h2a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2z" clip-rule="evenodd"/></g><defs><clipPath id="svg-6yhi2vv7__a"><path fill="currentColor" d="M0 0h16v16H0z"/></clipPath></defs></svg> **Чарт** и перетащите его в нужную область.
1. В открывшемся окне нажмите кнопку **Выбрать**.
1. Выберите чарт `Продажи по подкатегориям`.

   ![chart-settings](_assets/datalens/quickstart/chart-settings-os.png)

1. Нажмите кнопку **Добавить**.
1. Повторите шаги 3-6, чтобы добавить чарты `Продажи по неделям` и `Продажи по категориям`.
1. Установите размеры чартов с помощью мыши и расположите их на дашборде в удобном для вас порядке.

   ![chart-settings](_assets/datalens/quickstart/add-charts-os.png)

## Настройте фильтрацию чартов {#add-chart-chart-filtration}



Добавьте на дашборде [фильтрацию](./dashboard/chart-chart-filtration.md) чартом `Продажи по подкатегориям` других чартов:

1. В правом верхнем углу чарта `Продажи по подкатегориям` нажмите значок <!-- diplodoc:svg ![image](_assets/console-icons/gear.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M7.199 2H8.8a.2.2 0 0 1 .2.2c0 1.808 1.958 2.939 3.524 2.034a.2.2 0 0 1 .271.073l.802 1.388a.2.2 0 0 1-.073.272c-1.566.904-1.566 3.164 0 4.069a.2.2 0 0 1 .073.271l-.802 1.388a.2.2 0 0 1-.271.073C10.958 10.863 9 11.993 9 13.8a.2.2 0 0 1-.199.2H7.2a.2.2 0 0 1-.2-.2c0-1.808-1.958-2.938-3.524-2.034a.2.2 0 0 1-.272-.073l-.8-1.388a.2.2 0 0 1 .072-.271c1.566-.905 1.566-3.165 0-4.07a.2.2 0 0 1-.073-.27l.801-1.389a.2.2 0 0 1 .272-.072C5.042 5.138 7 4.007 7 2.199c0-.11.089-.199.199-.199M5.5 2.2c0-.94.76-1.7 1.699-1.7H8.8c.94 0 1.7.76 1.7 1.7a.85.85 0 0 0 1.274.735 1.7 1.7 0 0 1 2.32.622l.802 1.388c.469.813.19 1.851-.622 2.32a.85.85 0 0 0 0 1.472 1.7 1.7 0 0 1 .622 2.32l-.802 1.388a1.7 1.7 0 0 1-2.32.622.85.85 0 0 0-1.274.735c0 .939-.76 1.7-1.699 1.7H7.2a1.7 1.7 0 0 1-1.699-1.7.85.85 0 0 0-1.274-.735 1.7 1.7 0 0 1-2.32-.622l-.802-1.388a1.7 1.7 0 0 1 .622-2.32.85.85 0 0 0 0-1.471 1.7 1.7 0 0 1-.622-2.32l.801-1.389a1.7 1.7 0 0 1 2.32-.622A.85.85 0 0 0 5.5 2.2m4 5.8a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0M11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0" clip-rule="evenodd"/></svg>.

   ![chart-settings](_assets/datalens/quickstart/chart-dash-settings-os.png)

1. Включите опцию **Фильтрация**.

   ![chart-filtration-option](_assets/datalens/quickstart/chart-filtration-option-os.png)

1. Нажмите кнопку **Сохранить**.


По умолчанию фильтрующий чарт фильтрует данные во всех чартах текущей вкладки дашборда, которые построены по тому же датасету.

## Добавьте селектор на дашборд {#add-selectors}

[Селектор](./dashboard/selector.md) — это фильтр, который влияет на результаты запросов на связанных с ним виджетах.

Чтобы добавить селектор на дашборд:

1. На панели в нижней части страницы зажмите <!-- diplodoc:svg ![image](_assets/console-icons/sliders.svg)   --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M7.5 5a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0m1.405.75a3.001 3.001 0 0 1-5.81 0H1.747a.75.75 0 0 1 0-1.5h1.348a3.001 3.001 0 0 1 5.81 0h5.345a.75.75 0 0 1 0 1.5zm-7.158 4.5h5.345a3.001 3.001 0 0 1 5.811 0h1.347a.75.75 0 1 1 0 1.5h-1.347a3.001 3.001 0 0 1-5.81 0H1.746a.75.75 0 0 1 0-1.5m8.25-.75a1.5 1.5 0 1 0 0 3 1.5 1.5 0 0 0 0-3" clip-rule="evenodd"/></svg>**Селектор** и перетащите его в нужную область.
1. Добавьте селектор с календарем по датам заказа:

   1. Выберите датасет `Sales Dataset`.
   1. Выберите поле `OrderDate`.
   1. В поле **Заголовок** введите `Дата заказа`.
   1. Включите опцию **Диапазон**.

      ![selector-settings](_assets/datalens/quickstart/selector-settings-os.png)

   1. Нажмите кнопку **Сохранить**.

1. Расположите селектор на дашборде в удобном для вас месте.
1. Сохраните дашборд:

   1. В правом верхнем углу дашборда нажмите кнопку **Сохранить**.
   1. Введите название дашборда `Продажи` и нажмите кнопку **Создать**.

      ![add-selectors](_assets/datalens/quickstart/dashboard-saved-os.png)

## Изучите, как работает дашборд {#dashboard-work}



1. Примените фильтрацию чартов другими чартами на дашборде:

   1. В чарте `Продажи по подкатегориям` нажмите на столбец со значением `Кухонная`. Связанные чарты отфильтруются по выбранному измерению.

      ![chart-chart-filtration](_assets/datalens/quickstart/chart-chart-filtration-os.png)

   1. Сбросьте фильтрацию чартом: повторно нажмите на выбранный элемент или в правом верхнем углу чарта нажмите значок <!-- diplodoc:svg ![image](_assets/datalens/clear-filters.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" aria-hidden="true" class="yc-icon widget-header__icon-filter-clear"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 14 16"><path fill="currentColor" fill-rule="evenodd" d="M10.055 7.602 8.31 10.16a.354.354 0 0 0-.061.2v2.39c0 1.5-1.25 2.5-2.75 2.5s-1.75-1-1.75-1v-3.89a.354.354 0 0 0-.061-.2L.562 5.577A3.242 3.242 0 0 1 0 3.75c0-2 2.686-3 6-3 .461 0 .91.02 1.341.059a2.24 2.24 0 0 0-.323 1.478A13.777 13.777 0 0 0 6 2.25c-1.538 0-2.799.237-3.615.613-.814.375-.885.713-.885.887 0 .175.071.513.885.888.816.376 2.077.612 3.615.612.355 0 .695-.012 1.018-.036a2.24 2.24 0 0 0 .323 1.478c-.43.04-.88.058-1.341.058-1.114 0-2.158-.113-3.052-.339l1.98 2.904c.21.308.322.672.322 1.045v3.37c.06.011.141.02.25.02.422 0 .749-.14.95-.316a.86.86 0 0 0 .3-.683V10.36c0-.373.112-.737.322-1.045l1.214-1.78a2.241 2.241 0 0 0 1.77.067Zm-4.936 6.085c-.01-.006-.013-.01-.013-.01s.005.002.013.01Z" clip-rule="evenodd"/><path fill="currentColor" fill-rule="evenodd" d="M9.278.97a.75.75 0 0 0-1.06 1.06l1.72 1.72-1.72 1.72a.75.75 0 0 0 1.06 1.062L11 4.812l1.72 1.72a.75.75 0 1 0 1.06-1.062l-1.72-1.72 1.72-1.721A.75.75 0 0 0 12.72.97l-1.721 1.72L9.279.97Z" clip-rule="evenodd"/></svg></svg>.

1. Воспользуйтесь селектором по дате заказа:

   1. В селекторе `Дата заказа` введите даты начала и конца периода: `01.01.2019 - 31.01.2019`.
   1. Данные отфильтруются по полю `OrderDate` во всех чартах текущей вкладки дашборда, которые построены по тому же датасету.

      ![selector-filtration](_assets/datalens/quickstart/selector-filtration-os.png)

   1. Сбросьте фильтрацию селектором: в правом углу селектора нажмите значок <!-- diplodoc:svg ![save-button](_assets/console-icons/xmark.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M3.47 3.47a.75.75 0 0 1 1.06 0L8 6.94l3.47-3.47a.75.75 0 1 1 1.06 1.06L9.06 8l3.47 3.47a.75.75 0 1 1-1.06 1.06L8 9.06l-3.47 3.47a.75.75 0 0 1-1.06-1.06L6.94 8 3.47 4.53a.75.75 0 0 1 0-1.06" clip-rule="evenodd"/></svg>



## Что дальше {#whats-next}

* Ознакомьтесь с [концепциями сервиса](./concepts/index.md).
* Посмотрите [пример готового дашборда](https://datalens.yandex/9fms9uae7ip02).

<!-- source: ru/_includes/clickhouse-disclaimer.md -->
_ClickHouse® является зарегистрированным товарным знаком [ClickHouse, Inc](https://clickhouse.com)._
<!-- endsource: ru/_includes/clickhouse-disclaimer.md -->