Skip to content

Commit 61c351a

Browse files
authored
Merge pull request #178596 from HeidiSteen/heidist-storebrowse
[azure search] update docs and screenshots for Storage Browser
2 parents 9d1e71d + 15915d8 commit 61c351a

17 files changed

+35
-41
lines changed

articles/search/TOC.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -406,7 +406,7 @@
406406
href: knowledge-store-projections-examples.md
407407
- name: Projection example
408408
href: knowledge-store-projection-example-long.md
409-
- name: View with Storage Explorer
409+
- name: View with Storage Browser
410410
href: knowledge-store-view-storage-explorer.md
411411
- name: Connect with Power BI
412412
href: knowledge-store-connect-power-bi.md

articles/search/cognitive-search-concept-intro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -116,7 +116,7 @@ Indexes and knowledge stores are fully independent of each other. While you must
116116

117117
When processing is finished, you have a [search index](search-what-is-an-index.md) consisting of enriched documents, fully text-searchable in Azure Cognitive Search. [**Querying the index**](search-query-overview.md) is how developers and users access the enriched content generated by the pipeline. The index is like any other you might create for Azure Cognitive Search: you can supplement text analysis with custom analyzers, invoke fuzzy search queries, add filters, or experiment with scoring profiles to tune search relevance.
118118

119-
You might also have a [knowledge store](knowledge-store-concept-intro.md). The knowledge store contains data that can be consumed in knowledge mining scenarios like analytics or machine learning. You can use [Storage Explorer](knowledge-store-view-storage-explorer.md), [Power BI](knowledge-store-connect-power-bi.md), or any app that connects to Azure Storage.
119+
You might also have a [knowledge store](knowledge-store-concept-intro.md). The knowledge store contains data that can be consumed in knowledge mining scenarios like analytics or machine learning. You can use [Storage Browser](knowledge-store-view-storage-explorer.md), [Power BI](knowledge-store-connect-power-bi.md), or any app that connects to Azure Storage.
120120

121121
## Checklist: A typical workflow
122122

articles/search/cognitive-search-resources-documentation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ The following is a consolidated list of the documentation for AI enrichment.
3838

3939
+ [Quickstart: Create a knowledge store in the Azure portal](knowledge-store-create-portal.md)
4040
+ [Create a knowledge store using REST and Postman](knowledge-store-create-rest.md)
41-
+ [View a knowledge store with Storage Explorer](knowledge-store-view-storage-explorer.md)
41+
+ [View a knowledge store with Storage Browser](knowledge-store-view-storage-explorer.md)
4242
+ [Connect a knowledge store with Power BI](knowledge-store-connect-power-bi.md)
4343
+ [Define projections in a knowledge store](knowledge-store-projections-examples.md)
4444

articles/search/knowledge-store-concept-intro.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ If you have used cognitive skills in the past, you already know that *skillsets*
2020

2121
Physically, a knowledge store is [Azure Storage](../storage/common/storage-account-overview.md), either Azure Table Storage, Azure Blob Storage, or both. Any tool or process that can connect to Azure Storage can consume the contents of a knowledge store.
2222

23-
Viewed through Storage Explorer, a knowledge store looks like any other collection of tables, objects, or files. The following example shows a knowledge store composed of three tables with fields that are either carried forward from the data source, or created through enrichments (see "sentiment score" and "translated_text").
23+
Viewed through Storage Browser, a knowledge store looks like any other collection of tables, objects, or files. The following example shows a knowledge store composed of three tables with fields that are either carried forward from the data source, or created through enrichments (see "sentiment score" and "translated_text").
2424

2525
:::image type="content" source="media/knowledge-store-concept-intro/kstore-in-storage-explorer.png" alt-text="Skills read and write from enrichment tree" border="true":::
2626

