Команда ReQL: table

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

db.table(name[, {readMode: 'single', identifierFormat: 'name'}]) → table

Описание

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

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

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

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

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

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

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

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

r.db('heroes').table('marvel', {readMode: 'outdated'}).run(conn, callback)