Azure AI Search'te en son REST API'ye yükseltme

Veri düzlemi çağrılarını Arama REST API'lerinin daha yeni sürümlerine geçirmek için bu makaleyi kullanın.

• 2024-07-01 en son kararlı sürümdür.

• 2024-09-01-preview en son önizleme API'sinin sürümüdür.

Yükseltme yönergeleri, mevcut kodun önceki sürümlerle aynı ancak daha yeni API sürümünde çalışması için önceki sürümlerden gelen hataya neden olan değişikliklerden geçmenizi sağlayan kod değişikliklerine odaklanır. Kodunuz çalışır durumda olduğunda, daha yeni özellikleri benimsemeye karar vekleyebilirsiniz. Yeni özellikler hakkında daha fazla bilgi edinmek için bkz . vektör kodu örnekleri ve Yenilikler.

Siz en yeni sürüme gelene kadar her sürüm üzerinde çalışarak API sürümlerini sırayla yükseltmenizi öneririz.

2023-07-01-preview vektör desteği için ilk REST API'ydi. Bu API sürümünü kullanmayın. Artık kullanım dışı bırakıldı ve hemen kararlı veya daha yeni önizleme REST API'lerine geçmeniz gerekir.

Not

REST API başvuru belgeleri artık sürümlenmiştir. Sürüme özgü içerik için bir başvuru sayfası açın ve ardından sağ tarafta, içindekiler tablosunun üzerinde bulunan seçiciyi kullanarak sürümünüzü seçin.

Yükseltme zamanları

Azure AI Search son çare olarak geriye dönük uyumluluğu bozar. Yükseltme şu durumlarda gereklidir:

• Kodunuz kullanımdan kaldırılan veya desteklenmeyen bir API sürümüne başvurur ve bir veya daha fazla hataya neden olan değişikliğe tabidir. Kodunuz vektörleri 2023-07-10-preview , 2020-06-01-preview anlam derecesini ve eski becerileri ve 2019-05-06 geçici çözümleri hedeflerse hataya neden olan değişiklikleri gidermeniz gerekir.

• Api yanıtında tanınmayan özellikler döndürülürse kodunuz başarısız olur. En iyi uygulama olarak, uygulamanız anlamadığı özellikleri yoksaymalıdır.

• Kodunuz API isteklerini devam ettiriyor ve bunları yeni API sürümüne yeniden göndermeye çalışıyor. Örneğin, uygulamanız Arama API'sinden döndürülen devamlılık belirteçlerini devam ettirirse bu durum oluşabilir (daha fazla bilgi için @search.nextPageParameters Arama API'sinin Başvurusu'nda arayın).

Yükseltme

1. Her API sürümü için sürüm notlarını gözden geçirin.

2. api-version İstek üst bilgisinde belirtilen parametresini daha yeni bir sürüme güncelleştirin.

   REST API'lerine doğrudan çağrılar yapan uygulama kodunuzda, mevcut sürümün tüm örneklerini arayın ve yeni sürümle değiştirin. REST çağrısı yapılandırma hakkında daha fazla bilgi için bkz . Hızlı Başlangıç: REST kullanma.

   Azure SDK kullanıyorsanız, bu paketler REST API'nin belirli sürümlerini hedefler. Paket güncelleştirmeleri bir REST API güncelleştirmesi ile çakışabilir, ancak her SDK, Azure AI Search REST API sürümlerinden bağımsız olarak gelen kendi sürüm zamanlamalarındadır. Bir paket sürümünün en son REST API sürümünü hedefleyip hedeflemediğini belirlemek için SDK paketinizin değişiklik günlüğünü denetleyin.

3. Bu makalede belgelenen hataya neden olan değişiklikleri gözden geçirin ve geçici çözümleri uygulayın. Kodunuz tarafından kullanılan sürümle başlayın ve en yeni kararlı veya önizleme sürümüne gelene kadar her yeni API sürümü için hataya neden olan değişiklikleri çözün.

