Skip to main content
Skip to main content

Запрос WATCH

Важно

Это экспериментальная функция. Она может повлечь потерю совместимости в будущих версиях. Чтобы использовать LIVE VIEW и запросы WATCH, включите настройку set allow_experimental_live_view = 1.

Синтаксис

Запрос WATCH постоянно возвращает содержимое LIVE-представления. Если параметр LIMIT не был задан, запрос WATCH будет непрерывно обновлять содержимое LIVE-представления.

Виртуальные столбцы

Виртуальный столбец _version в результате запроса обозначает версию данного результата.

Пример:

По умолчанию запрашиваемые данные возвращаются клиенту, однако в сочетании с запросом INSERT INTO они могут быть перенаправлены для вставки в другую таблицу.

Пример:

Секция EVENTS

С помощью параметра EVENTS можно получить компактную форму результата запроса WATCH. Вместо полного результата вы получаете номер последней версии результата.

Пример:

Секция LIMIT

Параметр LIMIT n задает количество обновлений запроса WATCH, после которого отслеживание прекращается. По умолчанию это число не задано, поэтому запрос будет выполняться постоянно. Значение LIMIT 0 означает, что запрос WATCH вернет единственный актуальный результат запроса и прекратит отслеживание.

Пример:

Секция FORMAT

Параметр FORMAT работает аналогично одноименному параметру запроса SELECT.

Примечание

При отслеживании LIVE VIEW через интерфейс HTTP следует использовать формат JSONEachRowWithProgress. Постоянные сообщения об изменениях будут добавлены в поток вывода для поддержания активности долговременного HTTP-соединения до тех пор, пока результат запроса изменяется. Проомежуток времени между сообщениями об изменениях управляется настройкойlive_view_heartbeat_interval.