مشاركة عبر

ARRAY_CONTAINS (استعلام NoSQL)

  • مقالة

ينطبق على: NoSQL

إرجاع قيمة منطقية تشير إلى ما إذا كان الصفيف يحتوي على القيمة المحددة. يمكنك التحقق من وجود تطابق جزئي أو كامل لعنصر باستخدام تعبير منطقي داخل الدالة.

بناء الجملة

ARRAY_CONTAINS(<array_expr>, <expr> [, <bool_expr>])

الوسيطات

‏‏الوصف
arr_expr تعبير صفيف.
expr تعبير للبحث عن داخل الصفيف.
bool_expr تعبير منطقي يشير إلى ما إذا كان يجب أن يتحقق البحث من وجود تطابق جزئي (true) أو تطابق كامل (false). إذا لم يتم التحديد، فإن القيمة الافتراضية هي false.

أنواع الإعادة

إرجاع قيمة منطقية.

الأمثلة

يوضح المثال التالي كيفية التحقق من قيم أو كائنات معينة في صفيف باستخدام هذه الدالة.

SELECT VALUE {
    containsItem: ARRAY_CONTAINS(["coats", "jackets", "sweatshirts"], "coats"),
    missingItem: ARRAY_CONTAINS(["coats", "jackets", "sweatshirts"], "hoodies"),
    containsFullMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts", color: "blue" }),
    missingFullMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts" }),
    containsPartialMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts" }, true),
    missingPartialMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shorts", color: "blue" }, true)
}

[
  {
    "containsItem": true,
    "missingItem": false,
    "containsFullMatchObject": true,
    "missingFullMatchObject": false,
    "containsPartialMatchObject": true,
    "missingPartialMatchObject": false
  }
]

الملاحظات

  • تستفيد وظيفة النظام هذه من فهرس النطاق.

المحتوى ذو الصلة