Portalda Azure Bilişsel Arama dizini oluşturmaCreate an Azure Cognitive Search index in the portal

Azure Bilişsel Arama, Portal 'daki yerleşik bir dizin tasarımcısını, Prototiplerde faydalı olan veya Azure Bilişsel Arama hizmetinizde barındırılan bir arama dizini oluşturmak için içerir.Azure Cognitive Search includes a built-in index designer in the portal useful for prototypes or creating a search index hosted on your Azure Cognitive Search service. Araç, şema oluşturma için kullanılır.The tool is used for schema construction. Tanımı kaydettiğinizde, Azure Bilişsel Arama 'de boş bir dizin tam olarak ifade edilir.When you save the definition, an empty index becomes fully expressed in Azure Cognitive Search. Aranabilir içerik ile nasıl yüklenir?How you load it with searchable content is up to you.

Dizin Tasarımcısı dizin oluşturmak için yalnızca bir yaklaşımdır.The index designer is only one approach for creating an index. Alternatif olarak, verileri Içeri aktarma sihirbazınıkullanarak bir dizin oluşturup yükleyebilirsiniz.Alternatively, you can both create and load an index using the Import data wizard. Sihirbaz yalnızca kendi oluşturduğu dizinlerde çalışmaktadır.The wizard only works with indexes that it creates itself. Programlama yoluyla, .net veya rest API 'lerini kullanarak bir dizin oluşturabilirsiniz.Programmatically, you can create an index using the .NET or REST APIs.

Dizin tasarımcısını BaşlatStart index designer

  1. Azure portalında oturum açın ve hizmet panosunu açın.Sign in to the Azure portal and open the service dashboard. Atlama çubuğundaki Tüm hizmetler’e tıklayarak geçerli abonelikteki mevcut "arama hizmetleri" için arama yapabilirsiniz.You can click All services in the jump bar to search for existing "search services" in the current subscription.

  2. Sayfanın en üstündeki komut çubuğunda Dizin Ekle bağlantısına tıklayın.Click the Add index link in the command bar at the top of the page.

    Komut çubuğunda Dizin bağlantısı ekleAdd index link in the command bar

  3. Azure Bilişsel Arama dizininizi adlandırın.Name your Azure Cognitive Search index. Dizin adlarına dizin oluşturma ve sorgu işlemlerinde başvurulur.Index names are referenced in indexing and query operations. Dizin adı, dizine bağlantılarda ve Azure Bilişsel Arama REST API HTTP istekleri göndermek için kullanılan uç nokta URL 'sinin bir parçası haline gelir.The index name becomes part of the endpoint URL used on connections to the index and for sending HTTP requests in the Azure Cognitive Search REST API.

    • En başta bir harf kullanın.Start with a letter.
    • Yalnızca küçük harfleri, rakamları veya kısa çizgileri ("-") kullanın.Use only lowercase letters, digits, or dashes ("-").
    • Adı 60 karakterle sınırlayın.Limit the name to 60 characters.

Alan EkleAdd fields

