Команда ReQL: table

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

db.table(name) → table

Описание

Возвращает все документы в таблице. Другие команды могут быть присоединены к table для возвращения подмножества документов (например, get и filter) или для дальнейшей обработки.

Пример: Возвращает все документы в таблице ‘marvel’ в базе данных по умолчанию.

r.table("marvel").run(conn);

Пример: Возвращает все документы в таблице ‘marvel’ в базе данных ‘heroes’.

r.db("heroes").table("marvel").run(conn);

Можно указать два optArgs.

• read_mode: Одно из трёх возможных значений, влияющих на гарантию согласованности при чтении таблицы:
  • single возвращает значения, присутствующие в памяти (но необязательно записанные на диск) на первичной реплике. Это значение по умолчанию.
  • majority возвращает только значения, надёжно сохранённые на диске на большинстве реплик. Это требует отправки сообщения каждой реплике при каждом чтении, поэтому это самый медленный, но самый согласованный вариант.
  • outdated возвращает значения, присутствующие в памяти на произвольно выбранной реплике. Это самый быстрый, но наименее согласованный вариант.
• identifier_format: возможные значения name и uuid, значение по умолчанию name. Если установлено uuid, то системные таблицы будут ссылаться на серверы, базы данных и таблицы по UUID вместо имён. (Это оказывает влияние только при работе с системными таблицами.)

Пример: Разрешить использование потенциально устаревших данных в обмен на более быстрое чтение.

r.db("heroes").table("marvel").optArg("read_mode", "outdated").run(conn);