Share via

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
  }
]

الملاحظات

محتوى مرتبط