[Документация Yandex Cloud](../index.md) > [Yandex DataLens](index.md) > Знакомство с сервисом > Начало работы

# Как начать работать с Yandex DataLens




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



## Перед началом работы {#before-you-begin}

Чтобы начать работать с DataLens:


{% list tabs group=datalens_user %}

- Новый пользователь {#new}

  1. [Войдите](https://passport.yandex.ru/auth) в ваш аккаунт на Яндексе. Если у вас еще нет аккаунта, [создайте](https://yandex.ru/support/passport/authorization/registration.html) его.
  1. Откройте [главную страницу](https://datalens.ru/promo) DataLens.
  1. Нажмите **Начать в облаке**.
  1. Подтвердите, что ознакомились с [Условиями использования](https://yandex.ru/legal/cloud_termsofuse/?lang=ru) и принимаете их и нажмите кнопку **Войти**.

- Уже использую Yandex Cloud {#already}

  1. [Войдите](https://passport.yandex.ru/auth) в ваш аккаунт на Яндексе.
  1. Откройте [главную страницу](https://datalens.ru/promo) DataLens.
  1. Нажмите **Начать в облаке**.
  1. Выберите один из вариантов:

     * Если у вас уже есть организация, выберите ее в выпадающем меню на вкладке **Организации** и нажмите **DataLens**.

       {% note info %}

       Для активации экземпляра DataLens пользователю нужна роль `admin` или `owner`. Подробнее про роли смотрите в разделе [Управление доступом в Yandex Identity Hub](../organization/security/index.md).

       {% endnote %}

     * Если у вас есть облако, но нет организации, нажмите **Добавить новый DataLens**. В открывшемся окне введите название и описание организации и нажмите **Создать организацию и DataLens**. Подробнее о работе с организациями смотрите в разделе [Начало работы с организациями](../organization/quickstart.md).

{% endlist %}

Если у вас возник технический вопрос по работе сервиса, обратитесь в [службу поддержки](https://kz.center.yandex.cloud/support) Yandex Cloud. Чтобы спросить совета, обсудить решение вашей задачи или лучшие практики работы сервиса, напишите в чат [DataLens](https://t.me/YandexDataLens) в Telegram.




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

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

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


1. Перейдите на [главную страницу](https://datalens.ru/?skipPromo=true) DataLens.
1. На панели слева нажмите ![image](../_assets/console-icons/thunderbolt.svg) **Подключения**.
1. Нажмите кнопку **Создать подключение**.
1. В разделе **Базы данных** выберите подключение **ClickHouse®**.

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

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

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

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

   1. Введите название [воркбука](workbooks-collections/index.md) `Quick start` и нажмите кнопку **Создать**.
   1. Выберите созданный воркбук и нажмите кнопку **Создать**.
   1. Введите название подключения `Sample ClickHouse` и нажмите кнопку **Создать**.




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

## Создайте датасет {#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.png)

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



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

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

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

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

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

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

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

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

      ![create-dataset](../_assets/datalens/quickstart/create-dataset.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.png)

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

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

   1. В правом верхнем углу нажмите значок ![save-button](../_assets/console-icons/chevron-down.svg) → **Сохранить как копию**.

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

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

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

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

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

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

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

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

1. Уберите сортировку по показателю продаж — в секции **Сортировка** напротив поля `Sales` нажмите значок ![save-button](../_assets/console-icons/xmark.svg) (значок появляется при наведении указателя на поле).
1. В правом верхнем углу нажмите кнопку **Сохранить**.

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


## Создайте чарт — карта {#create-map-chart}

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

   1. В правом верхнем углу нажмите значок ![save-button](../_assets/console-icons/chevron-down.svg) → **Сохранить как копию**.
   1. В открывшемся окне введите название нового чарта `Карта продаж` и нажмите кнопку **Сохранить**.

1. Выберите тип визуализации **Карта**.
1. Добавьте на карту координаты точек продаж. Для этого из раздела **Измерения** перетащите поле `ShopAddressCoord` в секцию **Точки (Геоточки)**.
1. Измените размер точек относительно показателя количества заказов. Для этого из раздела **Показатели** перетащите поле `OrderCount` в секцию **Размер точек**.
1. Измените цвет точек относительно показателя продаж. Для этого из раздела **Показатели** перетащите поле `Sales` в секцию **Цвета**.
1. Добавьте в секцию **Тултипы** поля:

    * `ShopAddress`
    * `ShopName`
    * `Sales`
    * `OrderCount`

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

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



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

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

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


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

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

1. В правом верхнем углу нажмите **Создать** → ![image](../_assets/console-icons/layout-cells-large.svg) **Дашборд**.



1. На панели в нижней части страницы зажмите ![image](../_assets/console-icons/chart-column.svg) **Чарт** и перетащите его в нужную область.
1. В открывшемся окне нажмите кнопку **Выбрать**.
1. Выберите чарт `Карта продаж`.

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

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

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

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


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

1. Наведите курсор на чарт `Карта продаж` и в правом верхнем углу нажмите значок ![image](../_assets/console-icons/gear.svg).

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

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

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

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



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

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

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

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

1. На панели в нижней части страницы зажмите ![image](../_assets/console-icons/sliders.svg)  **Селектор** и перетащите его в нужную область.
1. Добавьте селектор с календарем по датам заказа:

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

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

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

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

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

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

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


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

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

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

   1. Сбросьте фильтрацию чартом: повторно нажмите на выбранную точку или в правом верхнем углу чарта нажмите значок ![image](../_assets/datalens/clear-filters.svg).

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

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

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

   1. Сбросьте фильтрацию селектором: в правом углу селектора нажмите значок ![save-button](../_assets/console-icons/xmark.svg)




## Поделитесь дашбордом {#share}

Вы можете предоставить доступ к вашему дашборду другим пользователям:

1. [Добавьте](security/add-new-user.md) в DataLens пользователей с аккаунтами на Яндексе:

   1. На панели слева выберите ![image](../_assets/console-icons/sliders.svg) **Настройки сервиса**.
   1. Выберите вкладку **Пользователи**.
   1. В разделе **Пригласить пользователей**:

   1. Введите почтовые адреса пользователей, которых вы хотите пригласить (например, `login@yandex.ru`).

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

   1. Нажмите кнопку **Отправить приглашение**.

   Приняв приглашение и выбрав аккаунт для входа, пользователь сможет войти в вашу организацию и начать пользоваться DataLens. Пользователь получит роль `datalens.creator` в организации с текущим экземпляром DataLens. Для входа в DataLens пользователю потребуется [рабочее место](settings/seats.md).

      ![image](../_assets/datalens/settings/users-settings.png)

1. [Настройте права доступа](workbooks-collections/workbooks-operations.md#security) на воркбук:

   1. На панели слева выберите ![collections](../_assets/console-icons/rectangles-4.svg) **Коллекции и воркбуки**.
   1. Нажмите значок ![image](../_assets/console-icons/ellipsis.svg) у воркбука `Quick start` и выберите **Доступ**.

      ![wb-access](../_assets/datalens/quickstart/wb-access.png)

   1. Нажмите кнопку **Добавить пользователя**.

      ![wb-access](../_assets/datalens/quickstart/access.png)

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

Также вы можете предоставить [публичный доступ](concepts/datalens-public.md) к созданным чартам и дашбордам: у любого пользователя будет возможность пройти по ссылке и посмотреть опубликованный объект без авторизации. Опубликованные дашборды и чарты можно [встроить](security/embedded-objects.md) на сайт или в приложение с помощью элемента `iframe`.


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

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

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