Hızlı başlangıç: Azure portal Azure Bilişsel Arama dizini oluşturmaQuickstart: Create an Azure Cognitive Search index in the Azure portal

Kavramları hızlı bir şekilde artırma ve dakikalar içinde bir dizine yönelik ilginç sorgular yazmak için portalını kullanın.Use the portal to quickly ramp up on concepts, and write interesting queries against an index within minutes.

  • Azure 'da barındırılan ücretsiz bir genel örnek veri kümesiyle başlayınStart with a free public sample data set hosted on Azure
  • Veri yüklemek ve bir dizin oluşturmak için Azure Bilişsel Arama veri alma Sihirbazı 'nı çalıştırınRun the Import data wizard in Azure Cognitive Search to load data and generate an index
  • Portalda dizin oluşturma ilerlemesini izlemeMonitor indexing progress in the portal
  • Var olan bir dizini ve değiştirme seçeneklerini görüntülemeView an existing index and options for modifying it
  • Arama Gezgini ile tam metin arama, filtreler, modeller, belirsiz arama ve coğrafi arama 'yı keşfetExplore full text search, filters, facets, fuzzy search, and geosearch with Search explorer

Araçlar çok sınırlandırıyorsa, .net bilişsel arama Azure 'da programlamaya yönelik kod tabanlı bir giriş veya REST API çağrı yapmak için Postmankullanabilirsiniz.If the tools are too limiting, you can consider a code-based introduction to programming Azure Cognitive Search in .NET or use Postman for making REST API calls.

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.If you don't have an Azure subscription, create a free account before you begin.

Ön koşullarPrerequisites

Geçerli aboneliğinizde bir Azure bilişsel arama hizmeti oluşturun veya var olan bir hizmeti bulun .Create an Azure Cognitive Search service or find an existing service under your current subscription. Bu hızlı başlangıç için ücretsiz bir hizmet kullanabilirsiniz.You can use a free service for this quickstart.

Alan denetlemeCheck for space

Birçok müşteri ücretsiz hizmetle başlar.Many customers start with the free service. Bu sürüm üç dizin, üç veri kaynağı ve üç dizin oluşturucu ile sınırlıdır.This version is limited to three indexes, three data sources, and three indexers. Başlamadan önce ek öğeler için yeriniz olduğundan emin olun.Make sure you have room for extra items before you begin. Bu öğreticide her nesneden birer tane oluşturulur.This tutorial creates one of each object.

Hizmet panosundaki bölümler, kaç Dizin, Dizin Oluşturucu ve veri kaynağı olduğunu gösterir.Sections on the service dashboard show how many indexes, indexers, and data sources you already have.

Dizin, Dizin oluşturucular ve veri kaynakları listesi

Dizin oluşturma ve verileri yüklemeCreate an index and load data

Arama sorguları aranabilir veriler, meta veriler ve arama davranışlarını iyileştiren ek yapılar içeren bir dizin kullanır.Search queries iterate over an index that contains searchable data, metadata, and additional constructs that optimize certain search behaviors.

Bu öğreticide, veri alma Sihirbazıaracılığıyla bir Dizin Oluşturucu kullanılarak gezinilebilen yerleşik bir örnek veri kümesi kullanırız.For this tutorial, we use a built-in sample dataset that can be crawled using an indexer via the Import data wizard. Dizin oluşturucu, kaynağa özgü bir gezgindir ve desteklenen Azure veri kaynaklarındaki meta verileri ve içeriği okuyabilir.An indexer is a source-specific crawler that can read metadata and content from supported Azure data sources. Normalde, Dizin oluşturucular programlı olarak kullanılır, ancak portalda verileri Içeri aktarma Sihirbazı aracılığıyla erişebilirsiniz.Normally, indexers are used programmatically, but in the portal, you can access them through the Import data wizard.