Dizin oluşturma, dizininizdeki aranabilir verileri tanımlayan bir Alanlar koleksiyonunu içerir.Index composition includes a Fields collection that defines the searchable data in your index. Tamamen, alanlar koleksiyonu ayrı olarak karşıya yüklediğiniz belgelerin yapısını belirler.Altogether, the fields collection specifies the structure of documents that you upload separately. Alanlar koleksiyonu, alanın nasıl kullanılabileceğini belirleyecek dizin öznitelikleri ile adlandırılmış ve yazılan isteğe bağlı alanları içerir.A Fields collection includes required and optional fields, named and typed, with index attributes that determine how the field can be used.

  1. Karşıya yükleyeceğiniz belgeleri tam olarak belirtmek için alanlar ekleyin, her biri için bir veri türü belirleyin.Add fields to fully specify the documents you will upload, setting a data type for each one. Örneğin, belgeler bir otel kimliği, otel adı, Adres, şehirve bölgeiçeriyorsa, dizindeki her biri için karşılık gelen bir alan oluşturun.For example, if documents consist of a hotel-id, hotel-name, address, city, and region, create a corresponding field for each one in the index. Öznitelikleri ayarlamayla ilgili yardım için aşağıdaki bölümde yer alarak bulunan tasarım kılavuzunu gözden geçirin.Review the design guidance in the section below for help with setting attributes.

  2. Gelen veriler doğası halinde hiyerarşik ise, şemanız iç içe yapıları temsil etmek için karmaşık türler içermelidir.If incoming data is hierarchical in nature, your schema should include complex types to represent the nested structures. Yerleşik örnek veri kümesi olan oteller, her bir otelle bire bir ilişkiye sahip olan ve her bir otel ile birden çok oda ilişkilendirildiği bir oda karmaşık koleksiyonu olan bir adres (birden çok alt alan içerir) kullanan karmaşık türleri gösterir.The built-in sample data set, Hotels, illustrates complex types using an Address (contains multiple sub-fields) that has a one-to-one relationship with each hotel, and a Rooms complex collection, where multiple rooms are associated with each hotel.

  3. EDM. String türünde bir anahtar alanı belirtin.Specify a key field of type Edm.String. Her Azure Bilişsel Arama dizini için bir anahtar alanı zorunludur ve bir dize olmalıdır.A key field is mandatory for every Azure Cognitive Search index and it must be a string. Bu alanın değerleri her belgeyi benzersiz şekilde tanımlamalıdır.Values for this field must uniquely identify each document. Varsayılan olarak alan, id olarak adlandırılır, ancak adlandırma kurallarına uygun şekilde alanı yeniden adlandırabilirsiniz.By default, the field is named id but you can rename it as long as the string satisfies naming rules. Örneğin, alanlar koleksiyonunuz otel kimliğiiçeriyorsa, anahtarınız için bunu seçersiniz.For example, if your fields collection includes hotel-id, you would choose that for your key.

  4. Her bir alanda öznitelikleri ayarlayın.Set attributes on each field. Dizin Tasarımcısı, veri türü için geçersiz olan tüm öznitelikleri dışlar, ancak nelerin ekleneceğini tavsiye etmez.The index designer excludes any attributes that are invalid for the data type, but doesn't suggest what to include. Özniteliklerin ne için olduğunu anlamak için sonraki bölümde yer alarak bulunan Kılavuzu gözden geçirin.Review the guidance in the next section to understand what the attributes are for.

    Azure Bilişsel Arama API belgeleri, basit bir oteller dizini içeren kod örnekleri içerir.Azure Cognitive Search API documentation includes code examples featuring a simple hotels index. Aşağıdaki ekran görüntüsünde, Dizin tanımı sırasında belirtilen Fransızca dil Çözümleyicisi de dahil olmak üzere dizin tanımını görebilirsiniz. Bu, portalda alıştırma olarak yeniden oluşturabilirsiniz.In the screenshot below, you can see the index definition, including the French language analyzer specified during index definition, which you can recreate as a practice exercise in the portal.

    Oteller tanıtım diziniHotels demo index

  5. İşiniz bittiğinde, dizini kaydetmek ve oluşturmak için Oluştur ' a tıklayın.When finished, click Create to save and create the index.

Öznitelikleri ayarlaSet attributes

İstediğiniz zaman yeni alanlar ekleyebilseniz de, dizinin ömrü boyunca mevcut alan tanımları kilitlenir.Although you can add new fields at any time, existing field definitions are locked in for the lifetime of the index. Bu nedenle geliştiriciler genellikle basit dizinler oluşturmak, fikirleri test etmek veya portal sayfalarını kullanarak bir ayarı bulmak için portalı kullanır.For this reason, developers typically use the portal for creating simple indexes, testing ideas, or using the portal pages to look up a setting. Dizini kolayca yeniden derleyebilmeniz için kod tabanlı bir yaklaşım izlerseniz, bir dizin tasarımı çerçevesinde sık sık yapılan yineleme daha verimli olur.Frequent iteration over an index design is more efficient if you follow a code-based approach so that you can rebuild the index easily.

Dizin kaydedilmeden önce çözümleyiciler ve öneri araçları alanlarla ilişkilendirilir.Analyzers and suggesters are associated with fields before the index is saved. Siz oluştururken Dizin tanımınıza dil Çözümleyicileri veya öneri araçları eklediğinizden emin olun.Be sure to add language analyzers or suggesters to your index definition while you are creating it.

Dize alanları genellikle Aranabilir ve Alınabilir olarak işaretlenir.String fields are often marked as Searchable and Retrievable. Arama sonuçlarını daraltmak için kullanılan alanlar arasında Sıralanabilir, Filtrelenebilir ve Modellenebilir alanları yer alır.Fields used to narrow search results include Sortable, Filterable, and Facetable.

Alan öznitelikleri, bir alanın nasıl kullanıldığını; örneğin, tam metin alanında mı, çok yönlü gezinmede mi, sıralama işlemlerinde vb.’de mi kullanılıp kullanılmayacağı belirler.Field attributes determine how a field is used, such as whether it is used in full text search, faceted navigation, sort operations, and so forth. Aşağıdaki tabloda her bir öznitelik açıklanmaktadır.The following table describes each attribute.

