filter у пошук або видалення, щоб відібрати документи за їхніми метаданими.
{ "team": "support", "year": { "$gte": 2024 } }
Оператори
| Оператор | Збігається з |
|---|---|
{ "key": value }, $eq | Дорівнює значенню; для масиву — містить значення |
$in | Дорівнює будь-якому значенню зі списку |
$ne, $nin | Не дорівнює значенню або жодному зі списку (лише для пошуку) |
$gt, $gte, $lt, $lte | Більше, не менше, менше, не більше |
$and, $or | Усі або будь-який зі списку фільтрів |
Приклади
| Фільтр | Збігається з |
|---|---|
{ "tags": "billing" } | Документами, чий масив tags містить billing |
{ "lang": { "$in": ["en", "de"] } } | Англомовними або німецькомовними документами |
{ "$or": [{ "team": "support" }, { "year": { "$in": [2024, 2025] } }] } | Документами команди підтримки або будь-якими за 2024 чи 2025 рік |
{ "published_at": { "$gte": "2025-06-01" } } | Документами, опублікованими 1 червня 2025 року або пізніше |
{ "file_id": "report.pdf" } | Одним завантаженим файлом |
{ "file_id": "report.pdf", "page": 3 } | Сторінкою 3 цього файлу |
Правила
| Правило | |
|---|---|
| Рівність | Порівнюється як текст: 3, 3.0 і "3" збігаються між собою |
| Діапазони | Числа з числами, рядки з рядками, побайтово; записуйте дати в ISO 8601 в одному форматі (2025-06-01 або 2025-06-01T10:00:00Z) |
| Ніколи в діапазоні | Булеві значення, елементи масивів і рядки довші за 222 байти |
| Відсутні ключі | Документ без ключа збігається з $ne і $nin |
| Заперечення | Заперечення, що відсіює більшість документів, може повернути менше результатів, ніж top_k |
| Розмір | До 256 умов, вкладеність до 8 рівнів; кожен $and, $or і багатозначний $in рахується як одна |
| Списки | $in і $nin приймають до 255 значень |
| Невідомі ключі | Не перевіряються: ключ із помилкою не збігається ні з чим |
| Помилки | Недійсний фільтр повертає 400 invalid_filter |