Tworzenie schematu schematu optymalnej interpretacji zapytań

Funkcja interpretacji zapytań w Cloud Search automatycznie interpretuje operatory i filtry w zapytaniu użytkownika, a następnie przekształca je w ustrukturyzowane zapytanie oparte na operatorach. Interpretacja zapytań korzysta z operatorów zdefiniowanych w schemacie oraz ze zindeksowanych dokumentów, aby ustalić znaczenie zapytania użytkownika. Ta funkcja umożliwia użytkownikom wyszukiwanie przy użyciu minimalnej liczby słów kluczowych, a jednak z dokładnymi wynikami.

Rzeczywiste wyniki wyświetlane użytkownikowi zależą od poziomu ufności interpretacji zapytania. Pewność zależy od kilku czynników, w tym od tego, gdzie w zaindeksowanych dokumentach występują ciągi znaków zapytań. Ciąg taki jak nazwisko aktora „Tomek Hanks” występujący konsekwentnie w polu schematu o nazwie actors daje wyższy poziom pewności. Ten sam ciąg znaków („Tom Hanks”) występujący w akapicie, a nie w polu schema, może spowodować spadek ufności. W przypadku wysokiego poziomu pewności wyświetlane są tylko wyniki interpretacji zapytania. W przypadku słabszego poziomu pewności wyniki z interpretacji zapytania zostają wymieszane z wynikami wyszukiwania normalnych słów kluczowych.

Uwaga: zanim przeczytasz ten dokument, zapoznaj się z artykułem Tworzenie schematu i rejestrowanie go, w którym znajdziesz podstawowe informacje o strukturze schematu. Aby poprawić pozycjonowanie i przypominanie, przeczytaj też artykuł Poprawianie jakości wyszukiwania.

Interpretacja przykładowego zapytania

Załóżmy, że masz źródło danych, np. bazę danych, które zawiera informacje o filmach. Ilustracja 1 przedstawia przykładowe zapytanie i wynikową interpretację.

Rysunek 1. Interpretacja zapytania

W przypadku tego przykładowego zapytania interpretacja zapytania:

• Analizuje schemat i określa, że obiekty najwyższego poziomu w źródle danych są sklasyfikowane jako objecttype:movies. Interpretacja zapytań wie, że „filmy” w zapytaniu są typem obiektu.

• Skanuje dokumenty w źródle danych w połączeniu ze schematem, aby określić, gdzie występuje ciąg „działanie”. Jeśli ciąg znaków występuje głównie w konkretnym polu źródła danych „gatunek”, interpretacja zapytania będzie mieć pewność, że „action” jest wartością właściwości „genre” zdefiniowanej w schemacie. Jeśli ciąg występuje głównie w kontekście akapitów treści, poziom ufności interpretacji zapytania maleje.

Interpretacja zapytania:

  actor:“tom hanks” genre:action objecttype:movies

Interpretacja zapytań jest automatycznie włączana dla wszystkich klientów Cloud Search bez konieczności wykonywania dodatkowych czynności. Aby jednak zapewnić optymalną interpretację zapytań, ułóż schemat zgodnie z instrukcjami podanymi w tym dokumencie.

Uporządkuj schemat, aby ułatwić interpretację zapytań

Schemat powinien być sformatowany tak, aby można było korzystać z interpretacji zapytań.

Uwaga: po zindeksowaniu schematu i odpowiednich dokumentów interpretacja zapytań trwa co najmniej 48 godzin.

Włącz interpretację wyświetlanej nazwy

Interpretacja zapytań w Cloud Search wykorzystuje elementy objectDefinitions i propertyDefinitions w schemacie, aby interpretować zapytania użytkownika i dostosowywać wyniki. Aby jak najlepiej wykorzystać te elementy schematu, utwórz intuicyjne wyświetlane nazwy używające znaków displayLabel jako nazw właściwości, objectDisplayLabel jako nazw obiektów i operatorName jako operatorów.

Poniższy schemat przedstawia intuicyjne nazwy wyświetlane obiektu filmu:

