Skip to content

Commit fca9003

Browse files
committed
Updated Alt text and removed PII
1 parent d307c0b commit fca9003

File tree

4 files changed

+18
-20
lines changed

4 files changed

+18
-20
lines changed

articles/search/cognitive-search-quickstart-blob.md

Lines changed: 18 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ In the following steps, set up a blob container in Azure Storage to store hetero
5151

5252
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.
5353

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":::
5555

5656
You are now ready to move on the Import data wizard.
5757

@@ -61,15 +61,15 @@ You are now ready to move on the Import data wizard.
6161

6262
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.
6363

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":::
6565

6666
### Step 1 - Create a data source
6767

6868
1. In **Connect to your data**, choose **Azure Blob Storage**.
6969

7070
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.
7171

72-
:::image type="content" source="media/cognitive-search-quickstart-blob/blob-datasource.png" alt-text="Azure blob configuration" border="true":::
72+
:::image type="content" source="media/cognitive-search-quickstart-blob/blob-datasource.png" alt-text="Screenshot of the data source definition page." border="true":::
7373

7474
Continue to the next page.
7575

@@ -79,17 +79,15 @@ Next, configure AI enrichment to invoke OCR, image analysis, and natural languag
7979

8080
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.
8181

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":::
8383

84-
1. Expand **Add enrichments** and make four selections.
84+
1. Expand **Add enrichments** and make six selections.
8585

8686
Enable OCR to add image analysis skills to wizard page.
8787

88-
Set granularity to Pages to break up text into smaller chunks. Several text skills are limited to 5-KB inputs.
88+
Choose entity recognition (people, organizations, locations) and image analysis skills (tags, captions).
8989

90-
Choose entity recognition (people, organizations, locations) and image analysis skills.
91-
92-
:::image type="content" source="media/cognitive-search-quickstart-blob/skillset.png" alt-text="Attach Cognitive Services select services for skillset" border="false":::
90+
:::image type="content" source="media/cognitive-search-quickstart-blob/skillset.png" alt-text="Screenshot of the skillset definition page." border="true":::
9391

9492
Continue to the next page.
9593

@@ -105,7 +103,7 @@ For this quickstart, the wizard does a good job setting reasonable defaults:
105103

106104
+ 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.
107105

108-
:::image type="content" source="media/cognitive-search-quickstart-blob/index-fields.png" alt-text="Index fields" border="true":::
106+
:::image type="content" source="media/cognitive-search-quickstart-blob/index-fields.png" alt-text="Screenshot of the index definition page" border="true":::
109107

110108
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.
111109

@@ -117,40 +115,40 @@ The indexer drives the indexing process. It specifies the data source name, a ta
117115

118116
1. In the **Indexer** page, you can accept the default name and select **Once** to run it immediately.
119117

120-
:::image type="content" source="media/cognitive-search-quickstart-blob/indexer-def.png" alt-text="Indexer definition" border="true":::
118+
:::image type="content" source="media/cognitive-search-quickstart-blob/indexer-def.png" alt-text="Screenshot of the indexer definition page." border="true":::
121119

122120
1. Click **Submit** to create and simultaneously run the indexer.
123121

124122
## Monitor status
125123

126124
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.
127125

128-
:::image type="content" source="media/cognitive-search-quickstart-blob/indexer-notification.png" alt-text="Azure Cognitive Search notification" border="false":::
126+
:::image type="content" source="media/cognitive-search-quickstart-blob/indexer-notification.png" alt-text="Screenshot of the indexer status page." border="true":::
129127

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.
131129

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.
133131

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.
135133

136134
## Query in Search explorer
137135

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.
139137

140138
1. On the search service dashboard page, select **Search explorer** on the command bar.
141139

142140
1. Select **Change Index** at the top to select the index you created.
143141

144142
1. Enter a search string to query the index, such as `search=Satya Nadella&$select=people,organizations,locations&$count=true`.
145143

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:
147145

148-
+ Append `$select` to specify which fields to include in results.
146+
+ Append `$select` to limit the fields returned in results.
149147
+ Use CTRL-F to search within the JSON for specific properties or terms.
150148

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.
152150

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":::
154152

155153
## Takeaways
156154

-37 Bytes
Loading
13.1 KB
Loading
-520 Bytes
Loading

0 commit comments

Comments
 (0)