Şema oluşturma ve kaydetme

Google Cloud Search şeması, verilerinizi dizine ekleme ve sorgulama işlemlerinde kullanılacak nesneleri, özellikleri ve seçenekleri tanımlayan bir JSON yapısıdır. İçerik bağlayıcınız, deponuzdaki verileri okur ve kayıtlı şemanıza göre verileri yapılandırıp dizine ekler.

API'ye bir JSON şema nesnesi sağlayıp bunu kaydederek şema oluşturabilirsiniz. Verilerinizi dizine eklemeden önce depolarınızın her biri için bir şema nesnesi kaydetmeniz gerekir.

Bu dokümanda, şema oluşturmayla ilgili temel bilgiler verilmektedir. Arama deneyimini iyileştirmek için şemanızı nasıl ayarlayacağınız hakkında bilgi edinmek için Arama kalitesini iyileştirme başlıklı makaleyi inceleyin.

Şema oluşturun

Cloud Search şemanızı oluşturmak için kullanılan adımların listesi aşağıda verilmiştir:

  1. Beklenen kullanıcı davranışını belirleme
  2. Veri kaynağını başlatma
  3. Şema oluşturma
  4. Tam örnek şema
  5. Şemanızı kaydetme
  6. Verilerinizi dizine ekleme
  7. Şemanızı test etme
  8. Şemanızı ayarlama
bölümüne bakın.

Beklenen kullanıcı davranışını belirleme

Kullanıcılarınızın yapacağı sorgu türlerini tahmin etmek, stratejinizi şemanızı oluşturmaya yönlendirmenize yardımcı olur.

Örneğin, bir film veritabanına sorgu gönderirken kullanıcının "Robert Redford'un oynadığı tüm filmleri göster" gibi bir sorgu göndermesini bekleyebilirsiniz. Bu nedenle şemanız, "belirli bir aktöre sahip tüm filmler"e dayalı sorgu sonuçlarını desteklemelidir.

Şemanızı kullanıcınızın davranış kalıplarını yansıtacak şekilde tanımlamak için şu görevleri gerçekleştirmeyi düşünebilirsiniz:

  1. Farklı kullanıcılardan gelen çeşitli istenen sorguları değerlendirin.
  2. Sorgularda kullanılabilecek nesneleri tanımlayın. Nesneler, film veritabanındaki bir film gibi ilgili verilerin mantıksal kümeleridir.
  3. Nesneyi oluşturan ve sorgularda kullanılabilecek özellik ve değerleri tanımlayın. Özellikler, nesnenin dizine eklenebilir özellikleridir. Basit değerler veya başka nesneler içerebilirler. Örneğin, bir film nesnesi, ilkel değerler olarak filmin başlığı ve yayın tarihi gibi özelliklere sahip olabilir. Film nesnesi, adları veya rolleri gibi kendi özellikleri olan oyuncu gibi başka nesneleri de içerebilir.
  4. Tesisler için geçerli örnek değerleri tanımlayın. Değerler, bir mülk için dizine eklenen gerçek verilerdir. Örneğin, veritabanınızdaki bir filmin adı "Kayıp Arkayı Çalanlar" olabilir.
  5. Kullanıcılarınızın istediği sıralama ve derecelendirme seçeneklerini belirleyin. Örneğin, kullanıcılar filmleri sorgularken kronolojik olarak sıralamak ve kitle puanına göre sıralamak isteyebilir. Bu durumda, başlığa göre alfabetik olarak sıralama yapmaları gerekmez.
  6. (isteğe bağlı) Mülklerinizden birinin, aramaların gerçekleştirilebileceği daha spesifik bir bağlamı (ör. kullanıcıların iş rolü veya departmanı) temsil edip etmediğini düşünün. Böylece, otomatik tamamlama önerileri bağlama göre sağlanabilir. Örneğin, film veritabanı arayan kullanıcılar yalnızca belirli bir film türüyle ilgileniyor olabilir. Kullanıcılar, aramalarının hangi türü döndürmesini istediklerini tanımlar (muhtemelen kullanıcı profillerinin bir parçası olarak). Ardından, kullanıcı film sorgusu yazmaya başladığında, otomatik tamamlama önerilerinin bir parçası olarak yalnızca tercih ettiği türdeki "aksiyon filmleri" gibi filmler önerilir.
  7. Aramalarda kullanılabilecek bu nesnelerin, özelliklerin ve örnek değerlerin listesini oluşturun. (Bu listenin nasıl kullanıldığıyla ilgili ayrıntılar için Operatör seçeneklerini tanımlama bölümüne bakın.)