{
  "objectDefinitions": [
    {
      "name": "movie",
        "options": {
          "displayOptions": {
          "objectDisplayLabel": "Films"
        }
        ...
      },
      "propertyDefinitions": [
        {
          "name": "genre",
          "isReturnable": true,
          "isRepeatable": true,
          "isFacetable": true,
          "textPropertyOptions": {
          "retrievalImportance": { "importance": "HIGHEST" },
          "operatorOptions": {
            "operatorName": "genre"
          }
        },
        "displayOptions": {
          "displayLabel": "Category"
        }
      },
      ...
      ]
    }
  ]
}

W poprzednim przykładzie:

• Definicja obiektu filmu ma element „Film” objectDisplayLabel.

  Uwaga: w odróżnieniu od schematu filmu w artykule Tworzenie i rejestrowanie schematu w poprzednim przykładzie wartości objectDisplayLabel i name obiektu są różne. Inna wartość w tych polach jest dopuszczalna.

• Definicja własności gatunku zawiera „gatunek” operatorName i „kategorię” displayLabel.

Te wyświetlane nazwy umożliwiają Cloud Search interpretację zapytań w ten sposób:

• „filmy akcji”, „gatunkowe filmy akcji” lub „gatunek filmowy akcja” są interpretowane jako genre:action object:movies.
• „filmy z gatunku akcji lub thriller” jest interpretowane jako objecttype:movies genre:(action OR thriller).
• „film akcji” lub „filmy akcji” jest interpretowany jako genre:action objecttype:movies.
• „filmy z kategorii komedii” są interpretowane jako genre:comedy objecttype:movies.

Uwaga: aby ułatwić funkcji interpretacji zapytań w Cloud Search, używaj wielkich liter w nazwach usług.

Włącz interpretację dat, liczb i sortowania.

Właściwości lessThanOperatorName i greaterThanOperatorName, określone w IntegerOperatorOptions, należy zdefiniować we wszystkich właściwościach daty i liczb. Te ustawienia umożliwiają automatyczną interpretację dat i wartości liczbowych. Dodatkowo, aby włączyć interpretacje sortowania, ustaw opcję isSortable dla właściwości daty i wartości liczbowych. Poniższy schemat pokazuje, jak włączyć te opcje.

{
  "objectDefinitions": [
    {
      "options": {
        "displayOptions": {
          "objectDisplayLabel": "Films"
        }
      },
      "propertyDefinitions": [
        {
          "name": "runtime",
          "isReturnable": true,
          "isSortable": true,
          "integerPropertyOptions": {
            "orderedRanking": "DESCENDING",
            "minimumValue": {
              "value": 10
            },
            "maximumValue": {
              "value": 500
            },
            "operatorOptions": {
              "operatorName": "runtime",
              "lessThanOperatorName": "runtimelessthan",
              "greaterThanOperatorName": "runtimegreaterthan"
            }
          },
          "displayOptions": {
            "displayLabel": "Length"
          }
        },
        {
          "name": "releasedate",
          "isReturnable": true,
          "isSortable": true,
          "datePropertyOptions": {
            "operatorOptions": {
              "operatorName": "releasedate",
              "lessThanOperatorName": "releasedbefore",
              "greaterThanOperatorName": "releasedafter"
            }
          }
        }
      ]
    }
  ]
}

W poprzednim przykładzie:

• Właściwość liczbowa runtime odnosi się do długości filmu. Właściwość runtimelessthan i runtimegreaterthan jest ustawiona dla tej usługi.
• Właściwość data releaseDate odnosi się do daty premiery filmu w kinach. Właściwości releasedbefore i releasedafter są ustawione dla tej usługi.

Te ustawienia umożliwiają Cloud Search wykonywanie tych interpretacji zapytań:

• Przy założeniu, że rok to 2019, „filmy opublikowane w tym roku” będą interpretowane jako objecttype: movies releasedafter:2019-1-1 releasedbefore:2019-12-31.
• Zakładając, że jest to trzeci tydzień marca, „filmy wydane w zeszłym tygodniu” należy interpretować jako objecttype: movies releasedafter:2019-3-10 releasedbefore:2019-3-16
• „Filmy o czasie trwania krótszym niż 90” są interpretowane jako objjecttype: movies runtimelessthan:90.
• Zakładając, że mamy rok 2019, „filmy wydane w tym roku o długości ponad 120” są interpretowane jako releasedafter:2019-1-1 releasedbefore:2019-12-31 objecttype:movies runtimegreaterthan:120.
• „sortuj filmy według daty premiery” spowoduje zastosowanie filtra „objecttype: movies”, a wyniki zostaną posortowane według daty premiery w kolejności rosnącej.

