Команда ReQL: wait

Синтаксис команды

table.wait([{:wait_for => 'all_replicas_ready', :timeout => <sec>}]) → object
database.wait([{:wait_for => 'all_replicas_ready', :timeout => <sec>}]) → object
r.wait(table | database, [{:wait_for => 'all_replicas_ready', :timeout => <sec>}]) → object

Описание

Ожидание готовности таблицы (или таблиц). Таблица может быть временно недоступна после создания, перебалансировки или переконфигурации.

Команда wait принимает два необязательных аргумента:

• wait_for: строка, указывающая статус таблицы статус, на котором следует ожидать, одно из значений ready_for_outdated_reads, ready_for_reads, ready_for_writes, или all_replicas_ready. По умолчанию all_replicas_ready.
• timeout: число, обозначающее максимальное время в секундах ожидания готовности таблицы. Если это значение будет превышено, будет выброшено ReqlRuntimeError. Значение 0 означает отсутствие таймаута. По умолчанию 0 (без таймаута).

Результат — объект, содержащий единственное поле ready. Значение — целое число, указывающее количество ожидаемых таблиц. Оно всегда равно 1 при вызове wait для одной таблицы, и общему количеству таблиц при вызове для базы данных.

Версии RethinkDB до 2.3 позволяли вызывать wait без указания таблицы или базы данных. Это больше не поддерживается; wait требует явного выбора базы данных или таблицы.

Пример: Ожидание готовности таблицы.

> r.table('superheroes').wait().run(conn)

{:ready => 1}