ARRAY_CONTAINS - Cosmos DB'de sorgu dili (Azure ve Doku'da)

işlevi, ARRAY_CONTAINS dizinin belirtilen değeri içerip içermediğini gösteren bir boole döndürür. İşlev içinde boole ifadesi kullanarak nesnenin kısmi veya tam eşleşmesini de kontrol edebilirsiniz.

Sözdizimi

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

Arguments

	Description
array_expr	Bir dizi ifadesi.
expr	Dizi içinde aranacak ifade.
bool_expr	Aramanın kısmi eşleşme () veya tam eşleşmefalse (true) olup olmadığını denetlemesi gerektiğini gösteren boole ifadesi. Belirtilmezse, varsayılan değer olur false.

Dönüş türleri

Boole değeri döndürür.

Örnekler

Bu bölüm, bu sorgu dili yapısının nasıl kullanılacağına örnekler içerir.

Dizi örnekler içeriyor

Bu örnekte işlev, ARRAY_CONTAINS dizilerdeki değerlerin ve nesnelerin varlığını denetlemek için kullanılır.

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

Açıklamalar

• Bu işlev, aralık dizini kullanımından yararlanır. Daha fazla bilgi için bkz. aralık dizinleri.