Обновить запись / UPDATE

Группа действий: Базы данных

Действие обновляет данные в записи указанной таблицы БД по значению ее первичного ключа.

Параметры

Входные параметры:

Контекст БД – Контекст подключения к выбранной базе данных;
Имя таблицы – Имя таблицы в БД;
Данные для обновления записи – Словарь данных записей, которые будут обновлены;
Первичный ключ – Словарь полей, с помощью которых однозначно определяют запись, которую необходимо обновить.

Настройки

Свойство	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст БД	Контекст подключения к выбранной базе данных.	Robin.DbContext	Контекст баз данных	Да
Имя таблицы	Имя таблицы	Robin.String		Да
Данные для обновления записи	Данные для вставки в виде словаря, где ключи - это имена столбцов.	Robin.Dictionary		Да
Первичный ключ	Поле или комбинация полей, которые однозначно определяют запись, которую необходимо обновить. Задается в виде словаря, где парами «ключ-значение» являются имена столбцов первичного ключа и содержимое их полей.	Robin.Dictionary		Да

Особые условия использования

Отсутствуют.

Пример использования

Задача: подключиться к базе данных и обновить данные по одной строке таблицы по столбцам company_name и inn (id=9). Обновить на данные: ООО "Ромашка", 5013047634

Решение: воспользоваться действиями "Стандартное подключение", "Обновить запись".

Реализация:

Собрать робота, состоящего из действий:
Настроить параметры для действия "Стандартное подключение".
В поле "Тип СУБД" выбрать соответствующий той базе данных, к которой необходимо подключиться.
Указать логин и пароль от базы данных.
Хост сервера можно указать, как по IP машины, где установлена база или по имени хоста.
Указать порт сервера, а также имя БД.
В поле "Таймаут" значение исчисляется в секундах.
В поле "Параметры" указываются дополнительные параметры для подключения, как правило, это параметры, которые относятся к безопасности. Параметры указываются в виде словаря.

Подробнее о параметре "Уровень изоляции транзакций". Последовательные операции по работе с БД можно разделить на транзакции. Транзакция - это группа операций, которые представляют некую логическую единицу работы с базой. Например, необходимо выполнить несколько операций с таблицей для того, чтобы обновить в ней данные. При возникновении ошибки можно откатить транзакцию, т.е сделанную группу операций, чтобы не разбираться на каком шаге возникла данная ошибка.

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