Bağlantı bilgilerini okuyan istemci kodunda hataya neden olan değişiklik

29 Mart 2024 tarihinden itibaren geçerli olup desteklenen tüm REST API'ler için geçerlidir:

• GET Skillset, GET Index ve GET Indexer artık yanıtta anahtar veya bağlantı özellikleri döndürmez. Get yanıtından anahtarları veya bağlantıları (hassas veriler) okuyan aşağı akış kodunuz varsa bu hataya neden olan bir değişikliktir.

• Arama hizmetiniz için yönetici veya sorgu API anahtarlarını almanız gerekiyorsa Yönetim REST API'lerini kullanın.

• Azure Depolama veya Azure Cosmos DB gibi başka bir Azure kaynağının bağlantı dizesi almanız gerekiyorsa, bilgileri almak için bu kaynağın API'lerini ve yayımlanan yönergeleri kullanın.

Semantik dereceleyici için hataya neden olan değişiklik

Anlam dereceleyicisi genel olarak içinde 2023-11-01kullanılabilir. Önceki sürümlerde semantik dereceleyici için hataya neden olan değişiklikler şunlardır:

• sürümünden sonraki 2020-06-01-previewsemanticConfiguration tüm sürümlerdesearchFields, L2 derecelendirmesi için hangi alanların kullanılacağını belirtme mekanizması olarak değiştirilir.

• Tüm API sürümleri için, 14 Temmuz 2023'te Microsoft tarafından barındırılan anlamsal modellere yapılan güncelleştirmeler semantik ranker language-agnostic yaptı ve özelliğin yetkisini queryLanguage etkin bir şekilde aldı. Kodda "hataya neden olan değişiklik" yoktur, ancak özelliği yoksayılır.

Kodunuzu kullanmak semanticConfigurationüzere geçirmek için bkz. Önizleme sürümünden geçiş.

2024-09-01-preview sürümüne yükseltme

2024-09-01-previewmetin ekleme-3 modelleri için Matryoshka Temsili Öğrenmesi (MRL) sıkıştırması, karma sorgular için hedefli vektör filtreleme, hata ayıklama için vektör alt çekirdek ayrıntıları ve Metin Bölme becerisi için belirteç öbekleme ekler.

sürümünden 2024-05-01-previewyükseltiyorsanız, mevcut kodda değişiklik olmadan yeni önizleme API'lerini kullanabilirsiniz.

2024-07-01 sürümüne yükseltme

2024-07-01 genel bir sürümdür. Eski önizleme özellikleri genel kullanıma sunuldu: tümleşik öbekleme ve vektörleştirme (Metin Bölme becerisi, AzureOpenAIEmbedding becerisi), AzureOpenAIEmbedding tabanlı sorgu vektörleştiricisi, vektör sıkıştırma (skaler niceleme, ikili niceleme, depolanan özellik, dar veri türleri).

'den 2024-05-01-preview kararlıya yükseltirseniz hataya neden olan hiçbir değişiklik yoktur. Yeni kararlı sürümü kullanmak için API sürümünü değiştirin ve kodunuzu test edin.

Doğrudan 'den 2023-11-01yükseltme yaparsanız hataya neden olan değişiklikler vardır. sürümünden 2023-11-01 2024-07-01sürümüne geçirebilmek için her yeni önizleme için açıklanan adımları izleyin.

2024-05-01-preview sürümüne yükseltme

2024-05-01-preview OneLake dizini, ikili vektör desteği ve daha fazla ekleme modeli desteği ekler.

'den 2024-03-01-previewyükseltme yapıyorsanız AzureOpenAIEmbedding becerisi artık bir model adı ve boyutlar özelliği gerektirir.

1. Kod tabanınızda AzureOpenAIEmbedding başvuruları arayın.

2. modelName"text-embedding-ada-002" ve "1536" olarak ayarlayındimensions.

2024-03-01-preview sürümüne yükseltme