1. adım-veri alma Sihirbazı 'nı başlatın ve bir veri kaynağı oluşturunStep 1 - Start the Import data wizard and create a data source

  1. Azure Bilişsel Arama hizmeti panosunda, bir arama dizini oluşturmak ve doldurmak için komut çubuğunda verileri Içeri aktar ' a tıklayın.On the Azure Cognitive Search service dashboard, click Import data on the command bar to create and populate a search index.

    Verileri içeri aktar komutu

  2. Sihirbazda, veri > > oteller-Sample örneklerine bağlanın ' a tıklayın.In the wizard, click Connect to your data > Samples > hotels-sample. Bu veri kaynağı yerleşik olarak bulunur.This data source is built-in. Kendi veri kaynağınızı oluşturuyorsanız ad, tür ve bağlantı bilgilerini belirtmeniz gerekir.If you were creating your own data source, you would need to specify a name, type, and connection information. Oluşturulan kaynak, diğer içeri aktarma işlemlerinde yeniden kullanılabilecek bir “mevcut veri kaynağı” olur.Once created, it becomes an "existing data source" that can be reused in other import operations.

    Örnek veri kümesi seçme

  3. Sonraki sayfaya devam edin.Continue to the next page.

2. adım-"zenginleştirme içerik" sayfasını atlayınStep 2 - Skip the "Enrich content" page

Sihirbaz bilişsel hizmetler AI algoritmalarını dizine eklemek için bir AI zenginleştirme ardışık düzeni oluşturmayı destekler.The wizard supports the creation of an AI enrichment pipeline for incorporating the Cognitive Services AI algorithms into indexing.

Bu adımı şimdilik atlayacağız ve hedef dizini özelleştirmekiçin doğrudan üzerine ilerliyoruz.We'll skip this step for now, and move directly on to Customize target index.

Bilişsel beceri adımını atlama

İpucu

Bir hızlı başlangıç veya öğreticidebir AI dizin oluşturma örneği aracılığıyla ilerlemesini sağlayabilirsiniz.You can step through an AI-indexing example in a quickstart or tutorial.

3. adım-dizini yapılandırmaStep 3 - Configure index

Genellikle, dizin oluşturma, veri yüklenmeden önce tamamlanan kod tabanlı bir uygulamadır.Typically, index creation is a code-based exercise, completed prior to loading data. Ancak, Bu öğreticinin gösterdiği gibi, sihirbaz gezinebileceği herhangi bir veri kaynağı için temel bir dizin oluşturabilir.However, as this tutorial indicates, the wizard can generate a basic index for any data source it can crawl. Dizin için en azından bir ad ve alan koleksiyonu gerekir ve her belgenin benzersiz olarak tanımlanabilmesi için bir alanın belge anahtarı olarak işaretlenmiş olması gerekir.Minimally, an index requires a name and a fields collection; one of the fields should be marked as the document key to uniquely identify each document. Ayrıca, otomatik tamamlama veya önerilen sorguları isterseniz dil Çözümleyicileri veya öneri araçları belirtebilirsiniz.Additionally, you can specify language analyzers or suggesters if you want autocomplete or suggested queries.

Alanların veri türleri ve öznitelikleri vardır.Fields have data types and attributes. Üstteki onay kutuları, alanın nasıl kullanılacağını denetleyen dizin öznitelikleridir.The check boxes across the top are index attributes controlling how the field is used.

  • Alınabilir, arama sonuçları listesinde çıktığı anlamına gelir.Retrievable means that it shows up in search results list. Bu onay kutusunu temizleyerek, örneğin yalnızca filtre ifadelerinde kullanılan alanlar için, bu onay kutusunu temizleyerek, tek tek alanları, arama sonuçları için sınırlı olarak işaretleyebilirsiniz.You can mark individual fields as off limits for search results by clearing this checkbox, for example for fields used only in filter expressions.
  • Anahtar , benzersiz belge tanımlayıcısıdır.Key is the unique document identifier. Her zaman bir dizedir ve gereklidir.It's always a string, and it is required.
  • Filtrelenebilir, sıralanabilirve çok yönlü tablo , alanların bir filtre, sıralama veya çok yönlü gezinti yapısında kullanılıp kullanılmadığını belirtir.Filterable, Sortable, and Facetable determine whether fields are used in a filter, sort, or faceted navigation structure.
  • Aranabilir, bir alanın tam metin aramasına dahil olduğu anlamına gelir.Searchable means that a field is included in full text search. Dizelerde arama yapılabilir.Strings are searchable. Sayısal alanlar ve Boolean alanları genellikle aranamaz olarak işaretlenir.Numeric fields and Boolean fields are often marked as not searchable.

