mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-17 21:24:28 +00:00
107 lines
4.7 KiB
Markdown
107 lines
4.7 KiB
Markdown
---
|
||
toc_priority: 53
|
||
toc_title: WATCH
|
||
---
|
||
|
||
# Запрос WATCH {#watch}
|
||
|
||
!!! important "Важно"
|
||
Это экспериментальная функция. Она может повлечь потерю совместимости в будущих версиях.
|
||
Чтобы использовать `LIVE VIEW` и запросы `WATCH`, включите настройку `set allow_experimental_live_view = 1`.
|
||
|
||
**Синтаксис**
|
||
|
||
``` sql
|
||
WATCH [db.]live_view [EVENTS] [LIMIT n] [FORMAT format]
|
||
```
|
||
|
||
Запрос `WATCH` постоянно возвращает содержимое [LIVE-представления](./create/view.md#live-view). Если параметр `LIMIT` не был задан, запрос `WATCH` будет непрерывно обновлять содержимое [LIVE-представления](./create/view.md#live-view).
|
||
|
||
```sql
|
||
WATCH [db.]live_view;
|
||
```
|
||
## Виртуальные столбцы {#watch-virtual-columns}
|
||
|
||
Виртуальный столбец `_version` в результате запроса обозначает версию данного результата.
|
||
|
||
**Пример:**
|
||
|
||
```sql
|
||
CREATE LIVE VIEW lv WITH REFRESH 5 AS SELECT now();
|
||
WATCH lv;
|
||
```
|
||
|
||
```bash
|
||
┌───────────────now()─┬─_version─┐
|
||
│ 2021-02-21 09:17:21 │ 1 │
|
||
└─────────────────────┴──────────┘
|
||
┌───────────────now()─┬─_version─┐
|
||
│ 2021-02-21 09:17:26 │ 2 │
|
||
└─────────────────────┴──────────┘
|
||
┌───────────────now()─┬─_version─┐
|
||
│ 2021-02-21 09:17:31 │ 3 │
|
||
└─────────────────────┴──────────┘
|
||
...
|
||
```
|
||
|
||
По умолчанию запрашиваемые данные возвращаются клиенту, однако в сочетании с запросом [INSERT INTO](../../sql-reference/statements/insert-into.md) они могут быть перенаправлены для вставки в другую таблицу.
|
||
|
||
**Пример:**
|
||
|
||
```sql
|
||
INSERT INTO [db.]table WATCH [db.]live_view ...
|
||
```
|
||
|
||
## Секция EVENTS {#events-clause}
|
||
|
||
С помощью параметра `EVENTS` можно получить компактную форму результата запроса `WATCH`. Вместо полного результата вы получаете номер последней версии результата.
|
||
|
||
```sql
|
||
WATCH [db.]live_view EVENTS;
|
||
```
|
||
|
||
**Пример:**
|
||
|
||
```sql
|
||
CREATE LIVE VIEW lv WITH REFRESH 5 AS SELECT now();
|
||
WATCH lv EVENTS;
|
||
```
|
||
|
||
```bash
|
||
┌─version─┐
|
||
│ 1 │
|
||
└─────────┘
|
||
┌─version─┐
|
||
│ 2 │
|
||
└─────────┘
|
||
...
|
||
```
|
||
|
||
## Секция LIMIT {#limit-clause}
|
||
|
||
Параметр `LIMIT n` задает количество обновлений запроса `WATCH`, после которого отслеживание прекращается. По умолчанию это число не задано, поэтому запрос будет выполняться постоянно. Значение `LIMIT 0` означает, что запрос `WATCH` вернет единственный актуальный результат запроса и прекратит отслеживание.
|
||
|
||
```sql
|
||
WATCH [db.]live_view LIMIT 1;
|
||
```
|
||
|
||
**Пример:**
|
||
|
||
```sql
|
||
CREATE LIVE VIEW lv WITH REFRESH 5 AS SELECT now();
|
||
WATCH lv EVENTS LIMIT 1;
|
||
```
|
||
|
||
```bash
|
||
┌─version─┐
|
||
│ 1 │
|
||
└─────────┘
|
||
```
|
||
|
||
## Секция FORMAT {#format-clause}
|
||
|
||
Параметр `FORMAT` работает аналогично одноименному параметру запроса [SELECT](../../sql-reference/statements/select/format.md#format-clause).
|
||
|
||
!!! info "Примечание"
|
||
При отслеживании [LIVE VIEW](./create/view.md#live-view) через интерфейс HTTP следует использовать формат [JSONEachRowWithProgress](../../interfaces/formats.md#jsoneachrowwithprogress). Постоянные сообщения об изменениях будут добавлены в поток вывода для поддержания активности долговременного HTTP-соединения до тех пор, пока результат запроса изменяется. Проомежуток времени между сообщениями об изменениях управляется настройкой[live_view_heartbeat_interval](./create/view.md#live-view-settings).
|