ÖznitelikAttribute AçıklamaDescription
aranabilirsearchable Tam metin aranabilir, dizin oluşturma sırasında sözcüklere bölme gibi sözcük temelli analize tabidir.Full-text searchable, subject to lexical analysis such as word-breaking during indexing. Aranabilir bir alanı, "güneşli gün" gibi bir değere ayarlarsanız, dahili olarak bu "güneşli" ve "gün" belirteçlerine bölünür.If you set a searchable field to a value like "sunny day", internally it will be split into the individual tokens "sunny" and "day". Ayrıntılar için bkz. Tam metin araması nasıl çalışır?For details, see How full text search works.
filtrelenebilirfilterable $filter sorgularında başvurulur.Referenced in $filter queries. Edm.String veya Collection(Edm.String) türünde filtrelenebilir alanlara sözcüklere bölme işlemi uygulanmaz, bu nedenle karşılaştırmalar yalnızca tam eşleşmeler içindir.Filterable fields of type Edm.String or Collection(Edm.String) do not undergo word-breaking, so comparisons are for exact matches only. Örneğin, böyle bir alanı "güneşli gün" olarak ayarlarsanız $filter=f eq 'sunny' herhangi bir eşleşme bulmaz, ancak $filter=f eq 'sunny day' bulur.For example, if you set such a field f to "sunny day", $filter=f eq 'sunny' will find no matches, but $filter=f eq 'sunny day' will.
sıralanabilirsortable Varsayılan olarak sistem sonuçları puana göre sıralar, ancak belgelerdeki alanlara göre sıralamayı yapılandırabilirsiniz.By default the system sorts results by score, but you can configure sort based on fields in the documents. Collection(Edm.String) türünde alanlar sıralanabilir olamaz.Fields of type Collection(Edm.String) cannot be sortable.
modellenebilirfacetable Genellikle kategoriye göre (örneğin, belirli bir şehirdeki oteller) isabet sayısını içeren bir arama sonuçları sunumunda kullanılır.Typically used in a presentation of search results that includes a hit count by category (for example, hotels in a specific city). Bu seçenek, Edm.GeographyPoint türünde alanlarla kullanılamaz.This option cannot be used with fields of type Edm.GeographyPoint. Edm.StringFiltrelenebilir , sıralanabilirveyamodellenebilirolan türünde alanlar en fazla 32 kilobayt uzunluğunda olabilir.Fields of type Edm.String that are filterable, sortable, or facetable can be at most 32 kilobytes in length. Ayrıntılar için bkz. Dizin Oluşturma (REST API’si).For details, see Create Index (REST API).
anahtarkey Dizin içindeki belgeler için benzersiz tanımlayıcı.Unique identifier for documents within the index. Anahtar alan olarak tam olarak bir alan seçilmeli ve Edm.String türünde olmalıdır.Exactly one field must be chosen as the key field and it must be of type Edm.String.
alınabilirretrievable Alanın bir arama sonucunda döndürülüp döndürülemeyeceğini belirler.Determines whether the field can be returned in a search result. Filtre, sıralama veya puanlama mekanizması olarak bir alanı (örn. kâr marjı) kullanmak istediğinizde, ancak alanın son kullanıcıya görünür olmasını istemediğinizde bu faydalıdır.This is useful when you want to use a field (such as profit margin) as a filter, sorting, or scoring mechanism, but do not want the field to be visible to the end user. Bu öznitelik, true alanları için key olmalıdır.This attribute must be true for key fields.

Sonraki adımlarNext steps

Bir Azure Bilişsel Arama dizini oluşturduktan sonra bir sonraki adıma geçebilirsiniz: aranabilir verileri dizine yükleyin.After creating an Azure Cognitive Search index, you can move to the next step: upload searchable data into the index.

Alternatif olarak, dizinlere daha ayrıntılı bir bakışda alabilirsiniz.Alternatively, you could also take a deeper look at indexes. Alanlar koleksiyonuna ek olarak bir dizin, çözümleyicileri, öneri araçlarını, puanlama profillerini ve CORS ayarlarını da belirtir.In addition to the Fields collection, an index also specifies analyzers, suggesters, scoring profiles, and CORS settings. Portal, en yaygın öğeleri tanımlamak için sekmeli sayfalar sağlar: Alanlar, çözümleyiciler ve öneri araçları.The portal provides tabbed pages for defining the most common elements: Fields, analyzers, and suggesters. Başka öğeler oluşturmak veya değiştirmek için REST API’sini veya .NET SDK’sını kullanabilirsiniz.To create or modify other elements, you can use the REST API or .NET SDK.

Ayrıca bkz.See also

Tam metin araması nasıl çalışır?How full text search works
Arama hizmeti REST API’si .NET SDK’sıSearch service REST API .NET SDK