다음을 통해 공유

ARRAY_CONTAINS - Cosmos DB의 쿼리 언어(Azure 및 패브릭)

  • 적용 대상: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

이 함수는 ARRAY_CONTAINS 배열에 지정된 값이 포함되어 있는지 여부를 나타내는 부울을 반환합니다. 함수 내에서 부울 식을 사용하여 개체의 부분 또는 전체 일치를 확인할 수 있습니다.

구문

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

Arguments

Description
array_expr 배열 식입니다.
expr 배열 내에서 검색할 식입니다.
bool_expr 검색에서 부분 일치() 또는 전체false 일치(true)를 확인해야 하는지 여부를 나타내는 부울 식입니다. 지정하지 않으면 기본값 false입니다.

반환 형식

부울 값을 반환합니다.

예시

이 섹션에는 이 쿼리 언어 구문을 사용하는 방법에 대한 예제가 포함되어 있습니다.

배열에 예제가 포함되어 있습니다.

이 예제에서는 함수를 ARRAY_CONTAINS 사용하여 배열에 값과 개체가 있는지 확인합니다.

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

비고

  • Last updated on