Depolama gereksinimleri, seçiminizin sonucu olarak farklılık gösterir.Storage requirements do not vary as a result of your selection. Örneğin, birden çok alanda alınabilir özniteliğini ayarlarsanız, depolama gereksinimleri güncel değildir.For example, if you set the Retrievable attribute on multiple fields, storage requirements do not go up.

Varsayılan olarak sihirbaz tarafından anahtar alanının temeli olarak benzersiz tanımlayıcıların bulunması için veri kaynağı taranır.By default, the wizard scans the data source for unique identifiers as the basis for the key field. Dizeler alınabilir ve aranabilirolarak atanır.Strings are attributed as Retrievable and Searchable. Tamsayılar alınabilir, filtrelenebilir, sıralanabilirve çok yönlü tabloolarak atanır.Integers are attributed as Retrievable, Filterable, Sortable, and Facetable.

  1. Varsayılanları kabul edin.Accept the defaults.

    Sihirbazı ikinci kez mevcut bir oteller veri kaynağını kullanarak yeniden çalıştırırsanız, dizin varsayılan özniteliklerle yapılandırılmaz.If you rerun the wizard a second time using an existing hotels data source, the index won't be configured with default attributes. Gelecekteki içeri aktarmalardan öznitelikleri el ile seçmeniz gerekir.You'll have to manually select attributes on future imports.

    Oluşturulan oteller dizini

  2. Sonraki sayfaya devam edin.Continue to the next page.

4. adım-Dizin oluşturucuyu yapılandırmaStep 4 - Configure indexer

Verileri içeri aktarma sihirbazından çıkmadan Dizin Oluşturucu > Ad’a tıklayın ve dizin oluşturucu için bir ad yazın.Still in the Import data wizard, click Indexer > Name, and type a name for the indexer.

Bu nesne, yürütülebilir bir işlemi tanımlar.This object defines an executable process. Yinelenen bir zamanlamaya göre koyabilirsiniz, ancak şimdilik Dizin oluşturucuyu hemen çalıştırmak için varsayılan seçeneği kullanın.You could put it on recurring schedule, but for now use the default option to run the indexer once, immediately.

Dizin oluşturucuyu oluşturmak ve aynı anda çalıştırmak için Gönder ' e tıklayın.Click Submit to create and simultaneously run the indexer.

oteller Dizin Oluşturucusu

İlerlemeyi izlemeMonitor progress

Sihirbaz sizi ilerlemeyi izleyebileceğiniz Dizin oluşturucular listesine götürebilmelidir.The wizard should take you to the Indexers list where you can monitor progress. Kendi kendine gezinme için genel bakış sayfasına gidin ve Dizin oluşturucular' ye tıklayın.For self-navigation, go to the Overview page and click Indexers.

Portalın sayfayı güncelleştirmesi birkaç dakika sürebilir, ancak "devam ediyor" veya Success, "sürüyor" veya Success (Dizin oluşturulmuş belge sayısıyla birlikte) durumuyla yeni oluşturulan dizin oluşturucuyu görmeniz gerekir.It can take a few minutes for the portal to update the page, but you should see the newly created indexer in the list, with status indicating "in progress" or success, along with the number of documents indexed.

Dizin oluşturucu ilerleme durumu iletisi

Dizini görüntülemeView the index

Ana hizmet sayfası, Azure Bilişsel Arama hizmetinizde oluşturulan kaynaklara bağlantılar sağlar.The main service page provides links to the resources created in your Azure Cognitive Search service. Yeni oluşturduğunuz dizini görüntülemek için bağlantılar listesinden dizinler ' e tıklayın.To view the index you just created, click Indexes from the list of links.

Portal sayfasının yenilenmesini bekleyin.Wait for the portal page to refresh. Birkaç dakika sonra, dizini bir belge sayısı ve depolama boyutuyla görmeniz gerekir.After a few minutes, you should see the index with a document count and storage size.

Hizmet panosundaki dizinler listesi