Veri kaynağınızı başlatma

Veri kaynağı, dizine eklenen ve Google Cloud'da depolanan bir veri havuzundaki verileri temsil eder. Bir veri kaynağını başlatma talimatları için Üçüncü taraf veri kaynaklarını yönetme bölümüne bakın.

Kullanıcının arama sonuçları veri kaynağından döndürülür. Bir kullanıcı bir arama sonucunu tıkladığında Cloud Search, dizine ekleme isteğinde sağlanan URL'yi kullanarak kullanıcıyı gerçek öğeye yönlendirir.

Nesnelerinizi tanımlama

Şemadaki temel veri birimi, verilerin mantıksal yapısı olan "şema nesnesi" olarak da adlandırılan nesnedir. Film veritabanında, verilerin mantıksal yapılarından biri "film"dir. Bir diğer nesne de filmde yer alan oyuncu ve ekibi temsil edecek "kişi" olabilir.

Şemadaki her nesnenin, nesneyi tanımlayan bir dizi özellikleri veya özelliği vardır. Örneğin, bir filmin başlığı ve süresi ya da kişinin adı ve doğum tarihi belirtilmektedir. Bir nesnenin özellikleri, temel değerleri veya diğer nesneleri içerebilir.

Şekil 1'de film ve kişi nesneleri ile ilişkili mülkler gösterilmektedir.

Varlıklar arasındaki şema bağlantılarının çizilmesi
Şekil 1. İki nesne ve bir alt nesne gösteren örnek şema.

Cloud Search şeması, temel olarak objectDefinitions etiketinde tanımlanan nesne tanımı beyanlarının bir listesidir. Aşağıdaki şema snippet'i, film ve kişi şeması nesneleri için objectDefinitions ifadelerini göstermektedir.

{
  "objectDefinitions": [
    {
      "name": "movie",
      ...
    },
    {
      "name": "person",
      ...
    }
  ]
}

Bir şema nesnesini tanımlarken, nesne için şemada diğer tüm nesneler arasında benzersiz olması gereken bir name sağlarsınız. Genellikle nesneyi tanımlayan bir name değeri (ör. bir film nesnesi için movie) kullanırsınız. Şema hizmeti, dizine eklenebilir nesneler için name alanını anahtar tanımlayıcı olarak kullanır. name alanı hakkında daha fazla bilgi için Nesne Tanımı'na bakın.

Nesne özelliklerini tanımlama

ObjectDefinition referansında belirtildiği gibi, nesne adının ardından bir options grubu ve propertyDefinitions listesi gelir. options, freshnessOptions ve displayOptions'ten de oluşabilir. freshnessOptions, arama sıralamasını bir öğenin güncelliğine göre ayarlamak için kullanılır. displayOptions, belirli etiket ve özelliklerin bir nesnenin arama sonuçlarında gösterilip gösterilmeyeceğini tanımlamak için kullanılır.

propertyDefinitions bölümünde, bir nesnenin özelliklerini (ör. film başlığı ve yayın tarihi) tanımlarsınız.

Aşağıdaki snippet'te, movieTitle ve releaseDate olmak üzere iki özelliği olan movie nesnesi gösterilmektedir.

