Sqllab

Работа c SQL Lab

Для использования данного функционала пользователь должен иметь функциональную роль FUNC_CREATOR и доступ к подключению базы данных.

Дополнительная информация о функциональных ролях доступна здесь: Доступ к функциям платформы

Подробнее о доступе к данным можно узнать по следующей ссылке: Модель доступа к объектам данных

SQL Lab – это интегрированная среда разработки SQL на платформе MWS Data Compass, предназначенная для анализа и работы с подключенными источниками данных.
Ключевые возможности: + Создание кастомных SQL-запросов.
Пользователи могут писать собственные SQL-запросы к любой базе данных, поддерживающей Python-коннектор SQL Alchemy. + Доступ к метаданным базы данных.
SQL Lab предоставляет возможность исследовать метаданные, включая информацию о таблицах, столбцах, индексах и разделах. + Многооконный интерфейс.
Среда позволяет одновременно работать с несколькими запросами. + Управление запросами и их результатами: + Возможность сохранения запросов для повторного использования. + Создание наборов данных на основе результатов выполненных запросов. + Хранение истории всех выполненных запросов для удобства анализа. + Поддержка шаблонов с использованием языка Jinja.
Это позволяет интегрировать макросы в SQL-код, что значительно расширяет функциональность и гибкость запросов.

Начало работы

Для того чтобы приступить к работе с SQL Lab, выполните следующие шаги: 1. Переместите курсор на боковую панель слева, чтобы открыть навигационное меню. 2. Найдите и выберите раздел SQL, затем в появившемся выпадающем списке кликните на пункт Лаборатория SQL, чтобы перейти на страницу инструмента.

Создание запроса

Для создания первого запроса выберите необходимую базу данных в поле "База данных" и соответствующую схему в поле "Схема", данные которой будут использоваться в запросе. Для подключений с типом "MWS Data Engine" также необходимо указать "Каталог".
Введите SQL-запрос в предоставленное поле, используя тот диалект SQL, который соответствует вашей базе данных.
Например, чтобы отобразить первые 5 строк таблицы в базе данных Postgres, вы можете использовать следующий запрос:
```
SELECT *
FROM "имя таблицы"
limit 5
```
Затем нажмите Выполнить, чтобы увидеть результаты запроса.

Дополнительные возможности

Форматирование запроса и использование шаблонов Jinja

Чтобы отформатировать SQL-запрос, выберите в контекстном меню опцию Форматировать запрос.
Для использования шаблонов Jinja, нажмите на три точки, расположенные справа, чтобы открыть контекстное меню, и выберите пункт Параметры.

Сохранение запроса и создание набора данных

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

При создании набора данных на основе результатов SQL-запроса формируется виртуальный набор данных. Более подробную информацию о виртуальных наборах данных можно найти здесь: Виртуальный набор данных

Экспорт результатов и создание графика

Для перехода к созданию графика на основе результатов выполненного запроса, нажмите на кнопку Создать график, расположенную в блоке "Результаты".
Чтобы сохранить результаты запроса в формате CSV, выберите опцию Сохранить в CSV.
Для копирования результатов запроса в буфер обмена, нажмите на кнопку Скопировать в буфер обмена.

Создание новых таблиц и представлений

Для создания новой таблицы в базе данных на основе результатов вашего запроса, нажмите на выпадающее меню рядом с кнопкой "Выполнить" и выберите пункт Создать таблицу.
Чтобы создать представление в базе данных на основе результатов вашего запроса, нажмите на выпадающее меню рядом с кнопкой "Выполнить" и выберите пункт Создать представление.

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

Использование Виртуального Помощника для написания SQL запросов

Выберите БД, Схему, Таблицу и нажмите "Обновить контекст" для передачи контекста Виртуальному Помощнику
Во вкладке "ИИ-Помощник" напишите свой запрос для генерации на человеческом языке и отправьте его
Дождитесь результата генерации, сгенерированный запрос сразу окажется в окне редактирования SQL