Bu listeden, yeni oluşturduğunuz oteller-örnek dizinine tıklayabilirsiniz, Dizin şemasını görüntüleyebilirsiniz.From this list, you can click on the hotels-sample index that you just created, view the index schema. ve isteğe bağlı olarak yeni alanlar ekleyin.and optionally add new fields.

Alanlar sekmesi Dizin şemasını gösterir.The Fields tab shows the index schema. Yeni bir alan girmek için listenin en altına gidin.Scroll to the bottom of the list to enter a new field. Çoğu durumda, mevcut alanları değiştiremezsiniz.In most cases, you cannot change existing fields. Mevcut alanlar Azure Bilişsel Arama bir fiziksel gösterimine sahiptir ve bu nedenle kodda bile değil, değiştirilemeyen değildir.Existing fields have a physical representation in Azure Cognitive Search and are thus non-modifiable, not even in code. Var olan bir alanı temel olarak değiştirmek için yeni bir dizin oluşturun ve özgün olanı bırakarak.To fundamentally change an existing field, create a new index, dropping the original.

Örnek dizin tanımı

Puanlama profilleri ve CORS seçenekleri gibi diğer yapılar herhangi bir noktada eklenebilir.Other constructs, such as scoring profiles and CORS options, can be added at any time.

Dizin tasarımı sırasında düzenleme yapabileceğiniz ve yapamayacağınız alanları kavramak için birkaç dakikanızı ayırarak dizin tanımı seçeneklerini görüntüleyin.To clearly understand what you can and cannot edit during index design, take a minute to view index definition options. Gri renkli seçenekler, bir değerin değiştirme veya silme işlemleri için uygun olmadığını gösterir.Grayed-out options are an indicator that a value cannot be modified or deleted.

Arama Gezgini 'ni kullanarak sorgulamaQuery using Search explorer

Artık yerleşik Arama gezgini sorgu sayfasını kullanarak sorgulayabileceğiniz bir arama dizinine sahipsiniz.Moving forward, you should now have a search index that's ready to query using the built-in Search explorer query page. Bu sayfada rastgele sorgu dizelerini test etmek için kullanabileceğiniz bir arama kutusu bulunur.It provides a search box so that you can test arbitrary query strings.

Arama Gezgini yalnızca REST API istekleriniişleyecek şekilde donatılmış, ancak hem basit sorgu söz dizimi hem de tam Lucene sorgu ayrıştırıcısıiçin sözdizimi kabul eder, ayrıca arama belgesinde bulunan tüm arama parametreleri de kullanılabilir REST API operasyonları.Search explorer is only equipped to handle REST API requests, but it accepts syntax for both simple query syntax and full Lucene query parser, plus all the search parameters available in Search Document REST API operations.

İpucu

Aşağıdaki adımlar, 6m08s ' de Azure bilişsel arama genel bakış videosu ' negösterilmiştir.The following steps are demonstrated at 6m08s into the Azure Cognitive Search Overview video.

  1. Komut çubuğunda Arama gezgini'ne tıklayın.Click Search explorer on the command bar.

    Search gezgini komutu

  2. Dizin açılan listesinden oteller-örnek-dizin' i seçin.From the Index dropdown, choose hotels-sample-index. Hangi REST API 'Lerinin kullanılabilir olduğunu görmek için API sürümü açılan listesine tıklayın.Click the API Version dropdown, to see which REST APIs are available. Aşağıdaki sorgular için genel kullanıma sunulan sürümü (2019-05-06) kullanın.For the queries below, use the generally available version (2019-05-06).

    Dizin ve API komutları

  3. Arama çubuğunda, aşağıdaki sorgu dizelerini yapıştırın ve Ara' ya tıklayın.In the search bar, paste in the query strings below and click Search.

    Sorgu dizesi ve arama düğmesi

Örnek sorgularExample queries

Bing veya Google aramasında yapabileceklerinize benzer şekilde hüküm ve ifadeler girebilir veya tam olarak belirtilen sorgu ifadeleriyle karşılaşabilirsiniz.You can enter terms and phrases, similar to what you might do in a Bing or Google search, or fully-specified query expressions. Sonuçlar ayrıntılı JSON belgeleri olarak döndürülür.Results are returned as verbose JSON documents.

