Работа с базами данных
8 800 555-89-02
Войти
Документация
CTRL+K
Standalone2410
SaaS

Работа с базами данных

В этой статье

Работа с базами данных осуществляется с помощью блоков:

В каждом блоке с SQL-запросом и в блоке «Добавить строки» можно подставить названия колонок с помощью визуального маппинга. В одном SQL-запросе могут быть указаны разные поля маппинга: те, что используются в безопасном режиме, и те, что его игнорируют. Чтобы отключить безопасный режим и подставить название колонки или таблицы в запрос, добавьте знак ! перед полем маппинга.

Предупреждение

Отключение безопасного режима может привести к SQL-инъекциям. Применяйте этот функционал только в том случае, если вы полностью уверены в безопасности значений в используемых переменных.

Подставить названия колонок в SQL-запрос

SQL-запрос

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

У SQL-запроса обязательными параметрами являются запрос и подключение (при обращении к БД).

Пример удаления данных из таблицы с помощью запроса:

  1. Возьмем таблицу phases. Таблица
  2. В скрипт добавим блок SQL-запрос и создадим запрос в соответствующем поле. SQL-запрос
  3. Протестируем и вернемся в таблицу, чтобы убедиться, что данные удалены. Пустая таблица

Выбрать строки через SQL-запрос

Блок позволяет создать произвольный SQL-запрос в определенный пакет.

Параметры блока:

  • SQL-запрос (инструкции выбора SELECT)
  • Limit (количество строк)
  • Offset (количество пропускаемых строк)
  • Order by (порядок строк/сортировать по)

Выбрать строки через SQL

Добавить строки

Блок используется для заполнения и создания таблиц с использованием выходных данных предыдущих блоков.

Обязательные параметры блока:

  • Подключение (при обращении к БД)
  • Таблица (можно выбрать из списка или задать вручную)
  • Колонки (название, значение)

Добавить строки

Через редактор таблиц на левой панели вы можете изменять, добавлять и удалять колонки. Изменения влияют на таблицы в пространстве.

Чтобы создать таблицу:

  1. Нажмите на название таблицы и выберите Добавить таблицу. Добавить таблицу
  2. Выберите Создать новую и заполните поля:
    • Название таблицы
    • Название колонки
    • Тип данных
    Создать новую Чтобы добавить новую колонку, кликните + Добавить колонку. При нажатии на Выбрать из выходных полей открывается окно с выходными данными. С их помощью можно добавлять колонки из данных предыдущих блоков.
    • Создать из выходных данных. Появляется список колонок из предыдущих блоков. Вы можете выбрать колонки по одной или отметить блок и автоматически выбрать все его колонки
    Создать из выходных данных
  3. Для сохранения нажмите Добавить, чтобы отменить действие нажмите Отмена.

В этом блоке можно использовать визуальный маппинг.

Обновить строки

Блок обновляет информацию в таблицах с помощью маппинга.

Обязательные параметры блока:

  • Подключение (при обращении к БД)
  • Таблица
  • Колонка-ключ (указывается колонка, по которой будут сравниваться значения)
  • Значение ключа (указывается значение колонки-ключа)
  • Новые значения колонок

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

Обновить строки

Получить схему таблицы

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

В параметрах блока необходимо указать таблицу из базы данных. Выберите таблицу из списка или введите её название вручную.

SQL-запрос

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

Выходные данные

Получить системную таблицу

Блок предназначен для поставки в ClickHouse обновленных данных из системных таблиц. Необходимо выбрать доступную исходную системную таблицу и ее поля. Блок при каждом запуске возвращает все строки таблицы, а не только новые после предыдущего запуска.

Параметры блока:

  • Таблица (выбрать из списка)
  • Колонки (Можно выбрать любое количество колонок. Если не выбрано ни одной колонки, то автоматически считается, что выбраны все)

Получить системную таблицу

Важно
  • Должна быть выбрана таблица, иначе блок невозможно протестировать, а скрипт с этим блоком невозможно опубликовать.
  • Для работы с блоком необходима привилегия Системные таблицы.

Описание полей системных таблиц, доступных для обновления через блок в скрипте автоматизации, представлено в разделе Системные таблицы.

Создать таблицу

Используйте блок, чтобы создавать таблицы в базе данных пространства при работе в кластерном режиме. Если кластер отсутствует, блок будет работать в некластерном режиме.

Параметры блока:

  • Название таблицы (указать с помощью маппинга)
  • Форма запроса (выбрать из списка)
  • На основе данных
  • Колонки (отображается, если опция «На основе данных» выключена. Необходимо указать название и тип данных. Также вы можете включить null-значения у колонок)
  • Select-запрос (отображается, если опция «На основе данных» включена. Введите часть запроса, начинающуюся c SELECT)
  • Партиционирование
  • Сортировка

Создать таблицу

Блок не возвращает данные.

Пример создания таблицы с помощью блока:

  1. Подставим название таблицы в соответствующее поле с помощью маппинга. Название таблицы
  2. Выберем форму запроса «Создать таблицу, если не существует».
  3. Зададим колонки, которые должны быть в таблице.
  4. Укажем колонку, по которой таблица будет сортироваться. Параметры таблицы
  5. Протестируем блок.
  6. Блок не возвращает данные, поэтому во вкладке Тест мы видим только то, что он успешно выполнен. Результат тестирования блока

Удалить таблицу

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

В параметрах блока с помощью визуального маппинга укажите таблицу, которую необходимо удалить.

Удалить таблицу

Блок не возвращает данные.

Переименовать таблицу

Используйте блок, чтобы переименовать таблицы в базе данных пространства при работе в кластерном режиме.

Параметры:

  • Таблица (подставьте с помощью маппинга)
  • Новое имя

Переименовать таблицу

Блок не возвращает данные.

Очистить таблицу

Используйте блок, чтобы очищать данные выбранных таблиц в базе данных пространства при работе в кластерном режиме.

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

Очистить таблицу

Блок не возвращает данные.

Использование сессий

Для всех блоков пакетов «Пространство» и «ClickHouse» есть возможность активировать режим сессий, который позволяет отправлять запросы в ClickHouse в рамках сессии и предоставляет возможность работать с временными таблицами и параметрами.

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

Активировать режим сессий

Время сессий у блоков пакета «ClickHouse» настраивается при создании подключения в пространстве.

Время сессий у блоков пакета «Пространство» указывается в настройках хранилища данных.

Блоки, для которых возможно использовать режим сессий:

  • SQL-запрос
  • Добавить строки
  • Выбрать строки через SQL-запрос
  • Обновить строки
  • Получить схему таблицы

Была ли статья полезна?

Да
Нет
Предыдущая
Редактирование скрипта
8 (800) 555-89-028 (495) 150-31-45team@infomaximum.com
Для бизнеса
© 20102024. ООО «Инфомаксимум»
Мы используем файлы cookies, чтобы сайт был лучше для вас.