API множественного получения (mget)

См. Управление доступом через URL.

Для обеспечения быстрых ответов API множественного получения возвращает частичные результаты, если один или несколько фрагментов завершились с ошибкой. Подробнее см. Ошибки фрагментов.

Если вы указываете индекс в URI запроса, требуются только ID документов в теле запроса:

GET /my-index-000001/_mget
{
  "docs": [
    {
      "_type": "_doc",
      "_id": "1"
    },
    {
      "_type": "_doc",
      "_id": "2"
    }
  ]
}

И тип:

GET /test/_doc/_mget
{
  "docs": [
    {
      "_id": "1"
    },
    {
      "_id": "2"
    }
  ]
}

Вы можете использовать элемент ids для упрощения запроса:

GET /my-index-000001/_mget
{
  "ids" : ["1", "2"]
}

По умолчанию поле _source возвращается для каждого документа (если оно сохранено). Используйте атрибуты _source и _source_include или source_exclude, чтобы отфильтровать, какие поля возвращаются для конкретного документа. Вы можете включить параметры запроса _source, _source_includes и _source_excludes в URI запроса, чтобы указать значения по умолчанию, используемые при отсутствии инструкций для каждого документа.

Например, следующий запрос устанавливает _source в false для документа 1, чтобы полностью исключить source, извлекает field3 и field4 из документа 2 и извлекает поле user из документа 3, но фильтрует поле user.location.

GET /_mget
{
  "docs": [
    {
      "_index": "test",
      "_type": "_doc",
      "_id": "1",
      "_source": false
    },
    {
      "_index": "test",
      "_type": "_doc",
      "_id": "2",
      "_source": [ "field3", "field4" ]
    },
    {
      "_index": "test",
      "_type": "_doc",
      "_id": "3",
      "_source": {
        "include": [ "user" ],
        "exclude": [ "user.location" ]
      }
    }
  ]
}

Используйте атрибут stored_fields для указания набора сохраненных полей, которые вы хотите получить. Любые запрошенные поля, которые не сохраняются, игнорируются. Вы можете включить параметр запроса stored_fields в URI запроса, чтобы указать значения по умолчанию, используемые при отсутствии инструкций для каждого документа.

Например, следующий запрос извлекает field1 и field2 из документа 1 и field3 и field4 из документа 2:

GET /_mget
{
  "docs": [
    {
      "_index": "test",
      "_type": "_doc",
      "_id": "1",
      "stored_fields": [ "field1", "field2" ]
    },
    {
      "_index": "test",
      "_type": "_doc",
      "_id": "2",
      "stored_fields": [ "field3", "field4" ]
    }
  ]
}

Следующий запрос извлекает field1 и field2 по умолчанию для всех документов. Эти поля по умолчанию возвращаются для документа 1, но переопределяются на возвращение field3 и field4 для документа 2.

GET /test/_doc/_mget?stored_fields=field1,field2
{
  "docs": [
    {
      "_id": "1"
    },
    {
      "_id": "2",
      "stored_fields": [ "field3", "field4" ]
    }
  ]
}

Если при индексировании используется маршрутизация, вам необходимо указать значение маршрутизации для получения документов. Например, следующий запрос извлекает test/_doc/2 из фрагмента, соответствующего ключу маршрутизации key1, и извлекает test/_doc/1 из фрагмента, соответствующего ключу маршрутизации key2.

GET /_mget?routing=key1
{
  "docs": [
    {
      "_index": "test",
      "_type": "_doc",
      "_id": "1",
      "routing": "key2"
    },
    {
      "_index": "test",
      "_type": "_doc",
      "_id": "2"
    }
  ]
}