İlk N sonucu içeren basit sorguSimple query with top N results

Örnek (dize sorgusu): search=spaExample (string query): search=spa

  • Arama parametresi, tam metin araması için bir anahtar sözcük arama girişi yapmak için kullanılır, bu durumda, belgedeki aranabilir herhangi bir alanda Spa 'yı içeren kişiler için otel verileri döndürür.The search parameter is used to input a keyword search for full text search, in this case, returning hotel data for those containing spa in any searchable field in the document.

  • Search gezgini sonuçları JSON biçiminde döndürülür. Bu biçim ayrıntılı olmakla birlikte, belgelerin yoğun bir yapısı varsa okunması zordur.Search explorer returns results in JSON, which is verbose and hard to read if documents have a dense structure. Bu bilerek yapılır; belgenin tamamına ilişkin görünürlük, özellikle test sırasında geliştirme amaçlarıyla önemlidir.This is intentional; visibility into the entire document is important for development purposes, especially during testing. Daha iyi bir kullanıcı deneyimi sunmak için arama sonuçlarını işleyerek önemli öğeleri öne çıkaran bir kod yazmanız gerekir.For a better user experience, you will need to write code that handles search results to bring out important elements.

  • Belgeler, dizinde "alınabilir" olarak işaretlenmiş tüm alanlardan oluşur.Documents are composed of all fields marked as "retrievable" in the index. Portalda Dizin özniteliklerini görüntülemek için, dizinler listesinde oteller-Sample ' a tıklayın.To view index attributes in the portal, click hotels-sample in the Indexes list.

Örnek (parametreli sorgu): search=spa&$count=true&$top=10Example (parameterized query): search=spa&$count=true&$top=10

  • & simgesi, herhangi bir sırada belirtilebilen arama parametreleri eklemek için kullanılır.The & symbol is used to append search parameters, which can be specified in any order.

  • $Count = true parametresi, döndürülen tüm belgelerin toplam sayısını döndürür.The $count=true parameter returns the total count of all documents returned. Bu değer arama sonuçlarının en üstüne yakın bir konumda görünür.This value appears near the top of the search results. $count=true tarafından bildirilen değişiklikleri izleyerek filtre sorgularını doğrulayabilirsiniz.You can verify filter queries by monitoring changes reported by $count=true. Daha küçük sayılar filtrenizin çalıştığını gösterir.Smaller counts indicate your filter is working.

  • $Top = 10 , toplamda en yüksek dereceli 10 belgeyi döndürür.The $top=10 returns the highest ranked 10 documents out of the total. Varsayılan olarak, Azure Bilişsel Arama en iyi 50 eşleşme döndürür.By default, Azure Cognitive Search returns the first 50 best matches. $top ile bu miktarı artırabilir veya azaltabilirsiniz.You can increase or decrease the amount via $top.

Sorguyu filtrelemeFilter the query

$filter parametresini eklediğinizde, arama isteklerine filtreler de eklenir.Filters are included in search requests when you append the $filter parameter.

Örnek (filtrelenmiş): search=beach&$filter=Rating gt 4Example (filtered): search=beach&$filter=Rating gt 4

  • $filter parametresi, sağladığınız ölçütlerle eşleşen sonuçları döndürür.The $filter parameter returns results matching the criteria you provided. Bu durumda, 4 ' ten büyük derecelendirmeler.In this case, ratings greater than 4.

  • Filtre söz dizimi bir OData yapısıdır.Filter syntax is an OData construction. Daha fazla bilgi edinmek için bkz. OData söz dizimini filtreleme.For more information, see Filter OData syntax.

Sorguyu modellemeFacet the query

Model filtreleri arama isteklerine dahil edilir.Facet filters are included in search requests. Sağladığınız model değeriyle eşleşen belgelerin toplam sayısını döndürmek için facet parametresini kullanabilirsiniz.You can use the facet parameter to return an aggregated count of documents that match a facet value you provide.