@@ -117,7 +117,7 @@ For .NET developers, use the [KnowledgeStore Class](/dotnet/api/azure.search.doc
117117

118118
Once the enrichments exist in storage, any tool or technology that connects to Azure Blob or Table Storage can be used to explore, analyze, or consume the contents. The following list is a start:
119119

120-
+ [Storage Explorer](knowledge-store-view-storage-explorer.md) to view enriched document structure and content. Consider this as your baseline tool for viewing knowledge store contents.
120+
+ [Storage Browser](knowledge-store-view-storage-explorer.md) to view enriched document structure and content. Consider this as your baseline tool for viewing knowledge store contents.
121121

122122
+ [Power BI](knowledge-store-connect-power-bi.md) for reporting and analysis.
123123

articles/search/knowledge-store-create-portal.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -93,9 +93,9 @@ In this wizard step, add skills for AI enrichment. The source data consists of c
9393

9494
1. Scroll down and expand **Save enrichments to knowledge store**.
9595

96-
1. Select **Choose an existing connection** and then select an Azure Storage account. The Containers page will appear, but since we are only creating tables, you can close this page and the Azure Storage page, returning to the **Import data** wizard.
96+
1. Select **Choose an existing connection** and then select an Azure Storage account. The Containers page will appear so that you can create a container for projections. We recommend adopting a prefix naming convention, such as "kstore-hotel-reviews" to distinguish between source content and knowledge store content.
9797

98-
1. Back in the wizard, select the following **Azure table projections**. The wizard always offers the **Documents** projection. Other projections will be offered depending on the skills you select (such as **Key phrases**), or the enrichment granularity (**Pages**):
98+
1. Returning to the Import data wizard, select the following **Azure table projections**. The wizard always offers the **Documents** projection. Other projections will be offered depending on the skills you select (such as **Key phrases**), or the enrichment granularity (**Pages**):
9999

100100
+ **Documents**
101101
+ **Pages**
@@ -143,13 +143,13 @@ In the Azure portal, switch to your Azure Storage account and use **Storage Brow
143143

144144
+ "hotelReviewssKeyPhrases" contains a long list of just the key phrases extracted from all reviews. Skills that output collections (arrays), such as key phrases and entities, will have output sent to a standalone table.
145145

146-
+ "hotelReviewssPages" contains enriched fields created over each page that was split from the document. In this skillset and data source, page-level enrichments consist of a sentiment labels and translated text. A pages table (or a sentences table if you specify that particular level of granularity) is created when you choose "pages" granularity in the skillset definition.
146+
+ "hotelReviewssPages" contains enriched fields created over each page that was split from the document. In this skillset and data source, page-level enrichments consisting of sentiment labels and translated text. A pages table (or a sentences table if you specify that particular level of granularity) is created when you choose "pages" granularity in the skillset definition.
147147

148148
All of these tables contain ID columns to support table relationships in other tools and apps. When you open a table, scroll past these fields to view the content fields added by the pipeline.
149149

150150
In this quickstart, the table for "hotelReviewssPages" should look similar to the following screenshot:
151151

152-
:::image type="content" source="media/knowledge-store-create-portal/azure-table-hotel-reviews.png" alt-text="Screenshot of the generated tables in Storage Explorer" border="true":::
152+
:::image type="content" source="media/knowledge-store-create-portal/azure-table-hotel-reviews.png" alt-text="Screenshot of the generated tables in Storage Browser" border="true":::
153153

154154
## Clean up
155155

articles/search/knowledge-store-create-rest.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,11 @@ manager: nitinme
88
ms.author: heidist
99
ms.service: cognitive-search
1010
ms.topic: tutorial
11-
ms.date: 09/02/2021
11+
ms.date: 11/03/2021
1212
---
1313
# Create a knowledge store using REST and Postman
1414

15-
Knowledge store is a feature of Azure Cognitive Search that sends skillset output from an [AI enrichment pipeline](cognitive-search-concept-intro.md) to Azure Storage for subsequent knowledge mining, data analysis, or downstream processing. After the knowledge store is populated, you can use tools like [Storage Explorer](knowledge-store-view-storage-explorer.md) or [Power BI](knowledge-store-connect-power-bi.md) to explore the content.
15+
Knowledge store is a feature of Azure Cognitive Search that sends skillset output from an [AI enrichment pipeline](cognitive-search-concept-intro.md) to Azure Storage for subsequent knowledge mining, data analysis, or downstream processing. After the knowledge store is populated, you can use tools like [Storage Browser](knowledge-store-view-storage-explorer.md) or [Power BI](knowledge-store-connect-power-bi.md) to explore the content.
1616

1717
In this article, you'll use the REST API to ingest, enrich, and explore a set of customer reviews of hotel stays in a knowledge store in Azure Storage. The end result is a knowledge store that contains original text content pulled from the source, plus AI-generated content that includes a sentiment score, key phrase extraction, language detection, and text translation of non-English customer comments.
1818

@@ -33,11 +33,11 @@ Because the workload is so small, Cognitive Services is tapped behind the scenes
3333

3434
Choose the **StorageV2 (general purpose V2)** account type.
3535

36-
1. In the Azure Storage resource, use **Storage Explorer** to create a blob container named **hotel-reviews**.
36+
1. In the Azure Storage resource, use **Storage Browser** to create a blob container named **hotel-reviews**.
3737

3838
1. Select **Upload** at the top of the page to load the **HotelReviews-Free.csv** file you downloaded from the previous step.
3939

40-
:::image type="content" source="media/knowledge-store-create-portal/blob-container-storage-explorer.png" alt-text="Screenshot of Storage Explorer with uploaded file and left nav pane" border="true":::
40+
:::image type="content" source="media/knowledge-store-create-portal/blob-container-storage-explorer.png" alt-text="Screenshot of Storage Browser with uploaded file and left nav pane" border="true":::
4141

4242
1. You are almost done with this resource, but before you leave these pages, select **Access Keys** on the left navigation pane to get a connection string so that you can retrieve this data using the indexer.
4343

@@ -367,13 +367,13 @@ After you send each request, the search service should respond with a 201 succes
367367

368368
In the Azure portal, go to the Azure Cognitive Search service's **Overview** page. Select the **Indexers** tab, and then select **hotels-reviews-ixr**. Within a minute or two, status should progress from "In progress" to "Success" with zero errors and warnings.
369369

370-
## Check tables in Storage Explorer
370+
## Check tables in Storage Browser
371371

372-
In the Azure portal, switch to your Azure Storage account and use **Storage Explorer** to view the new tables. You should see six tables, one for each projection defined in the skillset.
372+
In the Azure portal, switch to your Azure Storage account and use **Storage Browser** to view the new tables. You should see six tables, one for each projection defined in the skillset.
373373

374374
Each table is generated with the IDs necessary for cross-linking the tables in queries. When you open a table, scroll past these fields to view the content fields added by the pipeline.
375375

376-
:::image type="content" source="media/knowledge-store-create-rest/knowledge-store-tables.png" alt-text="Screenshot of the knowledge store tables in Storage Explorer" border="true":::
376+
:::image type="content" source="media/knowledge-store-create-portal/azure-table-hotel-reviews.png" alt-text="Screenshot of the knowledge store tables in Storage Browser" border="true":::
377377

378378
In this walkthrough, the knowledge store is composed of a various tables showing different ways of shaping and structuring a table. Tables one through three use output from a Shaper skill to determine the columns and rows. Tables four through six are created from inline shaping instructions, embedded within the projection itself. You can use either approach to achieve the same outcome.
379379

@@ -399,9 +399,9 @@ If you are using a free service, remember that you are limited to three indexes,
399399
400400
## Next steps
401401

402-
Now that you've enriched your data by using Cognitive Services and projected the results to a knowledge store, you can use Storage Explorer or other apps to explore your enriched data set.
402+
Now that you've enriched your data by using Cognitive Services and projected the results to a knowledge store, you can use Storage Browser or other apps to explore your enriched data set.
403403

404-
To learn how to explore this knowledge store by using Storage Explorer, see this walkthrough:
404+
To learn how to explore this knowledge store by using Storage Browser, see this walkthrough:
405405

406406
> [!div class="nextstepaction"]
407-
> [View with Storage Explorer](knowledge-store-view-storage-explorer.md)
407+
> [View with Storage Browser](knowledge-store-view-storage-explorer.md)

articles/search/knowledge-store-projection-overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ This article introduces projection concepts and workflow so that you have some b
1919

2020
Projections are defined in Cognitive Search skillsets, but the end results are the table, object, and image file projections in Azure Storage.
2121

22-
:::image type="content" source="media/knowledge-store-concept-intro/projections-azure-storage.png" alt-text="Projections expressed in Azure Storage" border="true":::
22+
:::image type="content" source="media/knowledge-store-concept-intro/kstore-in-storage-explorer.png" alt-text="Projections expressed in Azure Storage" border="true":::
2323

2424
## Types of projections and usage
2525

@@ -138,7 +138,7 @@ Projections have a lifecycle that is tied to the source data in your data source
138138

139139
After the indexer is run, connect to projections and consume the data in other apps and workloads.
140140

141-
+ Use [Storage Explorer](knowledge-store-view-storage-explorer.md) to verify object creation and content.
141+
+ Use [Storage Browser](knowledge-store-view-storage-explorer.md) to verify object creation and content.
142142

143143
+ Use [Power BI for data exploration](knowledge-store-connect-power-bi.md). This tool works best when the data is in Azure Table Storage. Within Power BI, you can manipulate data into new tables that are easier to query and analyze.
144144

articles/search/knowledge-store-projections-examples.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -268,7 +268,7 @@ You can process projections by following these steps:
268268

269269
1. [Monitor indexer execution](search-howto-monitor-indexers.md) to check progress and catch any errors.
270270

271-
1. [Use Storage Explorer](knowledge-store-view-storage-explorer.md) to verify object creation in Azure Storage.
271+
1. [Use Storage Browser](knowledge-store-view-storage-explorer.md) to verify object creation in Azure Storage.
272272

273273
1. If you are projecting tables, [import them into Power BI](knowledge-store-connect-power-bi.md) for table manipulation and visualization. In most cases, Power BI will auto-discover the relationships among tables.
274274

articles/search/knowledge-store-view-storage-explorer.md

Lines changed: 13 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,39 @@
11
---
2-
title: View a knowledge store with Storage Explorer
2+
title: View a knowledge store
33
titleSuffix: Azure Cognitive Search
4-
description: View and analyze an Azure Cognitive Search knowledge store with the Azure portal's Storage Explorer.
4+
description: View a knowledge store using the Storage Browser in the Azure portal.
55

66
manager: nitinme
77
author: HeidiSteen
88
ms.author: heidist
99
ms.service: cognitive-search
1010
ms.topic: conceptual
11-
ms.date: 10/15/2021
11+
ms.date: 11/03/2021
1212
---
1313

14-
# View a knowledge store with Storage Explorer
14+
# View a knowledge store with Storage Browser
1515

16-
A [knowledge store](knowledge-store-concept-intro.md) is content created by an Azure Cognitive Search skillset and saved to Azure Storage. In this article, you'll learn how to view the contents of a knowledge store using Storage Explorer in the Azure portal.
16+
A [knowledge store](knowledge-store-concept-intro.md) is content created by an Azure Cognitive Search skillset and saved to Azure Storage. In this article, you'll learn how to view the contents of a knowledge store using Storage Browser in the Azure portal.
1717

1818
Start with an existing knowledge store created in the [Azure portal](knowledge-store-create-portal.md) or using the [REST APIs](knowledge-store-create-rest.md). Both the portal and REST walkthroughs create a knowledge store in Azure Table Storage.
1919

20-
## Start Storage Explorer
20+
## Start Storage Browser
2121

2222
1. In the Azure portal, [open the Storage account](https://ms.portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Storage%2storageAccounts/) that you used to create the knowledge store.
2323

24-
1. In the storage account's left navigation pane, select **Storage Explorer**.
24+
1. In the storage account's left navigation pane, select **Storage Browser**.
2525

26-
## View, edit, and query tables
26+
## View and edit tables
2727

28-
1. Expand the **TABLES** list to show a list of Azure table projections that were created when you created the knowledge store. If you used the quickstart or REST article to create the knowledge store, the tables will contain content related to customer reviews of a European hotel.
28+
1. Expand **Tables** to find the table projections of your knowledge store. If you used the quickstart or REST article to create the knowledge store, the tables will contain content related to customer reviews of a European hotel.
2929

30-
1. Select a table from the list.
30+
:::image type="content" source="media/knowledge-store-concept-intro/kstore-in-storage-explorer.png" alt-text="Screenshot of Storage Browser" border="true":::
3131

32-
![View tables in Storage Explorer](media/knowledge-store-view-storage-explorer/storage-explorer-tables.png "View tables in Storage Explorer")
32+
1. Select a table from the list to views it's contents.
3333

34-
1. To change the data type, property name, or individual data values in your table, click **Edit**.
34+
1. To rearrange column order or delete a column, select **Edit columns** at the top of the page.
3535

36-
![Edit table in Storage Explorer](media/knowledge-store-view-storage-explorer/storage-explorer-edit-table.png "Edit table in Storage Explorer")
37-
38-
1. To run queries, select **Query** on the command bar and enter your conditions.
39-
40-
![Query table in Storage Explorer](media/knowledge-store-view-storage-explorer/storage-explorer-query-table.png "Query table in Storage Explorer")
41-
42-
In Storage Explorer, you can only query one table at time using [supported query syntax](/rest/api/storageservices/Querying-Tables-and-Entities). To query across tables, consider using Power BI instead.
36+
In Storage Browser, you can only query one table at time using [supported query syntax](/rest/api/storageservices/Querying-Tables-and-Entities). To query across tables, consider using Power BI instead.
4337

4438
## Next steps
4539

16.5 KB
Loading

0 commit comments

Comments
 (0)