{
  "objectDefinitions": [
    {
      "name": "movie",
      "propertyDefinitions": [
        {
          "name": "movieTitle",
          "isReturnable": true,
          "isWildcardSearchable": true,
          "textPropertyOptions": {
            "retrievalImportance": { "importance": "HIGHEST" },
            "operatorOptions": {
              "operatorName": "title"
            }
          },
          "displayOptions": {
            "displayLabel": "Title"
          }
        },
        {
          "name": "releaseDate",
          "isReturnable": true,
          "isSortable": true,
          "datePropertyOptions": {
            "operatorOptions": {
              "operatorName": "released",
              "lessThanOperatorName": "releasedbefore",
              "greaterThanOperatorName": "releasedafter"
            }
          },
          "displayOptions": {
            "displayLabel": "Release date"
          }
      ...
      ]
    }
  ]
}

PropertyDefinition aşağıdaki öğelerden oluşur:

  • bir name dizesi.
  • Önceki snippet'teki isReturnable gibi, türden bağımsız seçeneklerin listesi.
  • Bir tür ve türle ilişkili türe özgü seçenekler (Önceki snippet'teki textPropertyOptions ve retrievalImportance gibi).
  • Tesisin arama operatörü olarak nasıl kullanıldığını açıklayan bir operatorOptions.
  • Bir veya daha fazla displayOptions (Önceki snippet'teki displayLabel gibi).

Bir mülkün name, kapsayıcı nesne içinde benzersiz olmalıdır ancak aynı ad diğer nesnelerde ve alt nesnelerde kullanılabilir. Şekil 1'de filmin başlığı ve yayın tarihi bir kez movie nesnesinde ve tekrar person nesnesinin filmography alt nesnesinde olmak üzere iki kez tanımlanmıştır. Bu şema, movieTitle alanını yeniden kullanarak iki tür arama davranışını destekleyebilir:

  • Kullanıcılar bir filmin adını aradığında film sonuçlarını gösterin.
  • Kullanıcılar bir oyuncunun oynadığı filmin başlığını aradığında kişi sonuçlarını gösterin.

Benzer şekilde şema, iki movieTitle alanı için aynı anlama sahip olduğu için releaseDate alanını yeniden kullanır.

Kendi şemanızı geliştirirken, veri havuzunuzda şemanızda birden fazla kez tanımlamak istediğiniz verileri içeren ilgili alanlar olabileceğini göz önünde bulundurun.

Türden bağımsız seçenekler ekleme

PropertyDefinition'nda, veri türüne bakılmaksızın tüm mülklerde yaygın olarak kullanılan genel arama işlevi seçenekleri listelenmektedir.

  • isReturnable - Mülkün, Query API aracılığıyla arama sonuçlarında döndürülmesi gereken verileri tanımlayıp tanımlamadığını belirtir. Örnek film mülklerinin tümü iade edilebilir. İade edilemeyen mülkler, kullanıcıya iade edilmeden arama veya sıralama sonuçları için kullanılabilir.
  • isRepeatable: Mülk için birden çok değere izin verilip verilmediğini gösterir. Örneğin, bir filmin yalnızca bir yayın tarihi vardır ancak birden fazla oyuncusu olabilir.
  • isSortable - Özelliğin sıralama için kullanılabileceğini belirtir. Bu, tekrarlanabilir mülkler için geçerli olamaz. Örneğin, film sonuçları yayın tarihine veya kitle puanına göre sıralanabilir.
  • isFacetable - Mülkün, özellikler oluşturmak için kullanılabileceğini belirtir. Özellik, arama sonuçlarını hassaslaştırmak için kullanılır. Kullanıcı ilk sonuçları görür ve ardından bu sonuçları daha da hassaslaştırmak için ölçütler veya özellikler ekler. Bu seçenek, türü nesne olan mülkler için doğru olamaz ve bu seçeneğin ayarlanması için isReturnable doğru olmalıdır. Son olarak, bu seçenek yalnızca enum, boole ve metin mülkleri için desteklenir. Örneğin, örnek şemamızda genre, actorName, userRating ve mpaaRating özelliklerini, arama sonuçlarının etkileşimli olarak hassaslaştırılması için kullanılabilecek şekilde filtrelenebilir hale getirebiliriz.
  • isWildcardSearchable, kullanıcıların bu mülk için joker karakter araması yapabileceğini gösterir. Bu seçenek yalnızca metin mülklerinde kullanılabilir. Metin alanındaki joker karakter aramasının işleyiş şekli, exactMatchWithOperator alanında ayarlanan değere bağlıdır. exactMatchWithOperator, true olarak ayarlanırsa metin değeri bir atomik değer olarak jetona dönüştürülür ve buna karşılık joker karakter araması gerçekleştirilir. Örneğin, metin değeri science-fiction ise science-* joker karakter sorgusu ile eşleşir. exactMatchWithOperator, false olarak ayarlanırsa metin değeri tokenlere ayrılır ve her jeton için joker karakter araması gerçekleştirilir. Örneğin, metin değeri "bilim kurgu" ise sci* veya fi* joker karakter sorguları öğeyle eşleşir, ancak science-* eşleşmez.

Bu genel arama işlevi parametrelerinin tümü Boole değeridir. Tümünün varsayılan değeri false'tür ve kullanılabilmesi için true olarak ayarlanmalıdır.

Aşağıdaki tabloda, movie nesnesinin tüm özellikleri için true olarak ayarlanan boole parametreleri gösterilmektedir:

Mülk isReturnable isRepeatable isSortable isFacetable isWildcardSearchable
movieTitle true true
releaseDate true true
genre true true true
duration true
actorName true true true true
userRating true true
mpaaRating true true

Bir film birden fazla türe ait olabileceği ve genellikle birden fazla aktörü olabileceği için hem genre hem de actorName için isRepeatable, true olarak ayarlanmıştır. Tekrarlanabilir veya tekrarlanabilir bir alt nesnede yer alan mülkler sıralanabilir değildir.

Türü tanımlama

PropertyDefinition referans bölümünde, xx'ın boolean gibi belirli bir tür olduğu birkaç xxPropertyOptions listelenir. Mülkün veri türünü ayarlamak için uygun veri türü nesnesini tanımlamanız gerekir. Bir mülk için veri türü nesnesi tanımlamak, söz konusu mülkün veri türünü belirler. Örneğin, movieTitle mülkü için textPropertyOptions değerini tanımlamak, film başlığının metin türüne sahip olduğunu gösterir. Aşağıdaki snippet, textPropertyOptions tarafından veri türünün ayarlandığı movieTitle özelliğini göstermektedir.

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    ...
  },
  ...
},

Bir mülkün yalnızca bir ilişkili veri türü olabilir. Örneğin, film şemamızda releaseDate yalnızca bir tarih (ör. 2016-01-13) veya bir dize (ör. January 13, 2016) ancak her ikisi birden yapılamaz.

Örnek film şemasında mülklerin veri türlerini belirtmek için kullanılan veri türü nesneleri şunlardır:

Mülk Veri türü nesnesi
movieTitle textPropertyOptions
releaseDate datePropertyOptions
genre enumPropertyOptions
duration textPropertyOptions
actorName textPropertyOptions
userRating integerPropertyOptions
mpaaRating textPropertyOptions

Mülk için seçtiğiniz veri türü, beklenen kullanım alanlarınıza bağlıdır. Bu film şemasının hayali senaryosunda, kullanıcıların sonuçları kronolojik olarak sıralamak istemesi beklenir. Bu nedenle releaseDate, bir tarih nesnesidir. Örneğin, yıllara göre Aralık ayındaki sürümleri Ocak ayındaki sürümlerle karşılaştırma gibi bir kullanım alanı varsa dize biçimi yararlı olabilir.

Türe özel seçenekleri yapılandırma

PropertyDefinition referans bölümünde her türün seçeneklerine bağlantılar verilmiştir. enumPropertyOptions içindeki possibleValues listesi hariç, türe özgü seçeneklerin çoğu isteğe bağlıdır. Ayrıca orderedRanking seçeneği, değerleri birbirine göre sıralamanıza olanak tanır. Aşağıdaki snippet'te, veri türünü ayarlayan textPropertyOptions ve türe özgü retrievalImportance seçeneğiyle movieTitle mülkü gösterilmektedir.

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    "retrievalImportance": { "importance": "HIGHEST" },
    ...
  },
  ...
}

