Перейти к основному содержимому

Полнотекстовый поиск в файловом сервисе

Файловый сервис поддерживает полнотекстовый поиск по файлам.

Для создания поисковых запросов используется синтаксис запросов Apache Lucene query syntax, подробнее см. https://lucene.apache.org/core/2_9_4/queryparsersyntax.html.

Атрибуты файлов, для которых реализован полнотекстовый поиск, приведены в таблице ниже.

АтрибутФорматОписание
fullputhtextПолный путь к файлу в файловой системе
filenametextИмя файла
DescriptiontextОписание файла, которое может быть добавлено пользователем
MetadatatextДополнительные метаданные, которые могут быть обновлены через метод в файловом сервисе
Creation DatedatetimeДата создания файла, одинаковая для всех версий
Modified DatedatetimeДата последней модификации файла, различная для каждой версии
Created BytextПользователь, который загрузил файл, хранится в формате guid;login
Modified BytextПользователь, который модифицировал файл, хранится в формате guid;login
SizeintРазмер файла в байтах
к сведению

При выполнении поиска файлов можно использовать скобки:

  • фигурные скобки {}: чтобы не включать одну или несколько границ в результат поиска;
  • квадратные скобки []: чтобы включать границы в интервал поиска.

Примеры поисковых запросов

Примеры запросов

Поиск по расположению файла

Пример поиска файла, расположенного по адресу /test14051/stat_1.docx .

{
"query": "fullPath:\"/test14051/stat_1.docx\""
}

Поиск по имени файла

Пример поиска файла, в названии которого содержатся символы test, например, test*.

{
"query": "filename: test*"
}

Поиск по описанию файла

Пример поиска файла, в атрибуте Description text которого содержится слово описание.

{
"query": "description: описание"
}

Поиск по метаданным файла

Пример поиска файла, в метаданных которого содержится словосочетание Текстовый файл.

{
"query": "metadata: \"Текстовый файл\""
}

Поиск по размеру файла

Пример поиска файла размер которого больше 50 и меньше или равен 60 байтам.

{    
"query": "size:(>50 AND <=60)"
}

Поиск по пользователю файла

Пример поиска файлов, измененных пользователем, GUID которого a1013ec9-df33-4e07-8c4b-0e6d4b64c8d7

{
"query": "modifiedBy: a1013ec9-df33-4e07-8c4b-0e6d4b64c8d7*"
}

Поиск по времени создания файла

Пример поиска файлов, загруженных в период с 2025-05-12T08:06:17.4393348Z включительно до 2025-05-13T07:46:01.2626156Z исключительно.

{    "query": "createdDate: [2025-05-12T08:06:17.4393348Z TO 2025-05-13T07:46:01.2626156Z}"  }