Команда ReQL: table

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

db.table(name[, {:read_mode => 'single', :identifier_format => 'name'}) → table

Описание

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

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

r.table('marvel').run(conn)

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

r.db('heroes').table('marvel').run(conn)

Есть два необязательных аргумента.

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

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

r.db('heroes').table('marvel', {:read_mode => 'outdated'}).run(conn)