Команда ReQL: table

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

db.table(name[, read_mode='single', identifier_format='name']) → table

Описание

Возвращает все документы в таблице. Другие команды могут быть объединены после 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)