Skip to content

Commit f873890

Browse files
committed
Edits for clarity and consistency, cross links
1 parent 18fce7f commit f873890

File tree

1 file changed

+8
-7
lines changed

1 file changed

+8
-7
lines changed

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

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ Setting a field as searchable, filterable, sortable, or facetable has an effect
9393

9494
If a field isn't set to be searchable, filterable, sortable, or facetable, the field can't be referenced in any query expression. This is desirable for fields that aren't used in queries, but are needed in search results.
9595

96-
The REST APIs have default attribution based on data types, which is also used by the [Import wizards](search-import-data-portal.md) in the Azure portal. The Azure SDKs don't have defaults, but they have field subclasses that incorporate properties and behaviors, such as [SearchableField](/dotnet/api/azure.search.documents.indexes.models.searchablefield) for strings and [SimpleField](/dotnet/api/azure.search.documents.indexes.models.simplefield) for primitives.
96+
The REST APIs have default attribution based on [data types](/rest/api/searchservice/supported-data-types), which is also used by the [Import wizards](search-import-data-portal.md) in the Azure portal. The Azure SDKs don't have defaults, but they have field subclasses that incorporate properties and behaviors, such as [SearchableField](/dotnet/api/azure.search.documents.indexes.models.searchablefield) for strings and [SimpleField](/dotnet/api/azure.search.documents.indexes.models.simplefield) for primitives.
9797

9898
Default field attributions for the REST APIs are summarized in the following table.
9999

@@ -106,11 +106,11 @@ Default field attributions for the REST APIs are summarized in the following tab
106106
| `Edm.DateTimeOffset` |||||||
107107
| `Edm.GeographyPoint` |||||||
108108
| `Edm.ComplexType` |||||||
109-
| `Collection(Edm.Single)` and all other vector field types |||||||
109+
| `Collection(Edm.Single)` and all other vector field types || ✅ or |||||
110110

111111
String fields can also be optionally associated with [analyzers](search-analyzers.md) and [synonym maps](search-synonyms.md). Fields of type `Edm.String` that are filterable, sortable, or facetable can be at most 32 kilobytes in length. This is because values of such fields are treated as a single search term, and the maximum length of a term in Azure AI Search is 32 kilobytes. If you need to store more text than this in a single string field, you should explicitly set filterable, sortable, and facetable to `false` in your index definition.
112112

113-
Vector fields must be associated with [dimensions and vector profiles](vector-search-how-to-create-index.md).
113+
Vector fields must be associated with [dimensions and vector profiles](vector-search-how-to-create-index.md). Retrievable default is true if you add the vector field using the [Import and vectorize wizard](search-get-started-portal-import-vectors.md) in the portal, otherwise it's false if you use the REST API.
114114

115115
Field attributes are described in the following table.
116116

@@ -261,9 +261,9 @@ The following properties can be set for CORS:
261261

262262
[**Create Index**](/rest/api/searchservice/indexes/create) creates the physical data structures (files and inverted indexes) on your search service. Once the index is created, your ability to effect changes using [**Create or Update Index**](/rest/api/searchservice/indexes/create-or-update) is contingent upon whether your modifications invalidate those physical structures. Most field attributes can't be changed once the field is created in your index.
263263

264-
Alternatively, you can [create an index alias](search-how-to-alias.md) that serves as a stable reference in your application code. Instead of updating your code, you can update an index alias to point to newer index versions.
264+
To minimize churn in application code, you can [create an index alias](search-how-to-alias.md) that serves as a stable reference to the search index. Instead of updating your code with index names, you can update an index alias to point to newer index versions.
265265

266-
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.
266+
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. For more information, see [Update or rebuild an index](search-howto-reindex.md).
267267

268268
| Element | Can be updated? |
269269
|---------|-----------------|
@@ -278,6 +278,8 @@ To minimize churn in the design process, the following table describes which ele
278278
| [Suggesters](index-add-suggesters.md) | No |
279279
| [cross-origin resource sharing (CORS)](#corsoptions) | Yes |
280280
| [Encryption](search-security-manage-encryption-keys.md) | Yes |
281+
| [Synonym maps](search-synonyms.md) | Yes |
282+
| [Semantic configuration](semantic-how-to-configure.md) | Yes |
281283

282284
## Next steps
283285

@@ -286,5 +288,4 @@ Use the following links to become familiar with loading an index with data, or e
286288
+ [Data import overview](search-what-is-data-import.md)
287289
+ [Add vector fields](vector-search-how-to-create-index.md)
288290
+ [Load documents](search-how-to-load-search-index.md)
289-
+ [Update an index](search-howto-reindex.md)
290-
+ [Synonym maps](search-synonyms.md)
291+
+ [Update or rebuild an index](search-howto-reindex.md)

0 commit comments

Comments
 (0)