Örnek şemada kullanılan türe özel ek seçenekler aşağıda verilmiştir:

Mülk Tür Türe özel seçenekler
movieTitle textPropertyOptions retrievalImportance
releaseDate datePropertyOptions
genre enumPropertyOptions
duration textPropertyOptions
actorName textPropertyOptions
userRating integerPropertyOptions orderedRanking, maximumValue
mpaaRating textPropertyOptions

Operatör seçeneklerini tanımlama

Türe özgü seçeneklere ek olarak her türün bir dizi isteğe bağlı seçeneği vardır.operatorOptions Bu seçenekler, mülkün arama operatörü olarak nasıl kullanıldığını açıklar. Aşağıdaki snippet'te, veri türünü ayarlayan textPropertyOptions ve retrievalImportance ile operatorOptions türüne özgü seçenekler içeren movieTitle mülkü gösterilmektedir.

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    "retrievalImportance": { "importance": "HIGHEST" },
    "operatorOptions": {
      "operatorName": "title"
    }
  },
  ...
}

Her operatorOptions öğesinin bir operatorName öğesi vardır (ör. movieTitle için title). Operatör adı, tesisin arama operatörüdür. Arama operatörü, kullanıcıların aramayı daraltırken kullanmasını beklediğiniz gerçek parametredir. Örneğin, kullanıcı başlıklarına göre filmleri aramak için title:movieName yazar. Burada movieName, filmin adıdır.

