Azure AI Search의 OData 전체 텍스트 검색 함수 - search.ismatch 및 search.ismatchscoring

Azure AI Search는 및 함수를 통해 OData 필터 식의 컨텍스트에서 전체 텍스트 검색을 search.ismatchsearch.ismatchscoring 지원합니다. 이러한 함수를 사용하면 Search API의 최상위 search 매개 변수를 사용하는 것만으로는 불가능한 방식으로 전체 텍스트 검색을 엄격한 부울 필터링과 결합할 수 있습니다.

구문

다음 EBNF(Extended Backus-Naur Form)는 및 search.ismatch 함수의 문법을 search.ismatchscoring 정의합니다.

search_is_match_call ::=
    'search.ismatch'('scoring')?'(' search_is_match_parameters ')'

search_is_match_parameters ::=
    string_literal(',' string_literal(',' query_type ',' search_mode)?)?

query_type ::= "'full'" | "'simple'"

search_mode ::= "'any'" | "'all'"

다음과 같은 대화형 구문 다이어그램도 사용할 수 있습니다.

search.ismatch

함수는 search.ismatch 전체 텍스트 검색 쿼리를 필터 식의 일부로 평가합니다. 일치하는 문서가 결과 집합에 반환됩니다. 이 함수의 다음 오버로드를 사용할 수 있습니다.

• search.ismatch(search)
• search.ismatch(search, searchFields)
• search.ismatch(search, searchFields, queryType, searchMode)

매개 변수는 다음 표에 정의되어 있습니다.

위의 모든 매개 변수는 Search API의 해당 검색 요청 매개 변수와 동일합니다.

이 함수는 search.ismatch 부울 논리 연산자를 사용하여 다른 필터 하위 식으로 작성할 수 있는 형식 Edm.Boolean값을 반환합니다.

search.ismatchscoring

함수와 search.ismatchscoring 마찬가지로 함수는 search.ismatch 매개 변수로 전달된 전체 텍스트 검색 쿼리와 일치하는 문서를 반환 true 합니다. 두 문서 간의 차이점은 쿼리와 일치하는 search.ismatchscoring 문서의 관련성 점수가 전체 문서 점수에 영향을 주지만 search.ismatch문서 점수는 변경되지 않는다는 것입니다. 이 함수의 다음 오버로드는 다음과 같은 매개 변수와 동일한 매개 변수와 search.ismatch함께 사용할 수 있습니다.

• search.ismatchscoring(search)
• search.ismatchscoring(search, searchFields)
• search.ismatchscoring(search, searchFields, queryType, searchMode)

search.ismatch 및 search.ismatchscoring 함수를 동일한 필터 식에서 모두 사용할 수 있습니다.

예제

"워터프론트"라는 단어가 있는 문서를 찾습니다. 이 필터 쿼리는 를 사용한 search=waterfront과 동일합니다.

    search.ismatchscoring('waterfront')

다음은 Azure Portal의 검색 탐색기에서 실행할 수 있는 이 요청에 대한 전체 쿼리 구문입니다. 출력은 해안가, 물, 앞면의 일치 항목으로 구성됩니다.

{
  "search": "*",
  "select": "HotelId, HotelName, Description",
  "searchMode": "all",
  "queryType": "simple",
  "count": true,
  "filter": "search.ismatchscoring('waterfront')"
}

"pool"이라는 단어가 있고 등급이 4 이상인 문서 또는 "motel"이라는 단어가 3.2인 문서를 찾습니다. 이 요청은 함수 없이 search.ismatchscoring 는 표현할 수 없습니다.

    search.ismatchscoring('pool') and Rating ge 4 or search.ismatchscoring('motel') and Rating eq 3.2

다음은 검색 탐색기에 대한 이 요청에 대한 전체 쿼리 구문입니다. 출력은 등급이 4보다 큰 호텔 또는 등급이 3.2인 모텔의 일치 항목으로 구성됩니다.

{
  "search": "*",
  "select": "HotelId, HotelName, Description, Tags, Rating",
  "searchMode": "all",
  "queryType": "simple",
  "count": true,
  "filter": "search.ismatchscoring('pool') and Rating ge 4 or search.ismatchscoring('motel') and Rating eq 3.2"
}

"luxury"라는 단어가 없는 문서를 찾습니다.

    not search.ismatch('luxury')

다음은 이 요청에 대한 전체 쿼리 구문입니다. 출력은 럭셔리라는 용어에 대한 일치 항목으로 구성됩니다.

{
  "search": "*",
  "select": "HotelId, HotelName, Description, Tags, Rating",
  "searchMode": "all",
  "queryType": "simple",
  "count": true,
  "filter": "not search.ismatch('luxury')"
}

"ocean" 또는 등급이 3.2인 문서를 찾습니다. 쿼리는 search.ismatchscoring 필드 HotelName 및 Description에 대해서만 실행됩니다.

다음은 이 요청에 대한 전체 쿼리 구문입니다. 분리의 두 번째 절과 일치하는 문서도 반환됩니다(특히 같은 3.2호텔Rating). 해당 문서가 식의 점수가 매칭된 부분과 일치하지 않음을 분명히 하기 위해 점수가 0과 같은 상태로 반환됩니다.

{
  "search": "*",
  "select": "HotelId, HotelName, Description, Rating",
  "searchMode": "all",
  "queryType": "full",
  "count": true,
  "filter": "search.ismatchscoring('ocean', 'Description,HotelName') or Rating eq 3.2"
}

출력은 설명 또는 호텔 이름에 "ocean"을 언급하는 호텔 또는 평점이 3.2인 호텔 등 4개의 일치 항목으로 구성됩니다. 두 번째 절의 일치 항목에 대한 검색 점수는 0입니다.

