Команда ReQL: status

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

table.status() → selection<object>

Описание

Возвращает состояние таблицы.

Результат — объект, содержащий информацию о фрагментах, репликах и состояниях готовности реплик таблицы. Более подробное описание полей объекта можно найти в разделе table_status таблиц в Системных таблицах.

• id: UUID таблицы.
• name: имя таблицы.
• db: база данных, в которой находится таблица.
• status: подполя в этом поле указывают, готовы ли все фрагменты таблицы принимать запросы данного типа: outdated_reads, reads и writes. Поле all_replicas_ready указывает, завершены ли все фоновые заполнения.
• shards: по одному элементу для каждого фрагмента в table_config. Каждый фрагмент представлен объектом с такими полями:
  • primary_replicas: список из нуля или более серверов, действующих как первичные реплики для таблицы.
  • replicas: список всех серверов, действующих как реплики для данного фрагмента. Поле state может принимать одно из следующих значений: ready, transitioning, backfilling, disconnected, waiting_for_primary, или waiting_for_quorum.

Пример: Получение состояния таблицы.

> r.table('superheroes').status().run(conn, callback);

Пример возвращаемого значения:

{
  "db": "database",
  "id": "5cb35225-81b2-4cec-9eef-bfad15481265",
  "name": "superheroes",
  "shards": [
    {
      "primary_replicas": ["jeeves"],
      "replicas": [
        {
          "server": "jeeves",
          "state": "ready"
        }
      ]
    },
    {
      "primary_replicas": ["jeeves"],
      "replicas": [
        {
          "server": "jeeves",
          "state": "ready"
        }
      ]
    }
  ],
  "status": {
    "all_replicas_ready": true,
    "ready_for_outdated_reads": true,
    "ready_for_reads": true,
    "ready_for_writes": true
  }
}