Operatör adlarının, tesis adıyla aynı olması gerekmez. Bunun yerine, kuruluşunuzdaki kullanıcıların en sık kullandığı kelimeleri yansıtan operatör adları kullanmalısınız. Örneğin, kullanıcılarınız bir film başlığı için "başlık" yerine "ad" terimini tercih ediyorsa operatör adı "ad" olarak ayarlanmalıdır.

Tüm mülkler aynı türde çözüldüğü sürece birden fazla mülk için aynı operatör adını kullanabilirsiniz. Bir sorgu sırasında paylaşılan bir operatör adı kullanıldığında, söz konusu operatör adını kullanan tüm mülkler alınır. Örneğin, film nesnesinin plotSummary ve plotSynopsis özelliklerinin olduğunu ve bu özelliklerin her birinin plot değerine sahip bir operatorName değerinin olduğunu varsayalım. Bu özelliklerin ikisi de metin (textPropertyOptions) olduğu sürece, plot arama operatörünün kullanıldığı tek bir sorgu bunların ikisini de alır.

Sırlanabilir mülkler, operatorName'e ek olarak operatorOptions'da lessThanOperatorName ve greaterThanOperatorName alanlarına sahip olabilir. Kullanıcılar, gönderilen bir değerle karşılaştırmalara dayalı sorgular oluşturmak için bu seçenekleri kullanabilir.

Son olarak, textOperatorOptions öğesinin operatorOptions içinde bir exactMatchWithOperator alanı vardır. exactMatchWithOperator değerini true olarak ayarlarsanız sorgu dizesi, yalnızca metinde bulunmalı değil, özellik değerinin tamamıyla eşleşmelidir. Metin değeri, operatör aramalarında ve yöne göre eşleşmelerde tek bir atomik değer olarak kabul edilir.

Örneğin, Kitap veya Film nesnelerini tür özellikleriyle dizine ekleyebilirsiniz. Türlere örnek olarak "Bilim Kurgu", "Bilim" ve "Kurgu" verilebilir. exactMatchWithOperator false olarak ayarlandığında veya atlandığında, bir tür arandığında ya da "Bilim" veya "Kurgu" yönü seçildiğinde metin parçalara ayrıldığı ve "Bilim" ile "Kurgu" parçaları "Bilim Kurgu"da bulunduğu için "Bilim Kurgu" ile ilgili sonuçlar da döndürülür. exactMatchWithOperator true olduğunda metin tek bir jeton olarak değerlendirilir. Bu nedenle, "Bilim" veya "Kurgu", "Bilim Kurgu" ile eşleşmez.

(İsteğe bağlı) displayOptions bölümünü ekleyin

Her propertyDefinition bölümünün sonunda isteğe bağlı bir displayOptions bölümü bulunur. Bu bölümde bir displayLabel dizesi bulunur. displayLabel, tesis için önerilen, kullanıcı dostu bir metin etiketidir. Mülk, ObjectDisplayOptions kullanılarak görüntüleme için yapılandırılmışsa bu etiket mülkün önünde gösterilir. Özellik görüntüleme için yapılandırılmışsa ve displayLabel tanımlanmamışsa yalnızca özellik değeri gösterilir.

Aşağıdaki snippet'te, "Başlık" olarak ayarlanmış bir displayLabel ile movieTitle mülkü gösterilmektedir.

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    "retrievalImportance": { "importance": "HIGHEST" },
    "operatorOptions": {
       "operatorName": "title"
    }
},
  "displayOptions": {
    "displayLabel": "Title"
  }
},

Aşağıda, örnek şemada movie nesnesinin tüm özelliklerinin displayLabel değerleri verilmiştir:

Mülk displayLabel
movieTitle Title
releaseDate Release date
genre Genre
duration Run length
actorName Actor
userRating Audience score
mpaaRating MPAA rating

(İsteğe bağlı) suggestionFilteringOperators[] bölümü ekleme

Her propertyDefinition bölümünün sonunda isteğe bağlı bir suggestionFilteringOperators[] bölümü bulunur. Otomatik tamamlama önerilerini filtrelemek için kullanılacak bir özellik tanımlamak için bu bölümden yararlanın. Örneğin, önerileri kullanıcının tercih ettiği film türüne göre filtrelemek için genre operatörünü tanımlayabilirsiniz. Ardından, kullanıcı arama sorgusunu yazdığında, otomatik tamamlama önerileri kapsamında yalnızca tercih ettiği türe uygun filmler gösterilir.

Şemanızı kaydetme

