Skip to content

Commit 5930a6b

Browse files
committed
corrections per final read through
1 parent e223c5d commit 5930a6b

5 files changed

+20
-15
lines changed

articles/search/search-get-started-portal-import-vectors.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.service: azure-ai-search
88
ms.custom:
99
- build-2024
1010
ms.topic: quickstart
11-
ms.date: 11/19/2024
11+
ms.date: 11/20/2024
1212
---
1313

1414
# Quickstart: Vectorize text and images by using the Azure portal
@@ -37,12 +37,12 @@ The **Import and vectorize data** wizard supports the following data sources:
3737

3838
+ [OneLake lakehouse (preview)](search-how-to-index-onelake-files.md).
3939

40-
+ [Azure Cosmos DB](/azure/cosmos-db/nosql/quickstart-portal) for NoSQL, Mongo DB, and Apache Gremlin (preview).
40+
+ [Azure Cosmos DB](/azure/cosmos-db/nosql/quickstart-portal) for NoSQL, MongoDB, and Apache Gremlin (preview).
4141

4242
+ [Azure SQL Database](/azure/azure-sql/database/single-database-create-quickstart), [Azure SQL Managed Instance](/azure/azure-sql/managed-instance/instance-create-quickstart), and Azure SQL Server virtual machines.
4343

4444
> [!NOTE]
45-
> This quicktart provides steps for just those data sources that work with whole files: Azure Blob storage, ADLS Gen2, OneLake. For more information about using this wizard with other data soruces, see [Azure Table indexer](search-howto-indexing-azure-tables.md), [Cosmos DB for NoSQL indexer](search-howto-index-cosmosdb.md), and [Azuer SQL indexer](search-how-to-index-sql-database.md).
45+
> This quicktart provides steps for just those data sources that work with whole files: Azure Blob storage, ADLS Gen2, OneLake. To use the wizard with other data sources, see [Azure Table indexer](search-howto-indexing-azure-tables.md), [Cosmos DB for NoSQL indexer](search-howto-index-cosmosdb.md), and [Azuer SQL indexer](search-how-to-index-sql-database.md).
4646
4747
### Supported embedding models
4848