Uwaga: Cloud Search nie ma dedykowanego operatora sortowania.

Uwaga: jeśli schemat zawiera operatory z tymi samymi wartościami operatora, interpretacja tej wartości do intencji operatora w zapytaniu zależy od ogólnego współczynnika ufności zwróconego przez system interpretacji zapytań. Załóżmy na przykład, że masz właściwości schematu Priorytet i Waga z operatorami priority i severity. Załóżmy, że oba operatory mogą mieć wartości v0, v1, v2 lub v3. W tym przykładzie „v0” w zapytaniu może odnosić się do wartości operatora priority lub severity. W związku z tym „v0” jest niejednoznaczne, a więc poziom ufności jest niższy.

Włącz interpretację rezerwacji operatora

Aby poprawić interpretację zapytań, możesz też używać zarezerwowanych wbudowanych operatorów type, before, after i objecttype. Podczas indeksowania dokumentu wykonaj te czynności:

1. Wypełnij pole updateTime w ItemMetadata, aby używać operatorów before i after. Te ustawienia umożliwiają Cloud Search wykonywanie tych interpretacji zapytań:

   • „filmy z ostatniego tygodnia” zawierałyby wszystkie filmy, które zostały zaktualizowane w indeksie w poprzednim tygodniu.
   • „movies before jan 2019” (filmy przed styczeń 2019 r.) wyświetli wszystkie filmy, które zostały zindeksowane przed styczniem 2019 r.

2. Aby korzystać z automatycznego wykrywania typu, wypełnij pole mimeType w ItemMetadata. Zapytanie „filmy akcji” wyświetli wszystkie dokumenty filmów akcji o typie mime application/mp4, application/mpeg4, application/x-shockwave-flash, video/ i application/vnd.google-apps.video.

Ograniczenia interpretacji zapytań

Funkcja interpretacji zapytań ma następujące ograniczenia.

• Interpretacja zapytań działa tylko w przypadku tych list kontroli dostępu źródeł danych:
  • Wszystkie dokumenty są publiczne w domenie (każdy w domenie ma do nich dostęp).
  • Wszystkie dokumenty są publiczne (mogą je zobaczyć wszyscy, którzy mają dostęp do źródła danych).
  • Większość dokumentów w źródle danych ma tę samą listę kontroli dostępu (wszystkie dokumenty dziedziczą listę kontroli dostępu z tego samego elementu kontenera) bez zdefiniowanych dodatkowych czytników.
• Jeśli kilka operatorów schematu ma tę samą wartość, interpretacja tej wartości w odniesieniu do intencji operatora w danym zapytaniu zależy od ogólnego współczynnika ufności zwróconego przez system interpretacji zapytań. Załóżmy na przykład, że masz właściwości priority i severity z tymi samymi nazwami operatorów zdefiniowane w schemacie. Załóżmy, że oba operatory mogą mieć wartości 0, 1, 2 lub 3. W tym przykładzie wartość „0” w zapytaniu może odnosić się do wartości operatora priority lub severity. Te wartości są niejednoznaczne, a poziom ufności jest niższy.
• Domyślnie podczas interpretacji zapytania Cloud Search ignoruje wielkość liter w wartościach pól, z wyjątkiem operatorów tekstowych zdefiniowanych za pomocą opcji exactMatchWithOperator.
• Operator source nie jest obsługiwany w zapytaniach.
• Zapytania, które łączą terminy z operatorem i tekstem wolnym, nie są interpretowane. Na przykład zapytanie „p0 priorytetowe przypadki:poważny:s0” nie będzie obsługiwane, ponieważ „p0 priorytetowe przypadki” to termin z tekstem dowolnym, a „poważny:s0” to termin z operatorem.
• Strategia interpretacji zapytań zawsze łączy interpretowane wyniki z zwykłymi (nieinterpretowanymi, uporządkowanymi według trafności) wynikami. Nie powoduje pełnego zastąpienia wyników.