{
  "@odata.count": 4,
  "value": [
    {
      "@search.score": 1.6076145,
      "HotelId": "18",
      "HotelName": "Ocean Water Resort & Spa",
      "Description": "New Luxury Hotel for the vacation of a lifetime. Bay views from every room, ___location near the pier, rooftop pool, waterfront dining & more.",
      "Rating": 4.2
    },
    {
      "@search.score": 1.0594962,
      "HotelId": "41",
      "HotelName": "Windy Ocean Motel",
      "Description": "Oceanfront hotel overlooking the beach features rooms with a private balcony and 2 indoor and outdoor pools. Inspired by the natural beauty of the island, each room includes an original painting of local scenes by the owner. Rooms include a mini fridge, Keurig coffee maker, and flatscreen TV. Various shops and art entertainment are on the boardwalk, just steps away.",
      "Rating": 3.5
    },
    {
      "@search.score": 0,
      "HotelId": "40",
      "HotelName": "Trails End Motel",
      "Description": "Only 8 miles from Downtown. On-site bar/restaurant, Free hot breakfast buffet, Free wireless internet, All non-smoking hotel. Only 15 miles from airport.",
      "Rating": 3.2
    },
    {
      "@search.score": 0,
      "HotelId": "26",
      "HotelName": "Planetary Plaza & Suites",
      "Description": "Extend Your Stay. Affordable home away from home, with amenities like free Wi-Fi, full kitchen, and convenient laundry service.",
      "Rating": 3.2
    }
  ]
}

"호텔"과 "공항"이라는 용어가 호텔 설명에서 서로 5단어 이내이고 적어도 일부 객실에서는 흡연이 허용되지 않는 문서를 찾아보세요.

    search.ismatch('"hotel airport"~5', 'Description', 'full', 'any') and Rooms/any(room: not room/SmokingAllowed)

전체 쿼리 구문은 다음과 같습니다. 검색 탐색기에서 실행하려면 백슬래시 문자로 내부 따옴표를 이스케이프합니다.

{
  "search": "*",
  "select": "HotelId, HotelName, Description, Tags, Rating",
  "searchMode": "all",
  "queryType": "simple",
  "count": true,
  "filter": "search.ismatch('\"hotel airport\"~5', 'Description', 'full', 'any') and Rooms/any(room: not room/SmokingAllowed)"
}

출력은 "hotel" 및 "airport"라는 용어가 5단어 이내인 단일 문서로 구성됩니다. 대부분의 호텔에서는 이 검색 결과에 포함된 객실을 포함하여 여러 객실에 흡연이 허용됩니다.

{
  "@odata.count": 1,
  "value": [
    {
      "@search.score": 1,
      "HotelId": "40",
      "HotelName": "Trails End Motel",
      "Description": "Only 8 miles from Downtown. On-site bar/restaurant, Free hot breakfast buffet, Free wireless internet, All non-smoking hotel. Only 15 miles from airport.",
      "Tags": [
        "bar",
        "free wifi",
        "restaurant"
      ],
      "Rating": 3.2
    }
  ]
}

설명 필드에서 문자 "lux"로 시작하는 단어가 있는 문서를 찾습니다. 이 쿼리는 접두사 검색search.ismatch.

    search.ismatch('lux*', 'Description')

전체 쿼리는 다음과 같습니다.

{
  "search": "*",
  "select": "HotelId, HotelName, Description, Tags, Rating",
  "searchMode": "all",
  "queryType": "simple",
  "count": true,
  "filter": "search.ismatch('lux*', 'Description')"
}

출력은 다음과 같은 일치 항목으로 구성됩니다.

{
  "@odata.count": 4,
  "value": [
    {
      "@search.score": 1,
      "HotelId": "18",
      "HotelName": "Ocean Water Resort & Spa",
      "Description": "New Luxury Hotel for the vacation of a lifetime. Bay views from every room, ___location near the pier, rooftop pool, waterfront dining & more.",
      "Tags": [
        "view",
        "pool",
        "restaurant"
      ],
      "Rating": 4.2
    },
    {
      "@search.score": 1,
      "HotelId": "13",
      "HotelName": "Luxury Lion Resort",
      "Description": "Unmatched Luxury. Visit our downtown hotel to indulge in luxury accommodations. Moments from the stadium and transportation hubs, we feature the best in convenience and comfort.",
      "Tags": [
        "bar",
        "concierge",
        "restaurant"
      ],
      "Rating": 4.1
    },
    {
      "@search.score": 1,
      "HotelId": "16",
      "HotelName": "Double Sanctuary Resort",
      "Description": "5 star Luxury Hotel - Biggest Rooms in the city. #1 Hotel in the area listed by Traveler magazine. Free WiFi, Flexible check in/out, Fitness Center & espresso in room.",
      "Tags": [
        "view",
        "pool",
        "restaurant",
        "bar",
        "continental breakfast"
      ],
      "Rating": 4.2
    },
    {
      "@search.score": 1,
      "HotelId": "14",
      "HotelName": "Twin Vortex Hotel",
      "Description": "New experience in the making. Be the first to experience the luxury of the Twin Vortex. Reserve one of our newly-renovated guest rooms today.",
      "Tags": [
        "bar",
        "restaurant",
        "concierge"
      ],
      "Rating": 4.4
    }
  ]
}

다음 단계

• Azure AI 검색의 필터
• Azure AI 검색의 OData 식 언어 개요
• Azure AI 검색의 OData 식 구문 참조
• 문서 검색(Azure AI 검색 REST API)