Örnek (kapsamı azaltılarak modellenmiş): search=*&facet=Category&$top=2Example (faceted with scope reduction): search=*&facet=Category&$top=2

  • search= * boş bir aramadır.search=* is an empty search. Boş aramalar her şeyi arar.Empty searches search over everything. Boş sorgu göndermenin nedenlerinden biri, belge kümesinin tamamını filtrelemek veya görüntülemektir.One reason for submitting an empty query is to filter or facet over the complete set of documents. Örneğin, dizin içindeki tüm otellerden oluşan bir gezinti yapısının olmasını istersiniz.For example, you want a faceting navigation structure to consist of all hotels in the index.

  • facet, bir kullanıcı arabirimi denetimine geçirebileceğiniz bir gezinti yapısı döndürür.facet returns a navigation structure that you can pass to a UI control. Kategorileri ve bir sayımı döndürür.It returns categories and a count. Bu durumda, kategoriler Kategoriolarak adlandırılan bir alanı temel alır.In this case, categories are based on a field conveniently called Category. Azure Bilişsel Arama 'de toplama yoktur, ancak her kategoride belge sayısı sağlayan facetaracılığıyla toplamayı yaklaşık olarak görebilirsiniz.There is no aggregation in Azure Cognitive Search, but you can approximate aggregation via facet, which gives a count of documents in each category.

  • $top=2 iki belge getirir ve sonuçları azaltmak veya artırmak için top kullanabileceğinizi gösterir.$top=2 brings back two documents, illustrating that you can use top to both reduce or increase results.

Örnek (sayısal değerler için model): search=spa&facet=RatingExample (facet on numeric values): search=spa&facet=Rating

  • Bu sorgu, Spa'nın metin aramasında derecelendirme için bir model.This query is facet for rating, on a text search for spa. Alan, dizinde alınabilir, filtrelenebilir ve çok yönlü tablo olarak işaretlendiğinden ve içerdiği değerler (sayısal, 1 ' den 5 ' e kadar), listelerin gruplar halinde kategorilere ayrılması için uygundur.The term Rating can be specified as a facet because the field is marked as retrievable, filterable, and facetable in the index, and the values it contains (numeric, 1 through 5), are suitable for categorizing listings into groups.

  • Yalnızca filtrelenebilir alanlardan görünüm oluşturulabilir.Only filterable fields can be faceted. Yalnızca getirilebilir alanlar sonuçlarda döndürülebilir.Only retrievable fields can be returned in the results.

  • Derecelendirme alanı çift duyarlıklı kayan nokta ve gruplama kesin değere göre yapılır.The Rating field is double-precision floating point and the grouping will be by precise value. Aralığa göre gruplandırma hakkında daha fazla bilgi için (örneğin, "3 yıldız derecelendirmesi," "4 yıldız derecelendirmesi" vb.), bkz. Azure bilişsel arama 'da çok yönlü gezintiyi uygulama.For more information on grouping by interval (for instance, "3 star ratings," "4 star ratings," etc.), see How to implement faceted navigation in Azure Cognitive Search.

Arama sonuçlarını vurgulamaHighlight search results

İsabet vurgulama, belirli bir alanda eşleşme bulunduğunda anahtar sözcükle eşleşen metinlere biçimlendirme eklenmesini ifade eder.Hit highlighting refers to formatting on text matching the keyword, given matches are found in a specific field. Arama teriminiz uzun bir açıklamanın belirsiz bir yerindeyse, terimi bulmayı kolaylaştırmak için isabet vurgulama ekleyebilirsiniz.If your search term is deeply buried in a description, you can add hit highlighting to make it easier to spot.

Örnek (vurgulama): search=beach&highlight=DescriptionExample (highlighter): search=beach&highlight=Description

  • Bu örnekte, biçimlendirilen sözcük plaj , açıklama alanında daha kolay olacak.In this example, the formatted word beach is easier to spot in the description field.

