Move your embedded app to production

Important

This article only applies to embed-for-your-customers applications. If you're using the embed-for-your-organization scenario, you need to use either a Pro or Premium license.

After you've developed your application, you need to back your workspace with a capacity before you can move to production. All workspaces (the ones containing the reports or dashboards, and the ones containing the datasets) must be assigned to a capacity.

Create a capacity

By creating a capacity, you can take advantage of having a resource for your customers. There are two types of capacities you can choose from:

  • Power BI Premium - A tenant-level Microsoft 365 subscription available in two SKU families, EM and P. When you embed Power BI content, this solution is referred to as Power BI embedding. For more information regarding this subscription, see What is Power BI Premium?.

  • Azure Power BI Embedded - A subscription that uses A SKUs. You can purchase a capacity from the Azure portal. For details about how to create a Power BI Embedded capacity, see Create Power BI Embedded capacity in the Azure portal.

    Note

    SKUs of type A don't support the use of a free Power BI license to access Power BI content.

Capacity specifications

The following table describes the resources and limits of each SKU. To determine which capacity best fits your needs, see Which solution should I choose?.

Capacity Dataset Dataflow Export API
Capacity SKUs V-cores Max memory (GB)1, 2, 3 DirectQuery/Live connection (per second)1, 2 Max memory per query (GB)1, 2 Model refresh parallelism2 Dataflow parallel tasks5 Max concurrent pages6
EM1/A1 1 3 3.75 1 5 4 20
EM2/A2 2 5 7.5 2 10 8 25
EM3/A3 4 10 15 2 20 16 35
P1/A4 8 25 30 6 40 32 55
P2/A5 16 50 60 6 80 64 95
P3/A6 32 100 120 10 160 64 175
P4/A74 64 200 240 10 320 64 200
P5/A84 128 400 480 10 640 64 200

1 The Power BI Premium Utilization and Metrics app doesn't currently expose these metrics.

2 These limits only apply to the dataset workload per capacity.

3 The Max memory (GB) column under the Dataset header represents an upper bound for the dataset size. However, an amount of memory must be reserved for operations such as refreshes and queries on the dataset. The maximum dataset size permitted on a capacity might be smaller than the numbers in this column. For more information, see Memory allocation.

4 These SKUs aren't available in all regions. To request using these SKUs in regions where they're not available, contact your Microsoft account manager.

5 Learn more about parallel tasks in dataflows.

6 See Export Power BI report to file for more information about Power BI interactive (not paginated) reports.

Development testing

For development testing, you can use free embed trial tokens with a Pro license or Premium Per User (PPU) license. To embed in a production environment, use a capacity.

Important

Free trial tokens are limited to development testing only. After going to production, a capacity must be purchased. Until a capacity is purchased, the Free trial version banner continues to appear at the top of the embedded report.

The number of embed trial tokens a Power BI service principal or master user (master account) can generate is limited. Use the Available features API to check the percentage of your current embedded usage. The usage amount is displayed per service principal or master account.

If you run out of embed tokens while testing, you need to purchase a Power BI Embedded or Premium capacity. There's no limit to the number of embed tokens you can generate with a capacity.

Assign a workspace to a capacity

After you create a capacity, you can assign your workspace to that capacity.

Each workspace that contains a Power BI item related to the embedded content (including datasets, reports, and dashboards) must be assigned to capacities. For example, if an embedded report and the dataset bound to it reside in different workspaces, both workspaces must be assigned to capacities.

Assign a workspace to a capacity by using a service principal

To assign a workspace to a capacity by using a service principal, use the Power BI REST API. When you're using the Power BI REST APIs, make sure to use the service principal object ID. The service principal should have administrator permissions for the workspace and capacity assignment permissions for the capacity.

Assign a workspace to a capacity by using a master user

You can also assign a workspace to a capacity from the settings of that workspace by using a master user. The master user must have admin permissions for that workspace, and also capacity assignment permissions for that capacity.

  1. In the Power BI service, expand Workspaces, and then scroll to the workspace you're using for embedding your content. On its More menu, select Workspace settings.

    Screenshot of the Power BI service, with the More menu of a workspace expanded. On that menu, the ellipsis and Workspace settings are highlighted.

  2. Select the Premium tab, and do the following:

    1. Under License mode, select the type of capacity you created: Premium per capacity or Embedded.

    2. Select the capacity you created.

    3. Select Save.

    Screenshot of the premium settings of a workspace in the Power BI service. A selected capacity and the Save button are highlighted.

    After you assign your workspace to a capacity, a diamond appears next to it in the Workspaces list.

    Screenshot of the Power BI service. In the Workspaces list, a diamond is visible next to the name of a workspace that has a capacity assigned to it.

Next steps