/{db}/_design/{ddoc}/_nouveau/{index}
Предупреждение
Nouveau — экспериментальная функция. В будущих выпусках работа конечных точек может измениться, а существующие индексы могут стать недействительными.
Предупреждение
Для работы конечных точек Nouveau необходим запущенный сервер nouveau. Подробнее см. в разделе Установка сервера Nouveau.
Добавлено в версии 3.4.0.
-
GET/{db}/_design/{ddoc}/_nouveau/{index} -
Выполняет запрос nouveau к указанному индексу в указанном документе дизайна.
- Параметры:
-
db – Имя базы данных
ddoc – Имя документа дизайна
index – Имя индекса Nouveau
- Заголовки запроса:
-
-
Accept –
application/json
-
- Параметры запроса:
-
bookmark (string) – Закладка, полученная в результате предыдущего поиска. Этот параметр позволяет постранично просматривать результаты. Если после закладки результатов больше нет, в ответе будет пустой массив rows и та же закладка, подтверждающая, что список результатов закончился.
counts (json) – Массив имен строковых полей, для которых требуется получить количество значений. Ответ содержит количество каждого уникального значения данного поля среди документов, соответствующих поисковому запросу.
include_docs (boolean) – Включить в ответ полное содержимое документов.
locale (string) – Локаль (Java), используемая для разбора чисел в запросах с диапазонами. Если параметр не указан, используется локаль JDK по умолчанию. Например:
de,us,gb.limit (number) – Ограничить число возвращаемых документов указанным значением.
q (string) – Обязательный параметр. Строка запроса Lucene.
ranges (json) – Это поле задает диапазоны для числовых поисковых полей. Значение — объект JSON, в котором имена полей являются числовыми поисковыми полями, а значения полей — массивами объектов JSON. Объекты должны содержать значения
label,minиmax(соответственно строкового, числового и числового типа), а также необязательные свойстваmin_inclusiveиmax_inclusive(если они не указаны, используется значениеtrue). Пример:{"bar":[{"label":"cheap","min":0,"max":100}]}sort (json) – Задает порядок сортировки результатов. По умолчанию результаты сортируются по релевантности. Строка JSON вида
"fieldname"или"-fieldname"для сортировки по убыванию, где fieldname — имя строкового или double-поля. Для сортировки по одному полю можно указать строку, а для сортировки по нескольким полям — массив строк; поля будут отсортированы в порядке их следования в массиве. Например:"relevance","bar","-foo"и ["-foo","bar"].top_n (number) – Ограничить число фасетов, возвращаемых группой. По умолчанию — 10, максимальное значение — 1000.
update (boolean) – Установите значение
false, чтобы разрешить использование устаревшего индекса.
- Заголовки ответа:
-
-
application/json
Transfer-Encoding –
chunked
-
- Объект JSON ответа:
-
hits (array) – Массив результатов поиска. По умолчанию возвращаемые сведения содержат только идентификатор документа и ревизию.
total_hits (number) – Число совпадений с запросом.
total_hits_relation (string) –
EQUAL_TO, еслиtotal_hitsявляется точным.GREATER_THAN_OR_EQUAL_TOв противном случае.bookmark (string) – Непрозрачный идентификатор для постраничного просмотра результатов.
- Коды состояния:
-
200 OK – Запрос успешно выполнен
400 Bad Request – Некорректный запрос
401 Unauthorized – Требуется разрешение на чтение
403 Forbidden – Недостаточно прав / Слишком много запросов с недействительными учетными данными
404 Not Found – Указанная база данных, документ дизайна или представление не найдены
Примечание
Фасетный поиск не поддерживается для поиска по разделам, поэтому в таких запросах не следует использовать следующие параметры запроса: counts и ranges.
См. также
Дополнительные сведения о работе nouveau см. в Руководстве пользователя Nouveau.
/{db}/_design/{ddoc}/_nouveau_info/{index}
Предупреждение
Nouveau — экспериментальная функция. В будущих выпусках работа конечных точек может измениться, а существующие индексы могут стать недействительными.
Предупреждение
Для работы конечных точек Nouveau необходим запущенный сервер nouveau. Подробнее см. в разделе Установка сервера Nouveau.
Добавлено в версии 3.4.0.
-
GET/{db}/_design/{ddoc}/_nouveau_info/{index} -
- Параметры:
-
db – Имя базы данных
ddoc – Имя документа дизайна
index – Имя поискового индекса
- Коды состояния:
-
200 OK – Запрос успешно выполнен
400 Bad Request – Тело запроса некорректно (имеет неверный формат или в нем отсутствует обязательное поле)
401 Unauthorized – Неавторизованный запрос к защищенному API
403 Forbidden – Недостаточно прав / Слишком много запросов с недействительными учетными данными
500 Internal Server Error – Произошла ошибка сервера (или ошибка другого типа)
Запрос:
GET /recipes/_design/cookbook/_nouveau_info/ingredients HTTP/1.1 Accept: application/json Host: localhost:5984
Ответ:
HTTP/1.1 200 OK
Content-Type: application/json
{
"name": "_design/cookbook/ingredients",
"search_index": {
"num_docs": 1000,
"update_seq": 5000,
"disk_size": 1048576
}
}
Copyright © 2025 The Apache Software Foundation — Licensed under the Apache License 2.0
https://docs.couchdb.org/en/3.5.1/api/ddoc/nouveau.html