Örnek (dilbilimsel analiz): search=beaches&highlight=DescriptionExample (linguistic analysis): search=beaches&highlight=Description

  • Tam metin araması, Word formlarında temel çeşitlemeleri tanır.Full text search recognizes basic variations in word forms. Bu durumda, arama sonuçları "plaj" için vurgulanmış metni, bu sözcüğü "Güzeller" üzerinde bir anahtar sözcük aramasına yanıt olarak, bu sözcüğe sahip olan oteller için "plaj" için vurgulanmış metni içerir.In this case, search results contain highlighted text for "beach", for hotels that have that word in their searchable fields, in response to a keyword search on "beaches". Dilbilimsel analiz nedeniyle sonuçlarda aynı kelimenin farklı biçimleri görüntülenebilir.Different forms of the same word can appear in results because of linguistic analysis.

  • Azure Bilişsel Arama, Lucene ve Microsoft 'tan 56 Çözümleyicileri destekler.Azure Cognitive Search supports 56 analyzers from both Lucene and Microsoft. Azure Bilişsel Arama tarafından kullanılan varsayılan değer standart Lucene çözümleyicisidir.The default used by Azure Cognitive Search is the standard Lucene analyzer.

Varsayılan olarak, "Seattle" için Seatle gibi yanlış yazılmış sorgu terimleri, tipik aramada eşleşmeleri döndürmeyebilir.By default, misspelled query terms, like seatle for "Seattle", fail to return matches in typical search. Aşağıdaki örnek sonuç döndürmez.The following example returns no results.

Örnek (yanlış yazılmış terim, işlenmiyor): search=seatleExample (misspelled term, unhandled): search=seatle

Yazım hatalarını işlemek için belirsiz aramayı kullanabilirsiniz.To handle misspellings, you can use fuzzy search. Belirsiz arama, tam Lucene sorgu söz dizimini kullandığınızda etkinleştirilir ve bunun için yapmanız gereken iki işlem vardır: sorguda queryType=full belirtin ve arama sorgusunun sonuna ~ ekleyin.Fuzzy search is enabled when you use the full Lucene query syntax, which occurs when you do two things: set queryType=full on the query, and append the ~ to the search string.

Örnek (yanlış yazılmış terim, işleniyor): search=seatle~&queryType=fullExample (misspelled term, handled): search=seatle~&queryType=full

Bu örnek şimdi "Seattle" ile eşleşmeleri içeren belgeleri geri döndürüyor.This example now returns documents that include matches on "Seattle".

queryType belirtildiğinde varsayılan basit sorgu ayrıştırıcı kullanılır.When queryType is unspecified, the default simple query parser is used. Basit sorgu ayrıştırıcı daha hızlıdır ancak belirsiz arama, normal ifadeler, yakınlık araması ya da diğer gelişmiş sorgu türlerini kullanmanız gerekiyorsa tam söz dizimi gereklidir.The simple query parser is faster, but if you require fuzzy search, regular expressions, proximity search, or other advanced query types, you will need the full syntax.

Belirsiz arama ve joker karakter araması, arama sonucunu etkiler.Fuzzy search and wildcard search have implications on search output. Bu sorgu biçimlerinde dilbilimsel analiz gerçekleştirilmez.Linguistic analysis is not performed on these query formats. Benzer ve joker karakter aramasını kullanmadan önce, tam metin aramasının Azure bilişsel arama 'de nasıl çalıştığını gözden geçirin ve sözcük temelli analize yönelik özel durumlar hakkındaki bölümü bulun.Before using fuzzy and wildcard search, review How full text search works in Azure Cognitive Search and look for the section about exceptions to lexical analysis.

Tam sorgu ayrıştırıcısı tarafından etkinleştirilen sorgu senaryoları hakkında daha fazla bilgi için bkz. Azure bilişsel arama 'de Lucene sorgu söz dizimi.For more information about query scenarios enabled by the full query parser, see Lucene query syntax in Azure Cognitive Search.

Koordinat içeren bir alanda edm.GeographyPoint veri türü aracılığıyla jeo-uzamsal arama desteklenir.Geospatial search is supported through the edm.GeographyPoint data type on a field containing coordinates. Coğrafi arama, OData söz dizimini filtrele seçeneğinde belirtilen bir tür filtredir.Geosearch is a type of filter, specified in Filter OData syntax.

Örnek (coğrafi koordinat filtreleri): search=*&$count=true&$filter=geo.distance(Location,geography'POINT(-122.12 47.67)') le 5Example (geo-coordinate filters): search=*&$count=true&$filter=geo.distance(Location,geography'POINT(-122.12 47.67)') le 5