Cloud Search sorgularından yapılandırılmış veri döndürülmesi için şemanızı Cloud Search şema hizmetine kaydetmeniz gerekir. Bir şemayı kaydetmek için Veri kaynağını başlatma adımında aldığınız veri kaynağı kimliği gerekir.

Veri kaynağı kimliğini kullanarak şemanızı kaydetmek için bir UpdateSchema isteği gönderin.

UpdateSchema referans sayfasında ayrıntılı olarak açıklandığı gibi, şemanızı kaydetmek için aşağıdaki HTTP isteğini gönderin:

PUT https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*}/schema

İsteğinizin metni aşağıdakileri içermelidir:

{
  "validateOnly": // true or false,
  "schema": {
    // ... Your complete schema object ...
  }
}

Şemanızı gerçekten kaydetmeden geçerliliğini test etmek için validateOnly seçeneğini kullanın.

Verilerinizi dizine ekleyin

Şemanız kaydedildikten sonra dizin çağrılarını kullanarak veri kaynağını doldurun. Dizine ekleme işlemi genellikle içerik bağlayıcınızda yapılır.

Film şeması kullanılarak tek bir film için REST API dizine ekleme isteği şu şekilde görünür:

{
  "name": "datasource/<data_source_id>/items/titanic",
  "acl": {
    "readers": [
      {
        "gsuitePrincipal": {
          "gsuiteDomain": true
        }
      }
    ]
  },
  "metadata": {
    "title": "Titanic",
    "sourceRepositoryUrl": "http://www.imdb.com/title/tt2234155/?ref_=nv_sr_1",
    "objectType": "movie"
  },
  "structuredData": {
    "object": {
      "properties": [
        {
          "name": "movieTitle",
          "textValues": {
            "values": [
              "Titanic"
            ]
          }
        },
        {
          "name": "releaseDate",
          "dateValues": {
            "values": [
              {
                "year": 1997,
                "month": 12,
                "day": 19
              }
            ]
          }
        },
        {
          "name": "actorName",
          "textValues": {
            "values": [
              "Leonardo DiCaprio",
              "Kate Winslet",
              "Billy Zane"
            ]
          }
        },
        {
          "name": "genre",
          "enumValues": {
            "values": [
              "Drama",
              "Action"
            ]
          }
        },
        {
          "name": "userRating",
          "integerValues": {
            "values": [
              8
            ]
          }
        },
        {
          "name": "mpaaRating",
          "textValues": {
            "values": [
              "PG-13"
            ]
          }
        },
        {
          "name": "duration",
          "textValues": {
            "values": [
              "3 h 14 min"
            ]
          }
        }
      ]
    }
  },
  "content": {
    "inlineContent": "A seventeen-year-old aristocrat falls in love with a kind but poor artist aboard the luxurious, ill-fated R.M.S. Titanic.",
    "contentFormat": "TEXT"
  },
  "version": "01",
  "itemType": "CONTENT_ITEM"
}

objectType alanındaki movie değerinin şemadaki nesne tanımı adıyla nasıl eşleştiğine dikkat edin. Cloud Search, bu iki değeri eşleştirerek dizine ekleme sırasında hangi şema nesnesini kullanacağını bilir.

Ayrıca, releaseDate şeması mülkünün dizine eklenmesi sırasında datePropertyOptions kullanılarak date veri türü olarak tanımlandığı için year, month ve day alt mülklerinin nasıl kullanıldığını da unutmayın. Bununla birlikte year, month ve day şemada tanımlanmadığından bu özelliklerden biri (ör. year) ayrı ayrı yüklemeniz gerekir.

Ayrıca, yinelenebilir actorName özelliğinin bir değer listesi kullanılarak nasıl dizine eklendiğini de unutmayın.

Olası dizine ekleme sorunlarını belirleme

Şemalar ve dizine eklemeyle ilgili en yaygın iki sorun şunlardır:

  • Dizine ekleme isteğiniz, şema hizmetine kaydedilmemiş bir şema nesnesi veya mülk adı içeriyor. Bu sorun, mülkün veya nesnenin yoksayılmasına neden olur.

  • Dizine ekleme isteğinizde, şemaya kaydedilen türden farklı bir tür değeri olan bir mülk var. Bu sorun, Cloud Search'in dizine ekleme sırasında hata döndürmesine neden olur.

Şemanızı çeşitli sorgu türleriyle test etme

