Merge pull request #87631 from LisaLeib/lisaleib-ks

Lisaleib ks

Author: ktoliver

.openpublishing.redirection.json

@@ -1780,6 +1780,11 @@
       "redirect_url": "/azure/search/search-get-started-postman",
       "redirect_document_id": false
     },
+    {
+      "source_path": "articles/search/knowledge-store-connect-powerbi.md",
+      "redirect_url": "/azure/search/knowledge-store-create-portal",
+      "redirect_document_id": true
+    },
     {
       "source_path": "articles/search/search-create-index-rest-api.md",
       "redirect_url": "/azure/search/search-get-started-powershell",

articles/search/TOC.yml

@@ -241,10 +241,14 @@
       href: cognitive-search-resources-documentation.md
   - name: Knowledge store (preview)
     items:
-    - name: Connect using Power BI
-      href: knowledge-store-connect-powerbi.md
+    - name: Create a knowledge store in Azure portal
+      href: knowledge-store-create-portal.md
     - name: Create using REST and Postman
       href: knowledge-store-howto.md
+    - name: View with Storage Explorer
+      href: knowledge-store-view-storage-explorer.md
+    - name: Connect with Power BI
+      href: knowledge-store-connect-power-bi.md
   - name: Query data
     items:
     - name: Create a basic query

articles/search/knowledge-store-connect-power-bi.md

@@ -0,0 +1,109 @@
+---
+title: 'Connect to a knowledge store with Power BI - Azure Search'
+description: Connect an Azure Search knowledge store with Power BI for analysis and exploration.
+
+author: lisaleib
+services: search
+ms.service: search
+ms.subservice: cognitive-search
+ms.topic: tutorial
+ms.date: 09/03/2019
+ms.author: v-lilei
+ 
+---
+# Connect a knowledge store with Power BI
+
+> [!Note]
+> Knowledge store is in preview and should not be used in production. The [Azure Search REST API version 2019-05-06-Preview](search-api-preview.md) provides this feature. There is no .NET SDK support at this time.
+>
+In this article, you'll learn how to connect and explore a knowledge store using Power Query in the Power BI Desktop app. To create the knowledge store sample used in this walkthrough, see [Create a knowledge store in Azure portal](knowledge-store-create-portal.md).
+
+## Prerequisites
+
++ Follow the steps in [Create a knowledge store in the Azure portal](knowledge-store-create-portal.md) to create the sample knowledge store used in this walkthrough. You will also need the name of the Azure storage account that you used to create the knowledge store, along with its access key from the Azure portal.
+
++ [Install Power BI Desktop](https://powerbi.microsoft.com/downloads/)
+
+## Connect with Power BI
+
+1. Start Power BI Desktop and click **Get data**.
+
+1. In the **Get Data** window, select **Azure**, and then select **Azure Table Storage**.
+
+1. Click **Connect**.
+
+1. For **Account Name or URL**, enter in your Azure Storage account name (the full URL will be created for you).
+
+1. If prompted, enter the storage account key.
+
+1. Select the *hotelReviewsSsDocument*, *hotelReviewsSsKeyPhrases*, and *hotelReviewsSsPages* tables. These tables are Azure table projections of the hotel reviews sample data and include the cognitive service enrichments that were selected when the knowledge store was created.
+
+1. Click **Load**.
+
+1. On the top ribbon, click **Edit Queries** to open the **Power Query Editor**.
+
+   ![Open Power Query](media/knowledge-store-connect-power-bi/powerbi-edit-queries.png "Open Power Query")
+
+1. Select *hotelReviewsSsDocument*, and then remove the *PartitionKey*, *RowKey*, and *Timestamp* columns. 
+
+   ![Edit tables](media/knowledge-store-connect-power-bi/powerbi-edit-table.png "Edit tables")
+
+1. Click the icon with opposing arrows at the upper right side of the table to expand the *Content*. When the list of columns appears, select all columns, and then deselect columns that start with 'metadata'. Click **OK** to show the selected columns.
+
+   ![Edit tables](media/knowledge-store-connect-power-bi/powerbi-expand-content-table.png "Expand content")
+
+1. Change the data type for the following columns by clicking the  ABC-123 icon at the top left of the column.
+
+   + For *content.latitude* and *Content.longitude*, select **Decimal Number**.
+   + For *Content.reviews_date* and *Content.reviews_dateAdded*,  select **Date/Time**.
+
+   ![Change data types](media/knowledge-store-connect-power-bi/powerbi-change-type.png "Change data types")
+
+1. Select *hotelReviewsSsPages*, and then repeat steps 9 and 10 to delete the columns and expand the *Content*.
+1. Change the data type for *Content.SentimentScore* to **Decimal Number**.
+1. Select *hotelReviewsSsKeyPhrases* and repeat steps 9 and 10 to delete the columns and expand the *Content*. There are no data type modifications for this table.
+
+1. On the command bar, click **Close and Apply**.
+
+1. Click on the Model tile on the left navigation pane and validate that Power BI shows relationships between all three tables.
+
+   ![Validate relationships](media/knowledge-store-connect-power-bi/powerbi-relationships.png "Validate relationships")
+
+1. Double-click each relationship and make sure that the **Cross-filter direction** is set to **Both**.  This enables your visuals to refresh when a filter is applied.
+
+<!-- ## Try with larger data sets
+
+We purposely kept the data set small to avoid charges for a demo walkthrough. For a more realistic experience, you can create and then attach a billable Cognitive Services resource to enable a larger number of transactions against the sentiment analyzer, keyphrase extraction, and language detector skills.
+
+Create new containers in Azure Blob storage and upload each CSV file to its own container. Specify one of these containers in the data source creation step in Import data wizard.
+
+| Description | Link |
+|-------------|------|
+| Free tier   | [HotelReviews_Free.csv](https://knowledgestoredemo.blob.core.windows.net/hotel-reviews/HotelReviews_Free.csv?st=2019-07-29T17%3A51%3A30Z&se=2021-07-30T17%3A51%3A00Z&sp=rl&sv=2018-03-28&sr=c&sig=LnWLXqFkPNeuuMgnohiz3jfW4ijePeT5m2SiQDdwDaQ%3D) |
+| Small (500 Records) | [HotelReviews_Small.csv](https://knowledgestoredemo.blob.core.windows.net/hotel-reviews/HotelReviews_Small.csv?st=2019-07-29T17%3A51%3A30Z&se=2021-07-30T17%3A51%3A00Z&sp=rl&sv=2018-03-28&sr=c&sig=LnWLXqFkPNeuuMgnohiz3jfW4ijePeT5m2SiQDdwDaQ%3D) |
+| Medium (6000 Records)| [HotelReviews_Medium.csv](https://knowledgestoredemo.blob.core.windows.net/hotel-reviews/HotelReviews_Medium.csv?st=2019-07-29T17%3A51%3A30Z&se=2021-07-30T17%3A51%3A00Z&sp=rl&sv=2018-03-28&sr=c&sig=LnWLXqFkPNeuuMgnohiz3jfW4ijePeT5m2SiQDdwDaQ%3D)
+| Large (Full dataset 35000 Records) | [HotelReviews_Large.csv](https://knowledgestoredemo.blob.core.windows.net/hotel-reviews/HotelReviews_Large.csv?st=2019-07-29T17%3A51%3A30Z&se=2021-07-30T17%3A51%3A00Z&sp=rl&sv=2018-03-28&sr=c&sig=LnWLXqFkPNeuuMgnohiz3jfW4ijePeT5m2SiQDdwDaQ%3D). Be aware that very large data sets are expensive to process. This one costs roughly $1000 U.S dollars.|
+
+In the enrichment step of the wizard, attach a billable [Cognitive Services](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) resource, created at the *S0* tier, in the same region as Azure Search to use larger data sets. 
+
+  ![Create a Cognitive Services resource](media/knowledge-store-connect-power-bi/create-cognitive-service.png "Create a Cognitive Services resource") -->
+
+## Clean up
+
+When you're working in your own subscription, it's a good idea at the end of a project to identify whether you still need the resources you created. Resources left running can cost you money. You can delete resources individually or delete the resource group to delete the entire set of resources.
+
+You can find and manage resources in the portal, using the **All resources** or **Resource groups** link in the left-navigation pane.
+
+If you are using a free service, remember that you are limited to three indexes, indexers, and data sources. You can delete individual items in the portal to stay under the limit.
+
+## Next steps
+
+To learn how to explore this knowledge store using Storage Explorer, see the following article.
+
+> [!div class="nextstepaction"]
+> [View with Storage Explorer](knowledge-store-view-storage-explorer.md)
+
+To learn how to create a knowledge store using the REST APIs and Postman, see the following article.  
+
+> [!div class="nextstepaction"]
+> [Create a knowledge store in REST](knowledge-store-howto.md)