Merge pull request #266891 from davidsmatlak/ds-arg-powerbi-online-20240221

Updates quickstart with ARG Power BI service

Author: Jill Grant

articles/governance/resource-graph/index.yml

@@ -10,7 +10,7 @@ metadata:
   ms.topic: landing-page
   author: davidsmatlak
   ms.author: davidsmatlak
-  ms.date: 01/05/2024
+  ms.date: 02/22/2024
 
 landingContent:
   - title: About Azure Resource Graph
@@ -42,6 +42,8 @@ landingContent:
             url: ./first-query-rest-api.md
           - text: Create alert on ARG query
             url: ./alerts-query-quickstart.md
+          - text: Run ARG query with Power BI connector
+            url: ./power-bi-connector-quickstart.md
           - text: Share queries (Portal)
             url: ./tutorials/create-share-query.md
       - linkListType: concept

articles/governance/resource-graph/media/power-bi-connector-quickstart/power-bi-get-data.png

@@ -1,13 +1,13 @@
 ---
-title: Run queries with the Azure Resource Graph Power BI connector
+title: Run queries with Azure Resource Graph Power BI connector
 description: In this quickstart, you learn how to run queries with the Azure Resource Graph Power BI connector.
-ms.date: 01/29/2024
+ms.date: 02/22/2024
 ms.topic: quickstart
 ---
 
 # Quickstart: Run queries with the Azure Resource Graph Power BI connector
 
-In this quickstart, you learn how to run queries with the Azure Resource Graph Power BI connector. By default the Power BI connector runs queries at the tenant level but you can change the scope to subscription or management group. Resource Graph by default returns a maximum of 1,000 records but the Power BI connector has an optional setting to return all records if your query results have more than 1,000 records.
+In this quickstart, you learn how to run queries with the Azure Resource Graph Power BI connector. By default the Power BI connector runs queries at the tenant level but you can change the scope to subscription or management group. Azure Resource Graph by default returns a maximum of 1,000 records but the Power BI connector has an optional setting to return all records if your query results have more than 1,000 records.
 
 > [!NOTE]
 > The Azure Resource Graph Power BI connector is in public preview.
@@ -18,21 +18,28 @@ In this quickstart, you learn how to run queries with the Azure Resource Graph P
 ## Prerequisites
 
 - If you don't have an Azure account with an active subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
