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/cognitive-search-quickstart-blob.md
+18-20Lines changed: 18 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -51,7 +51,7 @@ In the following steps, set up a blob container in Azure Storage to store hetero
51
51
52
52
1. In Container, select **Upload** to upload the sample files you downloaded in the first step. Notice that you have a wide range of content types, including images and application files that are not full text searchable in their native formats.
53
53
54
-
:::image type="content" source="media/cognitive-search-quickstart-blob/sample-data.png" alt-text="Source files in Azure Blob Storage" border="false":::
54
+
:::image type="content" source="media/cognitive-search-quickstart-blob/sample-data.png" alt-text="Screenshot of source files in Azure Blob Storage." border="false":::
55
55
56
56
You are now ready to move on the Import data wizard.
57
57
@@ -61,15 +61,15 @@ You are now ready to move on the Import data wizard.
61
61
62
62
1.[Find your search service](https://ms.portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Storage%2storageAccounts/) and on the Overview page, select **Import data** on the command bar to set up cognitive enrichment in four steps.
63
63
64
-
:::image type="content" source="media/search-import-data-portal/import-data-cmd.png" alt-text="Screenshot of the Import data command" border="true":::
64
+
:::image type="content" source="media/search-import-data-portal/import-data-cmd.png" alt-text="Screenshot of the Import data command." border="true":::
65
65
66
66
### Step 1 - Create a data source
67
67
68
68
1. In **Connect to your data**, choose **Azure Blob Storage**.
69
69
70
70
1. Choose an existing connection to the storage account and select the container you created. Give the data source a name, and use default values for the rest.
:::image type="content" source="media/cognitive-search-quickstart-blob/blob-datasource.png" alt-text="Screenshot of the data source definition page." border="true":::
73
73
74
74
Continue to the next page.
75
75
@@ -79,17 +79,15 @@ Next, configure AI enrichment to invoke OCR, image analysis, and natural languag
79
79
80
80
1. For this quickstart, we are using the **Free** Cognitive Services resource. The sample data consists of 14 files, so the free allotment of 20 transaction on Cognitive Services is sufficient for this quickstart.
81
81
82
-
:::image type="content" source="media/cognitive-search-quickstart-blob/cog-search-attach.png" alt-text="Attach Cognitive Services attach base service" border="true":::
82
+
:::image type="content" source="media/cognitive-search-quickstart-blob/cog-search-attach.png" alt-text="Screenshot of the Attach Cognitive Services tab." border="true":::
83
83
84
-
1. Expand **Add enrichments** and make four selections.
84
+
1. Expand **Add enrichments** and make six selections.
85
85
86
86
Enable OCR to add image analysis skills to wizard page.
87
87
88
-
Set granularity to Pages to break up text into smaller chunks. Several text skills are limited to 5-KB inputs.
:::image type="content" source="media/cognitive-search-quickstart-blob/skillset.png" alt-text="Screenshot of the skillset definition page." border="true":::
93
91
94
92
Continue to the next page.
95
93
@@ -105,7 +103,7 @@ For this quickstart, the wizard does a good job setting reasonable defaults:
105
103
106
104
+ Default attributes are **Retrievable** and **Searchable**. **Searchable** allows full text search a field. **Retrievable** means field values can be returned in results. The wizard assumes you want these fields to be retrievable and searchable because you created them via a skillset. Select **Filterable** if you want to use fields in a filter expression.
:::image type="content" source="media/cognitive-search-quickstart-blob/index-fields.png" alt-text="Screenshot of the index definition page" border="true":::
109
107
110
108
Marking a field as **Retrievable** does not mean that the field *must* be present in the search results. You can control search results composition by using the **$select** query parameter to specify which fields to include.
111
109
@@ -117,40 +115,40 @@ The indexer drives the indexing process. It specifies the data source name, a ta
117
115
118
116
1. In the **Indexer** page, you can accept the default name and select **Once** to run it immediately.
:::image type="content" source="media/cognitive-search-quickstart-blob/indexer-def.png" alt-text="Screenshot of the indexer definition page." border="true":::
121
119
122
120
1. Click **Submit** to create and simultaneously run the indexer.
123
121
124
122
## Monitor status
125
123
126
124
Cognitive skills indexing takes longer to complete than typical text-based indexing, especially OCR and image analysis. To monitor progress, go to the Overview page and select **Indexers** in the middle of page.
:::image type="content" source="media/cognitive-search-quickstart-blob/indexer-notification.png" alt-text="Screenshot of the indexer status page." border="true":::
129
127
130
-
To check details about execution status, select an indexer from the list.
128
+
To check details about execution status, select an indexer from the list, and then select **Success** (or **Failed**) to view execution details.
131
129
132
-
There is one warning. It tells you that the PNG file in the data source doesn't provide a text input to Entity Recognition. This warning occurs because the upstream OCR skill didn't recognize any text in the image, and thus could not provide a text input to the downstream Entity Recognition skill.
130
+
In this demo, there is one warning. It tells you that a PNG file in the data source doesn't provide a text input to Entity Recognition. This warning occurs because the upstream OCR skill didn't recognize any text in the image, and thus could not provide a text input to the downstream Entity Recognition skill.
133
131
134
-
In skillset execution, warnings are common. As you become familiar with skillset execution, you'll begin to notice patterns and learn which warnings are safe to ignore.
132
+
Warnings are common in skillset execution. As you become familiar with how skills iterate over your data, you'll begin to notice patterns and learn which warnings are safe to ignore.
135
133
136
134
## Query in Search explorer
137
135
138
-
After an index is created, you can run queries to return results. In the portal, use **Search explorer**for this task.
136
+
After an index is created, run queries in **Search explorer**to return results.
139
137
140
138
1. On the search service dashboard page, select **Search explorer** on the command bar.
141
139
142
140
1. Select **Change Index** at the top to select the index you created.
143
141
144
142
1. Enter a search string to query the index, such as `search=Satya Nadella&$select=people,organizations,locations&$count=true`.
145
143
146
-
Results are returned as JSON, which can be verbose and hard to read, especially in large documents originating from Azure blobs. Some tips for searching in this tool include the following techniques:
144
+
Results are returned as verbose JSON, which can be hard to read, especially in large documents. Some tips for searching in this tool include the following techniques:
147
145
148
-
+ Append `$select` to specify which fields to include in results.
146
+
+ Append `$select` to limit the fields returned in results.
149
147
+ Use CTRL-F to search within the JSON for specific properties or terms.
150
148
151
-
Query strings are case-sensitive so if you get an "unknown field" message, check **Fields** or **Index Definition (JSON)** to verify name and case.
149
+
Query strings are case-sensitive so if you get an "unknown field" message, check **Fields** or **Index Definition (JSON)** to verify name and case.
152
150
153
-
:::image type="content" source="media/cognitive-search-quickstart-blob/search-explorer.png" alt-text="Search explorer example" border="true":::
151
+
:::image type="content" source="media/cognitive-search-quickstart-blob/search-explorer.png" alt-text="Screenshot of the the Search explorer page." border="true":::
0 commit comments