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

설명

• 이 시스템 함수는 범위 인덱스의 이점을 활용합니다.

관련 콘텐츠

• 시스템 함수
• ARRAY_CONCAT