You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/search/search-how-to-create-search-index.md
+10-9Lines changed: 10 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,9 +24,9 @@ Write permissions on the search service are required for creating and loading in
24
24
25
25
Index creation is largely a schema definition exercise. Before creating one, you should have:
26
26
27
-
+ A clear idea of which fields you want to make searchable, retrievable, filterable, 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.
28
28
29
-
The attributes you assign to fields will determine its physical storage structure 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.
29
+
The [field attribute assignments](search-what-is-an-index.md#index-attributes) will determine its physical storage structure 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
30
31
31
+ A source field that uniquely identifies each row, record, or item in the source data. If you're indexing from Blob Storage, the storage path is often used as the document key.
32
32
@@ -38,7 +38,7 @@ Finally, all service tiers have [index limits](search-limits-quotas-capacity.md#
38
38
39
39
## Allowed updates
40
40
41
-
[Create Index](/rest/api/searchservice/create-index) is an operation that creates physical data structures (files and inverted indexes) on your search service. Your ability to update an index is contingent upon whether the modification invalidates those physical structures. Most field attributes can't be changed once the field is created in your index.
41
+
[Create Index](/rest/api/searchservice/create-index) is an operation that creates physical data structures (files and inverted indexes) on your search service. Your ability to effect changes using [Update Index](/rest/api/searchservice/update-index) is contingent upon whether the modification invalidates those physical structures. Most field attributes can't be changed once the field is created in your index.
42
42
43
43
To minimize churn in the design process, the following table describes which elements are fixed and flexible in the schema. Changing a fixed element requires an index rebuild, whereas flexible elements can be changed at any time without impacting the physical implementation.
44
44
@@ -60,20 +60,21 @@ To minimize churn in the design process, the following table describes which ele
60
60
61
61
## Schema checklist
62
62
63
-
Use this checklist to help drive design decisions for your search index.
63
+
Use this checklist to help drive the design decisions for your search index.
64
64
65
65
1. Review [naming conventions](/rest/api/searchservice/naming-rules) so that index and field names conform to the naming rules.
66
66
67
-
1. Review [supported data types](/rest/api/searchservice/supported-data-types). Data type will impact how the field is used. For example, numeric content is filterable but not full text searchable.
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.
68
68
69
-
1. Identify one field in the data source that will be used as the key field in your index.
69
+
1. Identify one field in the data source that contains unique values, allowing it to function as the key field in your index.
70
70
71
-
1. Identify which source fields have searchable content. If the content is text and verbose (phrases or longer), experiment with different analyzers to see how the text is tokenized.
71
+
1. Identify the fields in your data source that can contribute searchable content in the index. Searchable content are 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.
72
72
73
73
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:
74
74
75
-
+ Filterable fields can optionally be used in faceted navigation.
76
-
+ Filterable fields are returned in arbitrary order, so consider making them sortable as well.
75
+
+ Filterable fields can optionally be used in faceted navigation.
76
+
77
+
+ Filterable fields are returned in arbitrary order, so consider making them sortable as well.
0 commit comments