2024-03-01-preview dar veri türleri, skaler niceleme ve vektör depolama seçenekleri ekler.

'den 2023-10-01-previewyükseltme yapıyorsanız hataya neden olan bir değişiklik yoktur. Ancak bir davranış farkı vardır: için ve daha yeni önizlemeler için 2023-11-01 varsayılan değer, vectorFilterMode filtre ifadeleri için postfilter yerine ön filtre olarak değiştirildi.

1. Kod tabanınızda vectorFilterMode başvuru arayın.

2. Özellik açıkça ayarlanırsa hiçbir eylem gerekmez. Varsayılanı kullandıysanız, yeni varsayılan davranışın sorgu yürütmeden önce filtrelemek olduğunu unutmayın. Sorgu sonrası filtreleme istiyorsanız, eski davranışı korumak için açıkça postfilter olarak ayarlayın vectorFilterMode .

2023-11-01 sürümüne yükseltme

2023-11-01 genel bir sürümdür. Eski önizleme özellikleri genel kullanıma sunuldu: semantik dereceleyici, vektör dizini ve sorgu desteği.

dosyasından hataya 2023-10-01-previewneden olan hiçbir değişiklik yoktur, ancak dosyasından ' 2023-07-01-preview de birden çok hataya 2023-11-01neden olan değişiklik vardır. Daha fazla bilgi için bkz . 2023-07-01-preview sürümünden yükseltme.

Yeni kararlı sürümü kullanmak için API sürümünü değiştirin ve kodunuzu test edin.

2023-10-01-preview sürümüne yükseltme

2023-10-01-previewdizin oluşturma ve yerleşik sorgu vektörleştirmesi sırasında yerleşik veri öbekleme ve vektörleştirme ekleyecek ilk önizleme sürümüdür. Ayrıca vektör dizin oluşturmayı ve önceki sürümden gelen sorguları destekler.

Önceki sürümden yükseltme yapıyorsanız, sonraki bölümde adımlar yer alır.

2023-07-01-preview sürümünden yükseltme

Bu API sürümünü kullanmayın. Daha yeni bir API sürümüyle uyumlu olmayan bir vektör sorgusu söz dizimi uygular.

2023-07-01-previewartık kullanım dışıdır, bu nedenle yeni kodu bu sürüme dayandırmamanız veya herhangi bir koşulda bu sürüme yükseltmemeniz gerekir. Bu bölümde, sürümünden daha yeni bir API sürümüne geçiş yolu 2023-07-01-preview açıklanmaktadır.

Vektör dizinleri için portal yükseltmesi

Azure portal, dizinler için 2023-07-01-preview tek tıklamayla yükseltme yolunu destekler. Vektör alanlarını algılar ve bir Geçiş düğmesi sağlar.

• Geçiş yolu ' dan ' 2023-07-01-preview adır 2024-05-01-preview.
• Güncelleştirmeler vektör alanı tanımları ve vektör arama algoritması yapılandırmalarıyla sınırlıdır.
• Güncelleştirmeler tek yönlü olarak gerçekleştirilir. Yükseltmeyi tersine çeviremezsiniz. Dizin yükseltildikten sonra, dizini sorgulamak için veya üzerini kullanmanız 2024-05-01-preview gerekir.

Vektör sorgusu söz dizimlerini yükseltmek için portal geçişi yoktur. Sorgu söz dizimi değişiklikleri için bkz . kod yükseltmeleri .

Geçir'i seçmeden önce güncelleştirilmiş şemayı gözden geçirmek için JSON Düzenle'yi seçin. Kod yükseltme bölümünde açıklanan değişikliklere uygun bir şema bulmanız gerekir. Portal geçişi yalnızca bir vektör arama algoritması yapılandırmasına sahip dizinleri işler. Vektör arama algoritmasına 2023-07-01-preview eşleyen varsayılan bir profil oluşturur. Birden çok vektör arama yapılandırmasına sahip dizinler el ile geçiş gerektirir.

Vektör dizinleri ve sorgular için kod yükseltme

Vektör arama desteği, Dizin Oluşturma veya Güncelleştirme (2023-07-01-preview) bölümünde sunulmuştur.

sürümünden 2023-07-01-preview daha yeni bir kararlı veya önizleme sürümüne yükseltmek için şunlar gerekir:

• Dizindeki vektör yapılandırmasını yeniden adlandırma ve yeniden yapılandırma
• Vektör sorgularınızı yeniden yazma

Vektör alanlarını, yapılandırmayı ve sorgularını 'den 2023-07-01-previewgeçirmek için bu bölümdeki yönergeleri kullanın.

1. Var olan tanımı almak için Dizin Al'ı çağırın.

2. Vektör arama yapılandırmasını değiştirin. 2023-11-01ve sonraki sürümler, vektörle ilgili yapılandırmaları tek bir adla paketleyen vektör profilleri kavramını tanıtır. Daha yeni sürümler de olarak yeniden adlandırır algorithmConfigurations algorithms.

   • algorithmConfigurations öğesini algorithms olarak yeniden adlandırın. Bu yalnızca dizinin yeniden adlandırılmasıdır. İçerikler geriye dönük olarak uyumludur. Bu, mevcut HNSW yapılandırma parametrelerinizin kullanılabileceğini gösterir.

   • her biri için bir ad ve bir algoritma yapılandırması vererek ekleyin profiles.

   Geçiş öncesinde (2023-07-01-preview):

     "vectorSearch": {
       "algorithmConfigurations": [
           {
               "name": "myHnswConfig",
               "kind": "hnsw",
               "hnswParameters": {
                   "m": 4,
                   "efConstruction": 400,
                   "efSearch": 500,
                   "metric": "cosine"
               }
           }
       ]}
   

   Geçiş sonrasında (2023-11-01):

     "vectorSearch": {
       "algorithms": [
         {
           "name": "myHnswConfig",
           "kind": "hnsw",
           "hnswParameters": {
             "m": 4,
             "efConstruction": 400,
             "efSearch": 500,
             "metric": "cosine"
           }
         }
       ],
       "profiles": [
         {
           "name": "myHnswProfile",
           "algorithm": "myHnswConfig"
         }
       ]
     }
   

3. vektör alanı tanımlarını değiştirin ve yerine vectorSearchConfiguration öğesini yazın vectorSearchProfile. Profil adının algoritma yapılandırma adını değil yeni bir vektör profili tanımına çözümlediğinden emin olun. Diğer vektör alanı özellikleri değişmeden kalır. Örneğin, filtrelenebilir, sıralanabilir veya modellenebilir olamazlar ya da çözümleyiciler ya da normalleştiriciler ya da eş anlamlı haritalar kullanamazlar.

   Önce (2023-07-01-preview):

     {
         "name": "contentVector",
         "type": "Collection(Edm.Single)",
         "key": false,
         "searchable": true,
         "retrievable": true,
         "filterable": false,  
         "sortable": false,  
         "facetable": false,
         "analyzer": "",
         "searchAnalyzer": "",
         "indexAnalyzer": "",
         "normalizer": "",
         "synonymMaps": "", 
         "dimensions": 1536,
         "vectorSearchConfiguration": "myHnswConfig"
     }
   

   Sonra (2023-11-01):

     {
       "name": "contentVector",
       "type": "Collection(Edm.Single)",
       "searchable": true,
       "retrievable": true,
       "filterable": false,  
       "sortable": false,  
       "facetable": false,
       "analyzer": "",
       "searchAnalyzer": "",
       "indexAnalyzer": "",
       "normalizer": "",
       "synonymMaps": "", 
       "dimensions": 1536,
       "vectorSearchProfile": "myHnswProfile"
     }
   

4. Değişiklikleri göndermek için Oluşturma veya Güncelleştirme Dizini'ni çağırın.