Şemanızı büyük bir üretim veri deposuna kaydettirmeden önce daha küçük bir test veri deposuyla test etmeyi düşünebilirsiniz. Daha küçük bir test deposuyla test yapmak, daha büyük bir dizini veya mevcut bir üretim dizinini etkilemeden şemanızda hızlıca ayarlamalar yapmanıza ve dizine eklenen verileri silmenize olanak tanır. Test verileri deposu için, diğer kullanıcıların Arama sonuçlarında bu verileri görmemesi amacıyla yalnızca bir test kullanıcısına yetki veren bir ACL oluşturun.

Arama sorgularını doğrulamak için bir arama arayüzü oluşturmak istiyorsanız Arama arayüzü başlıklı makaleyi inceleyin.

Bu bölümde bir film şemasını test etmek için kullanabileceğiniz birkaç farklı örnek sorgu bulunmaktadır.

Genel bir sorgu ile test etme

Genel sorgu, veri kaynağındaki belirli bir dizeyi içeren tüm öğeleri döndürür. Arama arayüzünü kullanarak "titanic" kelimesini yazıp Return tuşuna basarak bir film veri kaynağına karşı genel sorgu çalıştırabilirsiniz. "Titanik" kelimesini içeren tüm filmler arama sonuçlarında döndürülmelidir.

Operatörle test etme

Sorguya bir operatör eklemek, sonuçları bu operatör değeriyle eşleşen öğelerle sınırlandırır. Örneğin, belirli bir aktörle oynadığı tüm filmleri bulmak için actor operatörünü kullanabilirsiniz. Arama arayüzünü kullanarak bu operatör sorgusunu gerçekleştirmek için "oyuncu:Zane" gibi bir operatör=değer çifti yazıp Return tuşuna basmanız yeterlidir. Oyuncu olarak Zane'in yer aldığı tüm filmler arama sonuçlarında döndürülmelidir.

Şemanızı ayarlama

Şemanız ve verileriniz kullanıldıktan sonra, kullanıcılarınız için nelerin işe yarayıp yaramadığını izlemeye devam edin. Şemanızı aşağıdaki durumlar için ayarlamanız önerilir:

  • Daha önce dizine eklenmemiş bir alanın dizine eklenmesi. Örneğin, kullanıcılarınız yönetmenin adına göre filmleri tekrar tekrar arayabilir. Bu nedenle, şemanızı yönetmenin adını operatör olarak destekleyecek şekilde ayarlayabilirsiniz.
  • Kullanıcı geri bildirimine dayanarak arama operatörü adlarını değiştirme. Operatör adlarının kullanıcı dostu olması gerekir. Kullanıcılarınız yanlış operatör adını sürekli "hatırlıyorsa" bu adı değiştirmeyi düşünebilirsiniz.

Şema değişikliğinden sonra yeniden dizine ekleme

Şemanızdaki aşağıdaki değerlerden herhangi birini değiştirmek için verilerinizi yeniden dizine eklemeniz gerekmez. Yeni bir UpdateSchema isteği göndermeniz yeterlidir. Böylece dizininiz çalışmaya devam eder:

  • Operatör adları.
  • Tam sayı minimum ve maksimum değerleri.
  • Tam sayı ve enum sıralı sıralama.
  • Güncellik seçenekleri.
  • Görüntüleme seçenekleri.

Aşağıdaki değişiklikler için daha önce dizine eklenen veriler, daha önce kaydedilen şemaya göre çalışmaya devam eder. Ancak, aşağıdaki değişiklikleri içeren güncellenmiş şemaya göre değişiklikleri görmek için mevcut girişleri yeniden dizine eklemeniz gerekir:

  • Yeni bir mülk veya nesne ekleme ya da kaldırma
  • isReturnable, isFacetable veya isSortable için kullanılan false türünü true olarak değiştirme

Net bir kullanım alanınız ve ihtiyacınız varsa isFacetable veya isSortable'ü true olarak yalnızca ayarlamanız gerekir.

Son olarak, bir mülkü isSuggestable olarak işaretleyerek şemanızı güncellediğinizde verilerinizi yeniden dizine eklemeniz gerekir. Bu da söz konusu mülk için otomatik tamamlama özelliğinin kullanımında gecikmeye neden olur.

İzin verilmeyen özellik değişiklikleri

Verilerinizi yeniden dizine ekleseniz bile bazı şema değişikliklerine izin verilmez. Bu değişiklikler dizini bozar veya kötü ya da tutarsız arama sonuçları verir. Bu kapsamda:

  • Tesis veri türü.
  • Tesis adı.
  • exactMatchWithOperator ayarını etkinleştirin.
  • retrievalImportance ayar.

