Merge pull request #95111 from KingdomOfEnds/tsi-power-bi-connector

power bi articles

Author: TedA-M

articles/time-series-insights/TOC.yml

@@ -17,6 +17,10 @@
       href: time-series-insights-update-quickstart.md  
 - name: Tutorials
   items:
+  - name: Time Series Insights JavaScript client library
+    href: tutorial-explore-js-client-lib.md
+  - name: Create a single-page web app
+    href: tutorial-create-tsi-sample-spa.md
   - name: Azure Time Series Insights GA
     items:
     - name: Create a Time Series Insights environment
@@ -67,6 +71,8 @@
         href: time-series-insights-authentication-and-authorization.md
       - name: Query data by using C#
         href: time-series-insights-update-query-data-csharp.md
+      - name: Power BI integration
+        href: concepts-power-bi.md
 - name: How-to guides
   items:
   - name: Grant data access
@@ -107,6 +113,8 @@
       href: time-series-insights-update-how-to-tsm.md
     - name: Shape JSON for queries
       href: time-series-insights-update-how-to-shape-events.md
+    - name: Connect to Power BI
+      href: how-to-connect-power-bi.md
 - name: Reference
   items:
   - name: Time Series Insights 

articles/time-series-insights/concepts-power-bi.md

@@ -0,0 +1,55 @@
+---
+title: 'Power BI integration - Azure Time Series Insights | Microsoft Docs'
+description: Learn about Power BI integration in Azure Time Series Insight.
+author: deepakpalled
+ms.author: dpalled
+manager: cshankar
+services: time-series-insights
+ms.service: time-series-insights
+ms.topic: conceptual
+ms.date: 11/13/2019
+---
+
+# Connect Time Series Insights to Power BI  
+ 
+Are you looking for a solution to help correlate your time-series data, create vivid visualizations, and share insights across your organization?
+
+Time Series Insights now seamlessly integrates with [Power BI](https://powerbi.microsoft.com/), providing you with more powerful visualization and dashboarding capabilities over your streaming data and allows you to share insights and results across your organization.
+
+   [![Export option in Time Series Insights](./media/concepts-connect-power-bi/tsi-power-bi-export-example.png)](./media/concepts-connect-power-bi/tsi-power-bi-export-example.png#lightbox)
+
+By connecting your data to Power BI, you can now:
+
+* Perform correlations with other data sources supported by Power BI and access a host of different data visualization options. 
+* Create Power BI dashboards and reports using your Time Series Insight data, and share them with your organization. 
+* Unlock data interop scenarios in a simple, easy-to-use manner, and get to insights faster than ever.
+* Modify Time Series Insights data within Power BI using the powerful Advanced Editor.
+
+## Native Connector
+
+Connecting your data takes less than a minute. By quickly exporting your view from Time Series Insight Explorer to Power BI, anyone in your organization can intuitively access and visually transform data.
+
+Configuration options include choosing between **Raw** and **Aggregate-level** data and selecting a desired time range. 
+
+Once data has been connected, all of Power BI's rich visualization and charting tools are available to further enhance your information sharing capabilities. 
+
+   [![Charting examples in Power BI](./media/concepts-connect-power-bi/power-bi-tsi-example.png)](./media/concepts-connect-power-bi/power-bi-tsi-example.png#lightbox)
+
+Read [How to connect Time Series Insights to Power BI](./how-to-connect-power-bi.md) for step-by-step specifics.
+
+## Flexible Workflow
+ 
+Use the connector from anywhere in your workflow:
+
+* If you are in Time Series Insights Explorer, you can quickly export your view to Power BI. 
+* If you are already in Power BI, augment your existing visualization scenarios using Time Series Insights query data.
+
+For advanced querying and editing functionality within Power BI, use Power BI’s Advanced Editor.
+
+## Next Steps
+
+* Read [How to connect Time Series Insights to Power BI](./how-to-connect-power-bi.md).
+
+* Learn more about [Power BI](https://docs.microsoft.com/power-bi/).
+
+* Download [Power BI desktop](https://powerbi.microsoft.com/desktop/) and begin to connect your data.

articles/time-series-insights/how-to-connect-power-bi.md

@@ -0,0 +1,142 @@
+---
+title: 'Connect your environment to Power BI - Azure Time Series Insights | Microsoft Docs'
+description: Learn how to connect Azure Time Series Insights to Power BI to share, chart, and display data across your organization.
+author: deepakpalled
+ms.author: dpalled
+manager: cshankar
+services: time-series-insights
+ms.service: time-series-insights
+ms.topic: conceptual
+ms.date: 11/12/2019
+
+# Customer intent: As a data analyst or developer, I want to learn how to connect Azure Time Series Insights to Power BI to share and display data.
+---
+
+# Visualize data from Time Series Insights in Power BI
+
+Azure Time Series Insights is a platform for storing, managing, querying, and visualizing time-series data in the cloud. [Power BI](https://powerbi.microsoft.com) is a business analytics tool with rich visualization capabilities that allows you to share insights and results across your organization. Both services can now be integrated to get the best of both Time Series Insights' inherent visualization capabilities as well as Power BI's.
+
+You'll learn how to:
+
+* Connect Time Series Insights to Power BI using the cloud connector
+* Create visuals with your data in Power BI
+* Publish the report to Power BI and share with the rest of your organization
+
+By the end, you'll learn how to visualize time-series data through Azure Time Series Insights and enhance it with the strong data visualization and easy sharing capabilities of Power BI.
+
+Make sure to sign up for a [free Azure subscription](https://azure.microsoft.com/free/) if you don't already have one.
+
+## Prerequisites
+
+* Download and install the latest version of [Power BI Desktop](https://powerbi.microsoft.com/downloads/)
+* Have or create an [Azure Time Series Insights GA instance](time-series-insights-get-started.md) or [Azure Time Series Insights Preview instance](time-series-insights-update-how-to-manage.md)
+
+## Connect data from Time Series Insights to Power BI
+
+To connect your Time Series Insights environment to Power BI, follow these steps:
+
+1. Open Time Series Insights Explorer                      
+1. Export data as a query or as raw data                       
+1. Open Power BI Desktop
+1. Load from Custom Query
+
+### Export data into Power BI desktop
+
+To get started:
+
+1. Open the Time Series Insights Preview Explorer and curate your data.
+1. Once you have created a view you are satisfied with, navigate to the **More Actions** dropdown menu and click on **Connect to Power BI**. 
+
+    [![Time Series Insights Preview Explorer export](media/how-to-connect-power-bi/time-series-insights-export-option.png)](media/how-to-connect-power-bi/time-series-insights-export-option.png#lightbox)
+
+1. Set your parameters inside this tab:
+
+   1. Specify a relative timeframe to view. If you are happy with your existing view, leave this as **Existing timeframe**. 
+   1. Choose between **Aggregated** and **Raw Events**. 
+   
+       > [!NOTE]
+       > You can always aggregate your data later in Power BI, but you cannot revert to raw data after aggregation. 
+       
+       > [!NOTE]
+       > There is a 100-K event count limit for Raw Event level data.
+
+       [![Connect](media/how-to-connect-power-bi/connect-to-power-bi.png)](media/how-to-connect-power-bi/connect-to-power-bi.png#lightbox)
+
+   1. If you have not configured your Time Series Insights instance for warm store, you will receive a warning.
+
+       [![Connect](media/how-to-connect-power-bi/connect-to-power-bi-warning.png)](media/how-to-connect-power-bi/connect-to-power-bi-warning.png#lightbox)
+
+       > [!TIP]
+       > You may configure your existing instance for warm store in the Azure portal.
+
+1. Select **Copy query to clipboard**.
+1. Now, launch Power BI Desktop.
+1. In Power BI Desktop on the **Home** tab, select **Get Data** in the upper left corner, then **More**.
+
+    [![Home dropdown](media/how-to-connect-power-bi/power-bi-home-drop-down.png)](media/how-to-connect-power-bi/power-bi-home-drop-down.png#lightbox)
+
+1. Search for **Time Series Insights**, select **Azure Time Series Insights (Beta)**, then **Connect**.
+
+    [![Connect Power BI to Time Series Insights](media/how-to-connect-power-bi/connect-to-time-series-insights.png)](media/how-to-connect-power-bi/connect-to-time-series-insights.png#lightbox)
+
+    Alternatively, navigate to the **Azure** tab, select **Azure Time Series Insights (Beta)**, then **Connect**.
+    
+1. A message dialogue box will display asking for permission to connect to third-party resources. Select **continue**.
+
+    [![Choose Create Custom Query](media/how-to-connect-power-bi/confirm-the-connection.png)](media/how-to-connect-power-bi/confirm-the-connection.png#lightbox)
+
+1. In the dropdown menu under **Data Source**, choose **Create custom query**. Paste from your clipboard into the optional **Custom Query (optional)** field below, then press **OK**.
+
+    [![Pass in the custom query and select OK](media/how-to-connect-power-bi/custom-query-load.png)](media/how-to-connect-power-bi/custom-query-load.png#lightbox)  
+
+1. The data table will now load. Press **Load** to load into Power BI.
+
+    [![Review the loaded data in the table and select Load](media/how-to-connect-power-bi/review-the-loaded-data-table.png)](media/how-to-connect-power-bi/review-the-loaded-data-table.png#lightbox)  
+
+If you have completed these steps, skip ahead to the next section.
+
+## Create a report with visuals
+
+Now that you have imported the data into Power BI, it’s time to build a report with visuals.
+
+1. On the left side of the window, make sure you have selected the **Report** view.
+
+    [![Select the Report View](media/how-to-connect-power-bi/select-the-report-view.png)](media/how-to-connect-power-bi/select-the-report-view.png#lightbox)
+
+1.	In the **Visualizations** column, select your visual of choice. For example, select **Line chart**. This will add a blank line chart to your canvas.
+ 
+1.	In the **Fields** list, select **Timestamp** and drag it to the **Axis** field to display items along the X-axis.
+
+1.	Again, in the **Fields** list, select **TimeSeriesId** and drag it to the **Values** field to display items along the Y-axis.
+
+    [![Create a line chart](media/how-to-connect-power-bi/power-bi-line-chart.png)](media/how-to-connect-power-bi/power-bi-line-chart.png#lightbox)
+
+1.	To add another chart to your canvas, click anywhere on the canvas outside the line chart and repeat this process.
+
+    [![Create additional charts to share](media/how-to-connect-power-bi/power-bi-additional-charts.png)](media/how-to-connect-power-bi/power-bi-additional-charts.png#lightbox)
+
+Once you have created your report, you can publish it to Power BI Reporting Services.
+
+## Advanced editing
+
+If you have already loaded a dataset in Power BI but would like to modify the query (such as the date/time or Environment ID parameters), you can do this via Power BI’s Advanced Editor functionality. Refer to the [Power BI documentation](https://docs.microsoft.com/power-bi/desktop-query-overview) to learn more.
+
+As an overview:
+
+1. In Power BI Desktop, select **Edit Queries**.
+1. Press **Advanced Editor**.
+
+    [![Edit queries in the Advanced Editor](media/how-to-connect-power-bi/power-bi-advanced-query-editing.png)](media/how-to-connect-power-bi/power-bi-advanced-query-editing.png#lightbox)
+
+1. Modify the JSON payload as desired.
+1. Select **Done** and then **Close & Apply** within the **Power Query Editor Window**.
+
+You should see the desired changes applied.  
+
+## Next Steps
+
+* Read about [Power BI connector concepts](https://docs.microsoft.com/power-bi/desktop-query-overview) for Azure Time Series Insights.
+
+* Learn more about [Power BI desktop](https://docs.microsoft.com/power-bi/desktop-query-overview).
+
+* See [Time Series Insights GA Explorer](https://docs.microsoft.com/azure/time-series-insights/time-series-quickstart) and [Time Series Insights Preview Explorer](https://docs.microsoft.com/azure/time-series-insights/time-series-insights-update-quickstart).