5. Sorgu söz dizimini değiştirmek için ARAMA POST'unu değiştirin. Bu API değişikliği, çok biçimli vektör sorgu türleri için destek sağlar.

   • vectors öğesini vectorQueries olarak yeniden adlandırın.
   • Her vektör sorgusu için öğesini ekleyin kindve olarak vectorayarlayın.
   • Her vektör sorgusu için olarak yeniden adlandırın value vector.
   • İsteğe bağlı olarak, filtre ifadeleri kullanıyorsanız ekleyinvectorFilterMode. Varsayılan değer, sonrasında 2023-10-01oluşturulan dizinler için ön filtredir. Bu tarihten önce oluşturulan dizinler, filtre modunu nasıl ayarladığınızdan bağımsız olarak yalnızca postfilter'ı destekler.

   Önce (2023-07-01-preview):

   {
       "search": (this parameter is ignored in vector search),
       "vectors": [
         {
           "value": [
               0.103,
               0.0712,
               0.0852,
               0.1547,
               0.1183
           ],
           "fields": "contentVector",
           "k": 5
         }
       ],
       "select": "title, content, category"
   }
   

   Sonra (2023-11-01):

   {
     "search": "(this parameter is ignored in vector search)",
     "vectorQueries": [
       {
         "kind": "vector",
         "vector": [
           0.103,
           0.0712,
           0.0852,
           0.1547,
           0.1183
         ],
         "fields": "contentVector",
         "k": 5
       }
     ],
     "vectorFilterMode": "preFilter",
     "select": "title, content, category"
   }
   

Bu adımlar, kararlı API sürümüne veya daha yeni önizleme API sürümlerine 2023-11-01 geçişi tamamlar.

2020-06-30 sürümüne yükseltme

Bu sürümde bir hataya neden olan değişiklik ve çeşitli davranış farklılıkları vardır. Genel kullanıma sunulan özellikler şunlardır:

• Bilgi deposu, beceri kümeleri aracılığıyla oluşturulan, diğer uygulamalar aracılığıyla aşağı akış analizi ve işleme için oluşturulan zenginleştirilmiş içeriğin kalıcı olarak depolanması. Azure AI Search REST API'leri aracılığıyla bir bilgi deposu oluşturulur ancak Azure Depolama'da bulunur.

Hataya neden olan değişiklik

Kod aşağıdaki işlevleri içeriyorsa, önceki API sürümlerine göre yazılan kod, ve sonraki sürümlerde 2020-06-30 sonlanır:

• Filtre ifadelerindeki tüm Edm.Date değişmez değerlerin (yıl-ay-gün gibi 2020-12-12) biçimine uyması Edm.DateTimeOffset gerekir: 2020-12-12T00:00:00Z. Bu değişiklik, saat dilimi farkları nedeniyle hatalı veya beklenmeyen sorgu sonuçlarını işlemek için gerekliydi.

Davranış değişiklikleri

• BM25 derecelendirme algoritması , önceki derecelendirme algoritmasını daha yeni teknolojiyle değiştirir. 2019'un ardından oluşturulan hizmetler bu algoritmayı otomatik olarak kullanır. Eski hizmetler için parametreleri yeni algoritmayı kullanacak şekilde ayarlamanız gerekir.

• Bu sürümde null değerler için sıralı sonuçlar değişti; sıralama asc ise önce null değerler, sıralama ise son olarak descgörüntülenir. Null değerlerin nasıl sıralanacağını işlemek için kod yazdıysanız, bu değişikliğe dikkat edin.

2019-05-06 sürümüne yükseltme

Bu API sürümünde genel kullanıma sunulan özellikler şunlardır:

• Otomatik tamamlama , kısmen belirtilen terim girişini tamamlayan bir tür başlığı özelliğidir.
• Karmaşık türler , arama dizinindeki yapılandırılmış nesne verileri için yerel destek sağlar.
• Azure Blob dizin oluşturmanın bir parçası olan JsonLines ayrıştırma modları, JSON varlığı başına yeni bir satırla ayrılmış bir arama belgesi oluşturur.
• Yapay zeka zenginleştirme , Azure yapay zeka hizmetlerinin yapay zeka zenginleştirme altyapılarını kullanan dizin oluşturma sağlar.

Hataya neden olan değişiklikler

Önceki bir API sürümüne göre yazılan kod, aşağıdaki işlevleri içeriyorsa ve sonrasında sonlanır 2019-05-06 :

1. Azure Cosmos DB için tür özelliği. NoSQL için Azure Cosmos DB API veri kaynağını hedefleyen dizin oluşturucular için olarak "type": "cosmosdb"değiştirin"type": "documentdb".

2. Dizin oluşturucu hata işleme özelliğine status başvurular içeriyorsa, bunu kaldırmanız gerekir. Yararlı bilgiler sağlamadığından hata yanıtından durumu kaldırdık.

3. Veri kaynağı bağlantı dizesi artık yanıtta döndürülmüyor. API sürümlerinden 2019-05-06 ve 2019-05-06-Preview sonrasında veri kaynağı API'si artık herhangi bir REST işleminin yanıtında bağlantı dizesi döndürmez. Önceki API sürümlerinde POST kullanılarak oluşturulan veri kaynakları için Azure AI Search 201 döndürdü ve ardından düz metin olarak bağlantı dizesi içeren OData yanıtı geldi.

4. Adlandırılmış Varlık Tanıma bilişsel becerisi kullanımdan kaldırıldı. Kodunuzda Ad Varlığı Tanıma becerisini çağırdıysanız, çağrı başarısız olur. Değiştirme işlevi, Varlık Tanıma Becerisi (V3) işlevidir. Desteklenen bir beceriye geçmek için Kullanım dışı beceriler'deki önerileri izleyin.

Karmaşık türleri yükseltme

API sürümü 2019-05-06 , karmaşık türler için resmi destek eklendi. Kodunuz 2017-11-11-Preview veya 2016-09-01-Preview sürümlerinde karmaşık tür denkliği için önceki önerileri uyguladıysa, sürümünden 2019-05-06 başlayarak bilmeniz gereken bazı yeni ve değiştirilmiş sınırlar vardır:

• Alt alan derinliği ve dizin başına karmaşık koleksiyon sayısı sınırları azaltıldı. Önizleme api sürümlerini kullanarak bu sınırları aşan dizinler oluşturduysanız, API sürümünü 2019-05-06 kullanarak bunları güncelleştirme veya yeniden oluşturma girişimleri başarısız olur. Kendinizi bu durumda bulursanız şemanızı yeni sınırlara uyacak şekilde yeniden tasarlamanız ve ardından dizininizi yeniden oluşturmanız gerekir.

• Api sürümünden 2019-05-06 başlayarak belge başına karmaşık koleksiyonların öğe sayısıyla ilgili yeni bir sınır vardır. Önizleme api sürümlerini kullanarak bu sınırları aşan belgelerle dizinler oluşturduysanız, api-version 2019-05-06 kullanarak bu verileri yeniden dizine ekleme girişimleri başarısız olur. Kendinizi bu durumda bulursanız, verilerinizi yeniden dizine almadan önce belge başına karmaşık koleksiyon öğelerinin sayısını azaltmanız gerekir.

Daha fazla bilgi için bkz . Azure AI Search için hizmet sınırları.

Eski bir karmaşık tür yapısını yükseltme

Kodunuz eski önizleme API sürümlerinden biriyle karmaşık türler kullanıyorsa, şuna benzer bir dizin tanımı biçimi kullanıyor olabilirsiniz:

{
  "name": "hotels",  
  "fields": [
    { "name": "HotelId", "type": "Edm.String", "key": true, "filterable": true },
    { "name": "HotelName", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": true, "facetable": false },
    { "name": "Description", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "en.microsoft" },
    { "name": "Description_fr", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "fr.microsoft" },
    { "name": "Category", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Tags", "type": "Collection(Edm.String)", "searchable": true, "filterable": true, "sortable": false, "facetable": true, "analyzer": "tagsAnalyzer" },
    { "name": "ParkingIncluded", "type": "Edm.Boolean", "filterable": true, "sortable": true, "facetable": true },
    { "name": "LastRenovationDate", "type": "Edm.DateTimeOffset", "filterable": true, "sortable": true, "facetable": true },
    { "name": "Rating", "type": "Edm.Double", "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address", "type": "Edm.ComplexType" },
    { "name": "Address/StreetAddress", "type": "Edm.String", "filterable": false, "sortable": false, "facetable": false, "searchable": true },
    { "name": "Address/City", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/StateProvince", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/PostalCode", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/Country", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Location", "type": "Edm.GeographyPoint", "filterable": true, "sortable": true },
    { "name": "Rooms", "type": "Collection(Edm.ComplexType)" }, 
    { "name": "Rooms/Description", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "en.lucene" },
    { "name": "Rooms/Description_fr", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "fr.lucene" },
    { "name": "Rooms/Type", "type": "Edm.String", "searchable": true },
    { "name": "Rooms/BaseRate", "type": "Edm.Double", "filterable": true, "facetable": true },
    { "name": "Rooms/BedOptions", "type": "Edm.String", "searchable": true },
    { "name": "Rooms/SleepsCount", "type": "Edm.Int32", "filterable": true, "facetable": true },
    { "name": "Rooms/SmokingAllowed", "type": "Edm.Boolean", "filterable": true, "facetable": true },
    { "name": "Rooms/Tags", "type": "Collection(Edm.String)", "searchable": true, "filterable": true, "facetable": true, "analyzer": "tagsAnalyzer" }
  ]
}  

API sürümünde dizin alanlarını tanımlamak için daha yeni bir ağaç benzeri biçim kullanıma sunulmuştur 2017-11-11-Preview. Yeni biçimde, her karmaşık alanın alt alanlarının tanımlandığı bir alan koleksiyonu vardır. API sürüm 2019-05-06'da bu yeni biçim yalnızca kullanılır ve eski biçimi kullanarak dizin oluşturmaya veya güncelleştirmeye çalışmak başarısız olur. Eski biçim kullanılarak oluşturulmuş dizinleriniz varsa, API sürümü 2017-11-11-Preview 2019-05-06 kullanılarak yönetilmeden önce bunları yeni biçime güncelleştirmek için API sürümünü kullanmanız gerekir.

API sürümünü 2017-11-11-Previewkullanarak aşağıdaki adımlarla düz dizinleri yeni biçime güncelleştirebilirsiniz:

1. Dizininizi almak için bir GET isteği gerçekleştirin. Zaten yeni biçimdeyse işiniz bitti demektir.

2. Dizini düz biçimden yeni biçime çevirin. Bu yazma sırasında kullanılabilir örnek kod olmadığından bu görev için kod yazmanız gerekir.

3. Dizini yeni biçime güncelleştirmek için bir PUT isteği gerçekleştirin. Dizin API'sinin mevcut dizinin fiziksel ifadesini etkileyen değişikliklere izin verilmediğinden, alanların aranabilirliği/filtrelenebilirliği gibi diğer dizin ayrıntılarını değiştirmekten kaçının.

Not

Azure portalından eski "düz" biçimiyle oluşturulan dizinleri yönetmek mümkün değildir. Lütfen dizinlerinizi "düz" gösterimden en erken kolaylıkta "ağaç" gösterimine yükseltin.

Sonraki adımlar

ARAMA REST API'sinin başvuru belgelerini gözden geçirin. Sorunlarla karşılaşırsanız Stack Overflow hakkında yardım isteyin veya desteğe başvurun.

Arama hizmeti REST API Başvurusu