ERASE_WRITE_OPERATION

Содержание раздела
  1. Действия перед запросом
  2. Отмена операции при отключенном восстановлении состояния ноды
  3. Синтаксис
  4. Варианты ответа
  5. Ограничения
  6. Примеры

Поддерживается в версиях:  6.7 / 6.6 / 6.5 / 6.4 / 6.3 / 6.2 / 6.1 / 6.0 / 5.8 / 5.7 / 5.6 / 5.5.

Запрос отменяет незавершенную операцию записи. Можно отменить любую операцию:

Действия перед запросом

Перед использованием запроса для операции обновления данных убедитесь, что операция не исполняется в СУБД. Иначе, если операция продолжает исполняться в СУБД, вместо ERASE_WRITE_OPERATION повторите запрос обновления данных, добавив в него ключевое слово RETRY.

Подробнее о RETRY см. в описании запросов обновления данных, например в INSERT VALUES.

Отмена операции при отключенном восстановлении состояния ноды

Если параметр конфигурации AUTO_RESTORE_STATE имеет значение false, нода не восстанавливает свое состояние после перезапуска. В частности это означает, что нода не возобновляет незавершенные операции загрузки данных, начатые до перезапуска.

Чтобы после перезапуска ноды отменить операцию записи, начатую до перезапуска ноды, на любой из активных нод выполните RESUME_WRITE_OPERATION, а затем — ERASE_WRITE_OPERATION.

Синтаксис 

ERASE_WRITE_OPERATION(sys_cn[, db_name])

Параметры:

sys_cn

Номер операции записи. Номера незавершенных операций можно получить с помощью запроса GET_WRITE_OPERATIONS.

db_name

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

Варианты ответа

В ответе возвращается:

  • пустой объект ResultSet при успешном выполнении запроса;
  • исключение при неуспешном выполнении запроса.

Ограничения

  • Запрос не гарантирует отмену всех изменений, внесенных операцией обновления данных.
  • При обработке запроса все неактивные датасорсы пропускаются без возврата ошибки. Ошибка возвращается, если не осталось ни одного активного датасорса, подходящего для исполнения запроса.

Примеры

Отмена операции в указанной логической базе данных:

ERASE_WRITE_OPERATION(10, marketing)

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

-- выбор логической базы данных marketing в качестве базы данных по умолчанию
USE marketing;

-- отмена операции в логической БД marketing
ERASE_WRITE_OPERATION(10);