-- [Power BI Desktop](https://powerbi.microsoft.com/desktop/).
-- Azure role-based access control rights with at least _Reader_ role assignment to resources. Learn more about [how to assign roles](../../role-based-access-control/role-assignments-portal.md).
+- [Power BI Desktop](https://powerbi.microsoft.com/desktop/) or a [Power BI service](https://app.powerbi.com/) workspace in your organization's tenant.
+- Azure role-based access control rights with at least _Reader_ role assignment to resources. To learn more about role assignments, go to [Assign Azure roles using the Azure portal](../../role-based-access-control/role-assignments-portal.md).
 
-## Connect Resource Graph with Power BI connector
+## Connect Azure Resource Graph with Power BI connector
 
-After Power BI Desktop is installed, you can connect Resource Graph with Power BI connector so that you can run a query. If you don't have a query to run, you can use the following sample that queries for storage accounts.
+You can run queries with Power BI Desktop or Power BI service. Don't use comments when you enter a query.
+
+If you don't have a query, you can use the following sample that queries for storage accounts:
 
 ```kusto
 resources
 | where type == 'microsoft.storage/storageaccounts'
 ```
 
+# [Power BI Desktop](#tab/power-bi-desktop)
+
+After Power BI Desktop is installed, you can connect Azure Resource Graph with Power BI connector so that you can run a query.
+
 The following example runs a query with the default settings.
 
 1. Open the Power BI Desktop app on your computer and close any dialog boxes that are displayed.
+1. Select **Home** > **Options and settings** > **Data source settings**.
 1. Go to **Home** > **Get data** > **More** > **Azure** > **Azure Resource Graph** and select **Connect**.
 
    :::image type="content" source="./media/power-bi-connector-quickstart/power-bi-get-data.png" alt-text="Screenshot of the get data dialog box in Power BI Desktop to select the Azure Resource Graph connector.":::
@@ -41,13 +48,35 @@ The following example runs a query with the default settings.
 
    :::image type="content" source="./media/power-bi-connector-quickstart/query-dialog-box.png" alt-text="Screenshot of the Azure Resource Graph dialog box to enter a query and use the default settings.":::
 
-1. Select **OK** to run the query and if prompted, enter your credentials.
-1. Select **Connect** to run the query. The results are displayed in Power BI Desktop.
+1. Select **OK**. If prompted, enter your credentials and select **Connect** to run the query.
 1. Select **Load** or **Transform Data**.
 
    - **Load** imports the query results into Power BI Desktop.
    - **Transform Data** opens the Power Query Editor with your query results.
 
+# [Power BI service](#tab/power-bi-service)
+
+You need a workspace with _Dataflow_ so you can connect Azure Resource Graph with Power BI connector and run a query.
+
+1. Go to your organization's [Power BI service](https://app.powerbi.com/).
+1. Open a workspace and select **New** > **Dataflow**.
+1. Select **Add new tables** from **Define new tables**.
+1. In **Choose data source** type _azure resource graph_ to search for the connector.
+
+   :::image type="content" source="./media/power-bi-connector-quickstart/power-bi-service-get-data.png" alt-text="Screenshot of the get data dialog box in Power BI service to select the Azure Resource Graph connector.":::
+
+1. Select **Azure Resource Graph**.
+1. Enter a query into the **Query** box. You can copy and paste the query.
+
+   :::image type="content" source="./media/power-bi-connector-quickstart/power-bi-service-query-dialog-box.png" alt-text="Screenshot of the Power BI service Azure Resource Graph dialog box to enter a query and use the default settings.":::
+
+1. Select **Sign in** to authenticate with your Organizational account.
+1. Select **Next** to run the query.
+
+The results are displayed in Power Query. You can select to save or cancel.
+
+---
+
 ## Use optional settings
 
 You can select optional values to change the Azure subscription or management group that the query runs against or to get query results of more than 1,000 records.
@@ -57,24 +86,33 @@ You can select optional values to change the Azure subscription or management gr
 | Scope | You can select subscription or management group. Tenant is the default scope when no selection is made. |
 | Subscription ID | Required if you select subscription scope. Specify the Azure subscription ID. Use a comma-separated list to query multiple subscriptions. |
 | Management group ID | Required if you select management group scope. Specify the Azure management group ID. Use a comma-separated list to query multiple management groups. |
-| Advanced options | To get more than 1,000 records change `$resultTruncated` to `FALSE`. By default Resource Graph returns a maximum of 1,000 records. |
+| Advanced options | To get more than 1,000 records change `$resultTruncated` to `FALSE`. By default Azure Resource Graph returns a maximum of 1,000 records. |
 
 For example, to run a query for a subscription that returns more than 1,000 records:
 
 - Set the scope to subscription.
 - Enter a subscription ID.
 - Set `$resultTruncated` to `FALSE`.
 
-:::image type="content" source="./media/power-bi-connector-quickstart/query-dialog-box-options.png" alt-text="Screenshot of the Azure Resource Graph dialog box to enter a query and use optional settings for scope, subscription ID, and $resultTruncated.":::
+# [Power BI Desktop](#tab/power-bi-desktop)
+
+:::image type="content" source="./media/power-bi-connector-quickstart/query-dialog-box-options.png" alt-text="Screenshot of the Power BI Desktop Azure Resource Graph dialog box for a query using optional settings for scope, subscription ID, and $resultTruncated.":::
+
+# [Power BI service](#tab/power-bi-service)
+
+:::image type="content" source="./media/power-bi-connector-quickstart/power-bi-service-dialog-box-options.png" alt-text="Screenshot of the Power BI service Azure Resource Graph dialog box for a query using optional settings for scope, subscription ID, and $resultTruncated.":::
+
+---
 
 ## Clean up resources
 
 When you're finished, close any Power BI Desktop or Power Query windows and save or discard your queries.
 
-## Related content
+## Next steps
 
 For more information about the query language or how to explore resources, go to the following articles.
 
+- [Power BI connector troubleshooting guide](./troubleshoot/power-bi-connector.md).
 - [Understanding the Azure Resource Graph query language](./concepts/query-language.md).
 - [Explore your Azure resources with Resource Graph](./concepts/explore-resources.md).
 - Sample queries listed by [table](./samples/samples-by-table.md) or [category](./samples/samples-by-category.md).

articles/governance/resource-graph/media/power-bi-connector-quickstart/power-bi-service-dialog-box-options.png

@@ -39,7 +39,7 @@
     displayName: alerts, portal, resource graph, monitor, log analytics, query
     href: ./alerts-query-quickstart.md
   - name: Run ARG query with Power BI connector
-    displayName: portal, resource graph, query, power bi
+    displayName: portal, resource graph, query, power bi connector
     href: ./power-bi-connector-quickstart.md
 - name: Tutorials
   items:
@@ -89,11 +89,14 @@
 - name: Troubleshoot
   items:
   - name: Alerts
-    displayName: alerts, portal, resource graph, monitor, log analytics, query, error, violation
+    displayName: alerts, portal, resource graph, monitor, log analytics, query, error, violation, troubleshoot
     href: ./troubleshoot/alerts.md
   - name: Common issues
-    displayName: errors, violation
+    displayName: errors, violation, troubleshoot
     href: ./troubleshoot/general.md
+  - name: Power BI connector
+    displayName: errors, violation, troubleshoot, power bi connector
+    href: ./troubleshoot/power-bi-connector.md
 - name: Reference
   items:
   - name: Keyboard shortcuts

articles/governance/resource-graph/media/power-bi-connector-quickstart/power-bi-service-get-data.png

@@ -0,0 +1,62 @@
+---
+title: Troubleshoot Azure Resource Graph Power BI connector
+description: Learn how to troubleshoot issues with Azure Resource Graph Power BI connector.
+ms.date: 02/22/2024
+ms.topic: troubleshooting
+---
+
+# Troubleshoot Azure Resource Graph Power BI connector
+
+> [!NOTE]
+> The Azure Resource Graph Power BI connector is in public preview.
+
+The following descriptions help you troubleshoot Azure Resource Graph (ARG) data connector in Power BI.
+
+## Connector availability
+
+The ARG Power BI connector isn't available in all Power BI products and versions.
+
+| Version | Products |
+| ---- | ---- |
+| 2.123.x <br> (November 2023) or later | Power BI Datasets (Desktop + Service) <br> Power BI (Dataflows) <br> Fabric (Dataflow Gen2) |
+
+
+ARG Power BI connector isn't available in the following products:
+
+- Excel
+- Power Apps (Dataflows)
+- Dynamic 365 Customer Insights
+- Analysis Services
+
+## Supported capabilities
+
+The ARG Power BI connector only supports [import connections](/power-bi/connect-data/desktop-directquery-about#import-connections). The ARG Power BI connector doesn't support `DirectQuery` connections. For more information about connectivity modes and their differences, go to [DirectQuery in Power BI](/power-bi/connect-data/desktop-directquery-about).
+
+## Load times and throttling
+
+The load time for ARG queries in Power BI is contingent on the query size. Larger query results might lead to extended load times.
+
+If you're experiencing a 429 error, which is due to throttling, go to [Guidance for throttled requests in Azure Resource Graph](../concepts/guidance-for-throttled-requests.md).
+
+## Unexpected Results
+
+If your query yields unexpected or inaccurate results, consider the following scenarios:
+
+- **Verify permissions**: Confirm that your [Azure role-based access control (Azure RBAC) permissions](../../../role-based-access-control/overview.md) are accurate. Ensure you have at least read access to the resources you want to query. Queries don't return results without adequate permissions to the Azure object or object group.
+- **Check for comments**: Review your query and remove any comments (`//`) because Power BI doesn't support Kusto comments. Comments might affect your query results.
+- **Compare results**: For parity checks, run your query in both the ARG Explorer in Azure portal and the ARG Power BI connector. Compare the results obtained from both platforms for consistency.
+
+## Errors
+
+The ARG connector's query capability behaves the same at [ARG Explorer](../first-query-portal.md) in the Azure portal. For information about ARG common errors, go to the [troubleshooting guide](general.md#general-errors).
+
+For Power BI errors, go to [common issues](/power-query/common-issues).
+
+The following table contains descriptions of common ARG Power BI connector errors.
+
+| Error | Description |
+| ---- | ---- |
+| Invalid query | Query that was entered isn't valid. Check the syntax of your query and refer to the ARG [Kusto Query Language (KQL)](../concepts/query-language.md#supported-kql-language-elements) for guidance. |
+| Scope check | If you're querying at the tenant scope, delete all inputs in the subscription ID or management group ID fields. <br> <br> If you have inputs in the subscriptions ID or management group ID fields that you want to filter for, select either subscription or management group from the drop-down scope field. |
+| Scope subscription mismatch | The subscription scope was selected from the scope drop-down field but a management group ID was entered. |
+| Scope management group mismatch | The management group scope was selected from the scope drop-down field but a subscription ID was entered. |