Настройки датасета
Настройки датасета определяют, каким образом датасет будет работать с данными источника.
Подключение нескольких таблиц
Если в источнике доступно несколько таблиц, вы можете объединять их с помощью оператора JOIN.
Объединение происходит через создание связи. В связи вы указываете поля исходной таблицы и поля таблицы, с которой происходит объединение.
Доступны следующие операторы JOIN:
Режимы работы с источником данных
Датасет может работать в одном из двух режимов, который зависит от источника данных.
Датасет может работать с источником в следующих режимах:
- Прямой доступ. Все запросы к данным DataLens выполняет на стороне источника.
- Материализация. DataLens предварительно сохраняет данные в БД и работает с ними.
Примечание
Для источников Metrica API и AppMetrica API режим материализации недоступен.
Настроить загрузку данных в БД для этих источников можно с помощью подключения через Logs API.
Прямой доступ
Все запросы к данным исполняются на стороне источника.
Материализация
Материализация — процесс загрузки данных из источника в базу данных DataLens.
Материализация может происходить как единовременно, так и периодически по расписанию.
Единовременная материализация
Данные загружаются в БД материализации единовременно. После этого DataLens делает запросы только к материализованным данным.
Чтобы синхронизировать хранилище DataLens с источником, данные можно загрузить повторно.
Примечание
Если вы используете в качестве источника данных CSV-файл, DataLens автоматически материализует датасет.
Периодическая материализация
Данные загружаются в БД материализации DataLens по расписанию. Расписание задается в настройках датасета.
Например, по четвергам каждую вторую неделю в 03:00.
Минимальный доступный интервал — 1 раз в день.
Подключение через Logs API для источников Metrica и AppMetrica
Для источников Metrica и AppMetrica загрузка данных в БД материализации DataLens недоступна. Чтобы настроить автоматическую загрузку данных из этих источников, вы можете создать подключение к Metrica Logs API или AppMetrica Logs API и задать периодичность обновления данных. В этом случае данные из Metrica или AppMetrica будут загружаться в базу данных ClickHouse, которая будет использоваться в качестве источника для датасетов.
Для AppMetrica можно использовать также экспорт данных в Яндекс.Облако.
Фильтрация по умолчанию для новых чартов
В датасете можно создать фильтр по умолчанию. Он будет применен к любому новому чарту, созданному на основе данных из текущего датасета.
Примечание
- Фильтр для отдельного чарта задается в настройках чарта.
- Фильтры по умолчанию не применяются к данным в области предпросмотра датасета.
Фильтрация по умолчанию для новых чартов позволяет:
- Уменьшить объем данных, запрашиваемых из источника при построении чарта.
- Не добавлять одинаковые фильтры в новые чарты, созданные на основе данных из одного датасета.
Управление доступом
Вы можете настроить права доступа ко всему датасету. Подробнее в разделе Управление доступом к датасету.
Также можно разграничить доступ к данным на уровне строк (Row-level security или RLS). Подробнее в разделе Управление доступом к строкам данных датасета.
Выполнение SQL-запросов в датасетах
Источник данных датасета можно определять произвольными SQL-запросами над подключениями к БД. Текст запроса при обращении к источнику данных исполняется в виде подзапроса. Подробнее о том, как использовать SQL-запросы в датасете, читайте в разделе Описание датасета через SQL-запрос к источнику.
При использовании SQL-запросов в датасетах рекомендуется:
- Ограничить права пользователя, прописанного в подключении, до
read-only. - Пользователям, которые не должны иметь права на выполнение произвольного запроса, назначить право доступа
Исполнениена подключение и связанные с ним датасеты.
Включить или отключить использование подзапросов в качестве источника можно при создании подключения и при его редактировании.