Örnek sorgu tüm sonuçları konumsal verilere göre filtreler ve belirli bir noktaya 5 kilometreden daha yakın olan sonuçlar (enlem ve boylam koordinatları olarak belirtilir) döndürülür.The example query filters all results for positional data, where results are less than 5 kilometers from a given point (specified as latitude and longitude coordinates). $count ekleyerek mesafeyi veya koordinatları değiştirdiğinizde döndürülen sonuç sayısını görebilirsiniz.By adding $count, you can see how many results are returned when you change either the distance or the coordinates.

Arama uygulamanız "yakınımda bul" özelliği içeriyorsa ya da harita navigasyonu kullanıyorsa jeo-uzamsal arama kullanışlıdır.Geospatial search is useful if your search application has a "find near me" feature or uses map navigation. Ancak tam metin arama değildir.It is not full text search, however. Ada göre şehir veya ülke/bölge aramak için Kullanıcı gereksinimleriniz varsa, koordinatlara ek olarak şehir veya ülke/bölge adlarını içeren alanları ekleyin.If you have user requirements for searching on a city or country/region by name, add fields containing city or country/region names, in addition to coordinates.

PaketlerTakeaways

Bu öğretici, Azure Bilişsel Arama Azure portal kullanılarak hızlı bir giriş sağlamıştır.This tutorial provided a quick introduction to Azure Cognitive Search using the Azure portal.

Verileri içeri aktar sihirbazını kullanarak arama dizini oluşturmayı öğrendiniz.You learned how to create a search index using the Import data wizard. Dizin oluşturucuların yanı sıra yayımlanmış dizinler için desteklenen değişiklikler gibi dizin tasarımıyla ilgili temel iş akışı hakkında bilgi edindiniz.You learned about indexers, as well as the basic workflow for index design, including supported modifications to a published index.

Azure portalda Arama gezginini kullanarak filtreler, sonuç vurgulama, belirsiz arama ve coğrafi arama gibi önemli özelliklerin gösterildiği örneklerle temel sorgu söz dizimini öğrendiniz.Using the Search explorer in the Azure portal, you learned some basic query syntax through hands-on examples that demonstrated key capabilities such as filters, hit highlighting, fuzzy search, and geo-search.

Ayrıca, portalda Dizin, Dizin oluşturucular ve veri kaynaklarını bulmayı de öğrendiniz.You also learned how to find indexes, indexers, and data sources in the portal. Gelecekte yeni verilerle karşılaştığınızda portalı kullanarak tanımlarını veya alan koleksiyonlarını hızlı bir şekilde denetleyebilirsiniz.Given any new data source in the future, you can use the portal to quickly check its definitions or field collections with minimal effort.

TemizlemeClean up

Kendi aboneliğinizde çalışırken, sizin oluşturduğunuz kaynaklara hala ihtiyacınız olup olmadığını belirlemek için bir projenin sonunda iyi bir fikir olur.When you're working in your own subscription, it's a good idea at the end of a project to identify whether you still need the resources you created. Çalışan kaynaklar sizin için ücret verebilir.Resources left running can cost you money. Kaynakları tek tek silebilir veya kaynak grubunu silerek tüm kaynak kümesini silebilirsiniz.You can delete resources individually or delete the resource group to delete the entire set of resources.

Sol gezinti bölmesindeki tüm kaynaklar veya kaynak grupları bağlantısını kullanarak portalda kaynakları bulabilir ve yönetebilirsiniz.You can find and manage resources in the portal, using the All resources or Resource groups link in the left-navigation pane.

Ücretsiz bir hizmet kullanıyorsanız, üç Dizin, Dizin Oluşturucu ve veri kaynağı ile sınırlı olduğunu unutmayın.If you are using a free service, remember that you are limited to three indexes, indexers, and data sources. Sınırın altında kalmak için portalda ayrı ayrı öğeleri silebilirsiniz.You can delete individual items in the portal to stay under the limit.

Sonraki adımlarNext steps

Programlama araçlarını kullanarak Azure Bilişsel Arama fazlasını inceleyebilirsiniz:You can explore more of Azure Cognitive Search using the programmatic tools: