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 |