Ancak, bu sınırlamayı aşmanın bir yolu vardır.

Karmaşık bir şema değişikliği yapma

Cloud Search, depo dizine eklendikten sonra kötü arama sonuçları veya bozuk bir arama dizini oluşturacak değişiklikleri önlemek için UpdateSchema isteklerinde belirli türde değişiklikleri engeller. Örneğin, bir özelliğin veri türü veya adı ayarlandıktan sonra değiştirilemez. Verilerinizi yeniden dizine ekleseniz bile bu değişiklikler basit bir UpdateSchema isteğiyle gerçekleştirilemez.

Şemanızda başka bir şekilde izin verilmeyen bir değişiklik yapmanız gerektiğinde, genellikle aynı etkiye sahip bir dizi izin verilen değişiklik yapabilirsiniz. Genel olarak bu, dizine eklenen mülklerin eski bir nesne tanımından yenisine taşınması ve ardından yalnızca yeni mülkü kullanan bir dizine ekleme isteği gönderilmesini içerir.

Aşağıdaki adımlarda, bir mülkün veri türünün veya adının nasıl değiştirileceği gösterilmektedir:

  1. Şemanızdaki nesne tanımına yeni bir özellik ekleyin. Değiştirmek istediğiniz tesisten farklı bir ad kullanın.
  2. UpdateSchema isteğini yeni tanımı kullanarak gönderin. İstekte hem yeni hem de eski mülk dahil olmak üzere şemanın tamamını göndermeyi unutmayın.

  3. Dizini veri deposundan doldurun. Dizini doldurmak için tüm dizine ekleme isteklerini yeni mülkü kullanarak gönderin. Sorgu eşleşmelerinin iki kez sayılmasına neden olacağından eski mülkü kullanmayın.

    1. Dolguyu dizine ekleme sırasında yeni mülkü kontrol edin ve tutarsız davranıştan kaçınmak için varsayılan olarak eski mülkü kullanın.
    2. Doldurma işlemi tamamlandıktan sonra doğrulamak için test sorguları çalıştırın.

  4. Eski mülkü silin. Eski mülk adı olmadan başka bir UpdateSchema isteği gönderin ve gelecekteki dizine ekleme isteklerinde eski mülk adını kullanmayı bırakın.

  5. Eski mülkün tüm kullanımlarını yeni mülke taşıyın. Örneğin, mülk adını içerik üreticiden yazar olarak değiştirirseniz sorgu kodunuzu, daha önce içerik üreticiye referans verdiği yerde yazarı kullanacak şekilde güncellemeniz gerekir.

Cloud Search, beklenmedik dizine ekleme sonuçlarına neden olabilecek yeniden kullanımlara karşı koruma sağlamak için silinen tüm mülkleri veya nesneleri 30 gün boyunca saklar. Bu 30 gün içinde, silinen nesnenin veya mülkün tüm kullanımlarını taşımanız (gelecekteki dizin isteklerinden hariç tutmak da dahil) gerekir. Bu sayede, daha sonra bu mülkü veya nesneyi yeniden etkinleştirmeye karar verirseniz bunu dizininizin doğruluğunu koruyacak şekilde yapabilirsiniz.

Boyut sınırlamaları

Cloud Search, yapılandırılmış veri nesnelerinin ve şemaların boyutuna sınırlama getirir. Bu sınırlar şunlardır:

  • En fazla 10 üst düzey nesne olabilir.
  • Yapılandırılmış bir veri hiyerarşisinin maksimum derinliği 10 düzeydir.
  • Bir nesnedeki toplam alan sayısı 1.000 ile sınırlıdır. Bu sınır, temel alanların sayısı ile iç içe yerleştirilmiş her nesnedeki alan sayısının toplamını içerir.

Sonraki Adımlar

Atabileceğiniz sonraki adımlardan bazıları şunlardır:

  1. Şemanızı test etmek için bir arama arayüzü oluşturun.

  2. Arama kalitesini iyileştirmek için şemanızı ayarlayın.

  3. En iyi sorgu yorumlaması için bir şema yapılandırın.

  4. Şirketinizde yaygın olarak kullanılan terimlerin eş anlamlılarını tanımlamak için _dictionaryEntry şemasından nasıl yararlanacağınızı öğrenin. _dictionaryEntry şemasını kullanmak için Eş anlamlı kelimeleri tanımlama başlıklı makaleyi inceleyin.

  5. Bağlayıcı oluşturun.