| Оглавление |
|---|
| Информация |
|---|
SQL Backend представляет из себя отдельную настройку на ViQube, за счет которой запросы выполняются либо на данных ViQube, либо в сторонней базе (далее SQL-СУБД). Данная статья описывает как произвести настройку SQL Backend на ViQube, что позволит ретранслировать запросы в SQL-СУБД, например ClickHouse. Полный перечень поддерживаемых СУБД приведен в [DRAFT] Прямое подключение к источнику данных (SQL Backend). |
Основные этапы настройки SQL Backend
| Примечание |
|---|
На момент настройки в SQL-СУБД уже должны быть таблицы, наполненные данными. |
Основные этапы настройки SQL Backend:
- Создание в ViQube таблиц, идентичных в используемой SQL-СУБД
- Подготовка и применение структуры маппинга с помощью API
Создание таблиц, идентичных SQL-СУБД
В ViQube необходимо создать такие же таблицы, как и в используемой SQL-СУБД.
- ViQube берет запрос и транслирует в SQL, запрос выполняется и возвращаются данные. Эти данные попадают в таблицу с результатом. Поэтому в ViQube должна быть точно такая же структура таблицы с точно такими же типами полей, чтобы можно было вывести результирующую таблицу.
- Наименования таблицы и столбцов могут отличаться, но типы данных должны быть одинаковыми. Это необходимо для корректного маппинга при трансляции запросов в SQL-СУБД.
- Если в таблице в SQL-СУБД есть дополнительные столбцы, которых нет в таблице в ViQube и их использовать не планируется, то такое расхождение а таблицах допустимо. ViQube просто будет их игнорировать, если не указывать их в настройках SQL Backend.
| Информация |
|---|
Создать таблицы можно с помощью стандартного механизма Загрузчиков. Например, загрузив только первые 10 строк. В дальнейшем при подключении этой таблицы к SQL-СУБД данные из ViQube будут игнорироваться. Описание создания таблиц с помощью загрузчиков приводится в разделе: Загрузка данных и формирование структуры в аналитической базе данных ViQube. |
Настройка с помощью API
Работа с SQL Backend на ViQube происходит с помощью запросов по API.
...
- Чтобы применить новые настройки SQL Backend необходимо отправить PUT-запрос с подготовленными настройками. Подробное описание структуры настроек приведено в разделе "Структура настроек SQL Backend".
- В случае успешного применения настроек будет возвращено "200".
- После успешного применения настроек все таблицы, которые были настроены на SQL-СУБД при запросах будут обращаться напрямую в SQL-СУБД, а не ViQube.
Структура настроек SQL Backend
Настройки SQL backend состоят из:
- строки подключения, параметров подключения
- описания соответствия таблиц и колонок в ViQube и SQL-СУБД
| Параметр | Описание |
|---|---|
| Информация |
|---|
Шаблоны для настроек поддерживаемых СУБД приведены в разделе: [DRAFT] Шаблоны настроек для поддерживаемых СУБД |
Пример настройки
Пример настройки SQL Backend на ClikHouse:
| View file | ||||
|---|---|---|---|---|
|