@@ -471,6 +471,7 @@ Search Explorer accepts text strings as input and then vectorizes the text for v
471471
}
472472
]
473473
}
474+
```
474475

475476
## Clean up
476477

articles/search/search-how-to-index-sql-database.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ To work through the examples in this article, you need the Azure portal or a [RE
4242

4343
## Try with sample data
4444

45-
Use these instructions to create and load a table in Azure SQL Database.
45+
Use these instructions to create and load a table in Azure SQL Database for testing purposes.
4646

4747
1. [Download hotels-azure-sql.sql](https://github.com/Azure-Samples/azure-search-sample-data/tree/main/hotels/hotel-sql) from GitHub to create a table on Azure SQL Database that contains a subset of the sample hotels data set.
4848

@@ -102,7 +102,7 @@ Now that you have a database table, you can use the Azure portal, REST client, o
102102
103103
## Use the Azure portal
104104
105-
You can use either the **Import data** wizard or **Import and vectorize data** wizard to automate indexing from an SQL database table or view. The data source configuration similar for both wizards.
105+
You can use either the **Import data** wizard or **Import and vectorize data** wizard to automate indexing from an SQL database table or view. The data source configuration is similar for both wizards.
106106
107107
1. [Start the wizard](search-import-data-portal.md#starting-the-wizards).
108108

articles/search/search-howto-index-cosmosdb.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Because terminology can be confusing, it's worth noting that [Azure Cosmos DB in
2424

2525
## Prerequisites
2626

27-
+ An [Azure Cosmos DB account, database, container and items](/azure/cosmos-db/sql/create-cosmosdb-resources-portal). Use the same region for both Azure AI Search and Azure Cosmos DB for lower latency and to avoid bandwidth charges.
27+
+ An [Azure Cosmos DB account, database, container, and items](/azure/cosmos-db/sql/create-cosmosdb-resources-portal). Use the same region for both Azure AI Search and Azure Cosmos DB for lower latency and to avoid bandwidth charges.
2828

2929
+ An [automatic indexing policy](/azure/cosmos-db/index-policy) on the Azure Cosmos DB collection, set to [Consistent](/azure/cosmos-db/index-policy#indexing-mode). This is the default configuration. Lazy indexing isn't recommended and can result in missing data.
3030

@@ -34,7 +34,7 @@ To work through the examples in this article, you need the Azure portal or a [RE
3434

3535
## Try with sample data
3636

37-
Use these instructions to create a container and database in Cosmos DB.
37+
Use these instructions to create a container and database in Cosmos DB for testing purposes.
3838

3939
1. [Download HotelsData_toCosmosDB.JSON](https://github.com/HeidiSteen/azure-search-sample-data/blob/main/hotels/HotelsData_toCosmosDB.JSON) from GitHub to create a container in Cosmos DB that contains a subset of the sample hotels data set.
4040

@@ -62,9 +62,11 @@ Use these instructions to create a container and database in Cosmos DB.
6262

6363
Now that you have a container, you can use the Azure portal, REST client, or an Azure SDK to index your data.
6464

65+
The Description field provides the most verbose content. You should target this field for full text search and optional vector queries.
66+
6567
## Use the Azure portal
6668

67-
You can use either the **Import data** wizard or **Import and vectorize data** wizard to automate indexing from an SQL database table or view. The data source configuration similar for both wizards.
69+
You can use either the **Import data** wizard or **Import and vectorize data** wizard to automate indexing from an SQL database table or view. The data source configuration is similar for both wizards.
6870

6971
1. [Start the wizard](search-import-data-portal.md#starting-the-wizards).
7072

@@ -76,7 +78,7 @@ You can use either the **Import data** wizard or **Import and vectorize data** w
7678

7779
1. Specify an authentication method, either a managed identity or built-in API key. If you don't specify a managed identity connection, the portal uses the key.
7880

79-
If you [configure Azure AI Search to use a managed identity](search-howto-managed-identities-data-sources.md), and you create a role assignment on Cosmos DB that grants **Cosmos DB Account Reader Role** and [**Cosmos DB Built-in Data Reader Role**](/azure/cosmos-db/how-to-setup-rbac#built-in-role-definitions) permissions to the identity, your indexer can connect to Cosmos DB using Microsoft Entra ID and roles.
81+
If you [configure Azure AI Search to use a managed identity](search-howto-managed-identities-data-sources.md), and you create a [role assignment on Cosmos DB](/azure/cosmos-db/how-to-setup-rbac#built-in-role-definitions) that grants **Cosmos DB Account Reader** and **Cosmos DB Built-in Data Reader** permissions to the identity, your indexer can connect to Cosmos DB using Microsoft Entra ID and roles.
8082

8183
1. For the **Import and vectorize data** wizard, you can specify options for change and deletion tracking.
8284

@@ -140,7 +142,7 @@ The data source definition specifies the data to index, credentials, and policie
140142
141143
Indexers can connect to a collection using the following connections.
142144
143-
Avoid port numbers in the endpoint URL. If you include the port number, the connection will fail.
145+
Avoid port numbers in the endpoint URL. If you include the port number, the connection fails.
144146
145147
| Full access connection string |
146148
|-----------------------------------------------|

articles/search/search-howto-indexing-azure-tables.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ ms.date: 11/20/2024
1818

1919
In this article, learn how to configure an [**indexer**](search-indexer-overview.md) that imports content from Azure Table Storage and makes it searchable in Azure AI Search. Inputs to the indexer are your entities, in a single table. Output is a search index with searchable content and metadata stored in individual fields.
2020

21-
This article supplements [**Create an indexer**](search-howto-create-indexers.md) with information that's specific to indexing from Azure Table Storage. It uses the REST APIs to demonstrate a three-part workflow common to all indexers: create a data source, create an index, create an indexer. Data extraction occurs when you submit the Create Indexer request.
21+
This article supplements [**Create an indexer**](search-howto-create-indexers.md) with information that's specific to indexing from Azure Table Storage. It uses the Azure portal and REST APIs to demonstrate a three-part workflow common to all indexers: create a data source, create an index, create an indexer. Data extraction occurs when you submit the Create Indexer request.
2222

2323
## Prerequisites
2424

@@ -32,7 +32,7 @@ To work through the examples in this article, you need the Azure portal or a [RE
3232

3333
## Try with sample data
3434

35-
Use these instructions to create a table in Azure Storage.
35+
Use these instructions to create a table in Azure Storage for testing purposes.
3636

3737
1. Sign in to the Azure portal, navigate to your storage account, and create a table named *hotels*.
3838

@@ -46,13 +46,15 @@ Use these instructions to create a table in Azure Storage.
4646

4747
1. Select **Import** on the command bar, and then select the *HotelsData_toAzureSearch.csv* file.
4848

49-
1. Accept the default. Select **Import** to load the data.
49+
1. Accept the defaults. Select **Import** to load the data.
5050

5151
You should have 50 hotel records in the table with an autogenerated partitionKey, rowKey, and timestamp. You can now use this content for indexing in the Azure portal, REST client, or an Azure SDK.
5252

53+
The Description field provides the most verbose content. You should target this field for full text search and optional vector queries.
54+
5355
## Use the Azure portal
5456

55-
You can use either the **Import data** wizard or **Import and vectorize data** wizard to automate indexing from an SQL database table or view. The data source configuration similar for both wizards.
57+
You can use either the **Import data** wizard or **Import and vectorize data** wizard to automate indexing from an SQL database table or view. The data source configuration is similar for both wizards.
5658

5759
1. [Start the wizard](search-import-data-portal.md#starting-the-wizards).
5860

articles/search/search-import-data-portal.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.author: heidist
99
ms.service: azure-ai-search
1010
ms.custom:
1111
ms.topic: concept-article
12-
ms.date: 11/19/2024
12+
ms.date: 11/20/2024
1313
---
1414

1515
# Import data wizards in the Azure portal

0 commit comments

Comments
 (0)