Skip to content

Commit 80c6331

Browse files
committed
other edits
1 parent 7892a0e commit 80c6331

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

articles/search/search-how-to-create-search-index.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -20,17 +20,13 @@ Unless you are using an [indexer](search-howto-create-indexers.md), creating an
2020

2121
## Prerequisites
2222

23-
Write permissions on the search service are required for creating and loading indexes. Most operations will require that you provide an [admin API key](search-security-api-keys.md) on the create index request. Alternatively, if you're participating in the Azure Active Directory [role-based access control public preview](search-security-rbac.md), you can issue your request as a member of the Search Contributor role.
23+
Write permissions are required for creating and loading indexes, granted through an [admin API key](search-security-api-keys.md) on the request. Alternatively, if you're participating in the Azure Active Directory [role-based access control public preview](search-security-rbac.md), you can issue your request as a member of the Search Contributor role.
2424

2525
Index creation is largely a schema definition exercise. Before creating one, you should have:
2626

27-
+ A clear idea of which fields you want to make searchable, retrievable, filterable, facetable, and sortable in your index.
27+
+ A clear idea of which fields you want to make searchable, retrievable, filterable, facetable, and sortable in your index (discussed in [schema checklist](#schema-checklist)).
2828

29-
The [field attribute assignments](search-what-is-an-index.md#index-attributes) will determine both search behaviors, and the physical representation of your index on the search service. During design and development, start with sample data so that you can drop and rebuild the index easily as you finalize field attribution.
30-
31-
+ A source field that uniquely identifies each row, record, or item in the source data. For example, if you're indexing from Blob Storage, the storage path is often used as the document key.
32-
33-
Every index requires one field that serves as the *document key* (sometimes referred to as the "document ID"), and this key is mapped to a source field containing a unique identifier. The ability to uniquely identify specific search documents is required for retrieving a specific document in the search index, and for selective data processing at the per-document level.
29+
+ A single source field that uniquely identifies each row, record, or item in the source data, to be used as the document key (or ID) in the index. For example, if you're indexing from Blob Storage, the storage path is often used as the document key.
3430

3531
+ Index location. Moving an existing index to a different search service is not supported out-of-the-box. Revisit application requirements and make sure the existing search service, its capacity and location, are sufficient for your needs.
3632

@@ -64,12 +60,16 @@ Use this checklist to help drive the design decisions for your search index.
6460

6561
1. Review [naming conventions](/rest/api/searchservice/naming-rules) so that index and field names conform to the naming rules.
6662

67-
1. Review [supported data types](/rest/api/searchservice/supported-data-types). The data type will impact how the field is used. For example, numeric content is filterable but not full text searchable.
63+
1. Review [supported data types](/rest/api/searchservice/supported-data-types). The data type will impact how the field is used. For example, numeric content is filterable but not full text searchable. The most common data type is `Edm.String` for searchable text, which is tokenized and queried using the full text search engine.
6864

69-
1. Identify one field in the source data that contains unique values, allowing it to function as the key field in your index.
65+
1. Identify one field in the source data that contains unique values, allowing it to function as the key field in your index.
66+
67+
Every index requires one field that serves as the *document key* (sometimes referred to as the "document ID"). The key should be mapped to the unique identifier in your source data. The ability to uniquely identify specific search documents is required for retrieving a specific document in the search index, and for selective data processing at the per-document level.
7068

7169
1. Identify the fields in your data source that will contribute searchable content in the index. Searchable content includes short or long strings that are queried using the full text search engine. If the content is verbose (small phrases or bigger chunks), experiment with different analyzers to see how the text is tokenized.
7270

71+
[Field attribute assignments](search-what-is-an-index.md#index-attributes) will determine both search behaviors and the physical representation of your index on the search service. Determining how fields should be specified is an iterative process for many customers. To speed up iterations, start with sample data so that you can drop and rebuild easily.
72+
7373
1. Identify which source fields can be used as filters. Numeric content and short text fields, particularly those with repeating values, are good choices. When working with filters, remember:
7474

7575
+ Filterable fields can optionally be used in faceted navigation.

0 commit comments

Comments
 (0)