From c75a29bdab6f6750a8dd96fde3e14b111e496602 Mon Sep 17 00:00:00 2001 From: Mike Wong Date: Thu, 30 Jan 2025 14:23:45 -0500 Subject: [PATCH] Updating messaging around reindexing Based on feedback from non-native English-speaking customers who heavily rely on App Search in production, I've updated this text to be more explicit. The previous wording caused confusion about whether reindexing was optional during migration, so I've clarified the strong recommendation to reindex data. --- notebooks/enterprise-search/app-search-engine-exporter.ipynb | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/notebooks/enterprise-search/app-search-engine-exporter.ipynb b/notebooks/enterprise-search/app-search-engine-exporter.ipynb index da37cdf5..13c1863f 100644 --- a/notebooks/enterprise-search/app-search-engine-exporter.ipynb +++ b/notebooks/enterprise-search/app-search-engine-exporter.ipynb @@ -213,9 +213,9 @@ "source": [ "## Create a new Elasticsearch index\n", "\n", - "While we could re-use the same Elasticsearch index that is storing the App Search engine documents, reindexing the data in a new index will allow us to change the mapping to use features like semantic search or to be able to use the Elasticsearch synonym set we just created.\n", + "We strongly recommend reindexing your App Search engine data into a new index, rather than reusing the existing Elasticsearch index. This allows you to update the mapping to take advantage of modern features like semantic search and the newly created Elasticsearch synonym set.\n", "\n", - "App Search has the following data types: text, number, date and geolocation. Each of these types is mapped to Elasticsearch field types.\n", + "App Search has the following data types: `text`, `number`, `date` and `geolocation`. Each of these types is mapped to Elasticsearch field types.\n", "We can take a closer look at how App Search field types are mapped to Elasticsearch fields, by using the [`GET mapping API`](https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-get-mapping.html).\n", "For App Search engines, the associated Elasticsearch index name is `.ent-search-engine-documents-[ENGINE_NAME]`, e.g. `.ent-search-engine-documents-national-parks-demo` for the App Search sample engine `national-parks-demo`.\n", "One thing to notice is how App Search uses [multi-fields](https://www.elastic.co/guide/en/elasticsearch/reference/current/multi-fields.html) in Elasticsearch that allow for quickly changing the field type in App Search without requiring reindexing by creating subfields for each type of supported field:\n",