Oktatóanyag: Power BI tartalom beágyazása egy alkalmazásba az ügyfelek számáraTutorial: Embed Power BI content into an application for your customers

Az Azure-beli Power BI Embedded segítségével jelentéseket, irányítópultokat és csempéket ágyazhat be alkalmazásokba az alkalmazás tulajdonában lévő adatokkal.With Power BI Embedded in Azure, you can embed reports, dashboards, or tiles into an application using app owns data. Az alkalmazás tulajdonában lévő adatok esetében egy alkalmazás a Power BI-t használja beágyazott elemzőplatformként.App owns data is about having an application that uses Power BI as its embedded analytics platform. ISV-fejlesztőként létrehozhat olyan Power BI-tartalmakat, amelyek jelentéseket, irányítópultokat vagy csempéket jelenítenek meg egy teljes mértékben integrált és interaktív alkalmazásban anélkül, hogy a felhasználóknak Power BI-licenccel kellene rendelkeznie.As an ISV developer, you can create Power BI content that displays reports, dashboards, or tiles in an application that is fully integrated and interactive, without requiring users to have a Power BI license. Ez az oktatóanyag bemutatja, hogyan integrálhat jelentést ügyfelei által használt alkalmazásokba a Power BI .NET SDK és a Power BI JavaScript API segítségével, az Azure-beli Power BI Embedded használatával.This tutorial demonstrates how to integrate a report into an application using the Power BI .NET SDK with the Power BI JavaScript API using Power BI Embedded in Azure for your customers.

Power BI jelentés beágyazása

Az oktatóanyag a következőket ismerteti:In this tutorial, you learn how to:

  • Alkalmazás regisztrálása az Azure-ban.Register an application in Azure.
  • Ágyazzon be egy Power BI-jelentést egy alkalmazásba.Embed a Power BI report into an application.

ElőfeltételekPrerequisites

Első lépésként, rendelkeznie kell az alábbiakkal:To get started, you're required to have:

Ha még nem regisztrált a Power BI Pro szolgáltatásra, a kezdés előtt hozzon létre egy ingyenes próbaverziós fiókot.If you're not signed up for Power BI Pro, sign up for a free trial before you begin.

Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.If you don’t have an Azure subscription, create a free account before you begin.

A beágyazott elemzési fejlesztési környezet beállításaSet up your embedded analytics development environment

Mielőtt jelentéseket, irányítópultokat vagy csempéket ágyazna az alkalmazásba, győződjön meg arról, hogy a környezete engedélyezi a beágyazást a Power BI-jal.Before you start embedding reports, dashboard, or tiles into your application, you need to make sure your environment allows for embedding with Power BI.

Az első lépések gyors elsajátítása érdekében követheti a beágyazáshoz szükséges telepítési eszköz lépéseit, és letölthet egy mintaalkalmazást, amely végigvezeti Önt a környezet létrehozásán és egy jelentés beágyazásán.You can go through the Embedding setup tool, so you can quickly get started and download a sample application that helps you walk through creating an environment and embedding a report.

Ha mégis a környezet manuális létrehozása mellett dönt, folytathatja az alábbiak szerint.However, if you choose to set up the environment manually, you can continue below.

Alkalmazás regisztrálása az Azure Active Directoryban (Azure AD)Register an application in Azure Active Directory (Azure AD)

Regisztrálja az alkalmazást az Azure Active Directoryban, hogy engedélyezze az alkalmazás számára a Power BI REST API-k elérését.Register your application with Azure Active Directory to allow your application access to the Power BI REST APIs. Az alkalmazás regisztrálásával identitást hozhat létre a számára, és meghatározhatja a Power BI REST-erőforrásokhoz kötődő engedélyeket.Registering your application allows you to establish an identity for your application and specify permissions to Power BI REST resources. Az alkalmazás regisztrációjának első lépései attól függően változnak, hogy egy fő fiókot vagy egy szolgáltatásnevet szeretne-e használni.Depending if you want to use a master account or service principal, determines how to get started registering an application.

A használt módszertől függ, hogy melyik típusú alkalmazást regisztrálja az Azure-ban.Depending on which method you take, affects which type of application you register in Azure.

Ha egy fő fiók használatával folytatja, akkor következő lépésként regisztráljon egy natív alkalmazást.If you proceed using a master account, then proceed with registering a Native app. Natív alkalmazást azért kell használnia, mert egy nem interaktív bejelentkezéssel dolgozik.You use a Native app because you're working with a non-interactive login.

Ha azonban továbbra is a szolgáltatásnevet használja, akkor regisztrálnia kell egy kiszolgálóoldali webalkalmazást.However, if you proceed using the service principal, you need to proceed with registering a server-side web application app. A kiszolgálóoldali webalkalmazás egy titkos alkalmazáskód létrehozásához kell regisztrálnia.You register a server-side web application to create an application secret.

A Power BI-környezet beállításaSet up your Power BI environment

Alkalmazás-munkaterület létrehozásaCreate an app workspace

Ha jelentéseket, irányítópultokat vagy csempéket ágyaz be az ügyfelek számára, akkor ezeket a tartalmakat egy alkalmazás-munkaterületre kell helyezni.If you're embedding reports, dashboards, or tiles for your customers, then you have to place your content within an app workspace. Különböző típusú munkaterületeket állíthat be: hagyományos munkaterületeket vagy új munkaterületeket.There are different types of workspaces that you can set up: the traditional workspaces or the new workspaces. Ha egy fiókot használ, akkor nem számít, hogy milyen típusú munkaterületet használ.If you're using a master account, then it doesn't matter which type of workspaces you use. Ha azonban szolgáltatásnevet használ az alkalmazásba való bejelentkezéshez, akkor az új munkaterületeket kell használnia.However, if you use service principal to sign into your application, then you're required to you use the new workspaces. Mindkét forgatókönyvre érvényes, hogy mind a fióknak, mind a szolgáltatásnévnek az adminisztrátorának kell lennie azoknak az alkalmazás-munkaterületeknek, amelyeket az alkalmazásához használ.In either scenario, both the master account or service principal must be an admin of the app workspaces involved with your application.

Saját jelentések létrehozása és közzétételeCreate and publish your reports

A Power BI Desktop segítségével létrehozhatja jelentéseit és adatkészleteit, majd közzéteheti ezeket a jelentéseket egy alkalmazás-munkaterületen.You can create your reports and datasets using Power BI Desktop and then publish those reports to an app workspace. Ezt a feladatot kétféleképpen végezheti el: Végfelhasználóként közzétehet jelentéseket egy fő fiókkal (hagyományos Power BI Pro-licenc) egy hagyományos alkalmazás-munkaterületen.There are two ways to accomplish this task: As an end user, you can publish reports to a traditional app workspace with a master account (Power BI Pro license). Ha szolgáltatásnevet használ, közzétehet jelentéseket az új munkaterületeken a Power BI REST API-kkal.If you're using service principal, you can publish reports to the new workspaces using the Power BI REST APIs.

Az alábbi lépések bemutatják, hogyan teheti közzé a PBIX-jelentést a Power BI munkaterületén.The below steps walk through how to publish your PBIX report to your Power BI workspace.

  1. Töltse le a Blog Demo mintát a GitHubról.Download the sample Blog Demo from GitHub.

    jelentésminta

  2. Nyissa meg a PBIX-mintajelentést a Power BI Desktopban.Open sample PBIX report in Power BI Desktop.

    PBI desktop jelentés

  3. Tegye közzé az alkalmazás-munkaterületeken.Publish to app workspaces. Ez a folyamat eltér attól függően, hogy egy fő fiókot (Power Pro-licenc) használ vagy egy szolgáltatásnevet.This process differs depending on whether you're using a master account (Power Pro license), or service principal. Ha egy fő fiókot használ, akkor közzéteheti a jelentést a Power BI Desktopban.If you're using a master account, then you can publish your report through Power BI Desktop. Ha szolgáltatásnevet használ, a Power BI REST API-kat kell használnia.Now if you're using service principal, you must use the Power BI REST APIs.

Tartalom beágyazása a mintaalkalmazássalEmbed content using the sample application

Ez a minta szándékosan egyszerű, bemutatási céllal.This sample is deliberately kept simple for demonstration purposes. Az Ön és a fejlesztők feladata védeni az alkalmazás titkos kódját vagy a fő fiók hitelesítő adatait.It's up to the you or your developers to protect the application secret or the master account credentials.

A mintaalkalmazás segítségével történő tartalombeágyazáshoz kövesse az alábbi lépéseket.Follow the steps below to start embedding your content using the sample application.

  1. Töltse le a Visual Studio 2013-as vagy újabb verzióját.Download Visual Studio (version 2013 or later). Győződjön meg róla, hogy a legújabb NuGet-csomagot tölti le.Make sure to download the latest NuGet package.

  2. A kezdéshez töltse le az App Owns Data mintát a GitHubról.Download the App Owns Data sample from GitHub to get started.

    App Owns Data alkalmazásminta

  3. Nyissa meg a Web.config fájlt a mintaalkalmazásban.Open the Web.config file in the sample application. Az alkalmazás futtatásához ki kell kitöltenie néhány mezőt.There are fields you need to fill in to run the application. A Hitelesítési típus megadásakor választhat a MasterUser és a Szolgáltatásnév közül.You can choose MasterUser or ServicePrincipal for the AuthenticationType. Attól függően, hogy milyen típusú hitelesítési módszert választott, különböző mezőket kell kitölteni.Depending on which type of authentication method you choose there are different fields to complete.

    Megjegyzés

    Az alapértelmezett Hitelesítési típus ebben a mintában a MasterUser.The default AuthenticationType in this sample is MasterUser.

    MasterUserMasterUser
    (Power BI Pro-licenc)(Power BI Pro license)
    SzolgáltatásnévServicePrincipal
    (csak az alkalmazásban használható token)(app-only token)
    applicationIdapplicationId applicationIdapplicationId
    workspaceIdworkspaceId workspaceIdworkspaceId
    jelentésazonosítóreportId jelentésazonosítóreportId
    pbiUsernamepbiUsername
    pbiPasswordpbiPassword
    applicationsecretapplicationsecret
    bérlőtenant

    Web Config fájl

AlkalmazásazonosítóApplication ID

Ez az attribútum szükséges mindkét hitelesítési típushoz (a fő fiókkal és a szolgáltatásnévvel történőhöz).This attribute is needed for both AuthenticationTypes (master account and service principal).

Az applicationId mezőbe írja be az Azure-beli alkalmazásazonosítót.Fill in the applicationId information with the Application ID from Azure. Az alkalmazás az applicationId-vel azonosítja magát azon felhasználóknak, akiktől Ön engedélyeket kér.The applicationId is used by the application to identify itself to the users from which you're requesting permissions.

Az applicationId beszerzéséhez kövesse az alábbi lépéseket:To get the applicationId, follow these steps:

  1. Jelentkezzen be az Azure Portalon.Sign into the Azure portal.

  2. A bal oldali navigációs panelen válassza a Minden szolgáltatás, majd az Alkalmazásregisztrációk elemet.In the left-hand navigation pane, select All Services, and select App Registrations.

    Alkalmazásregisztráció keresése

  3. Válassza ki azt az alkalmazást, amelynek használnia kell az applicationId azonosítót.Select the application that needs the applicationId.

    Az alkalmazás kiválasztása

  4. Van egy GUID-ként listázott alkalmazásazonosító.There's an Application ID that is listed as a GUID. Használja ezt az alkalmazásazonosítót az alkalmazás applicationId mezőjében.Use this Application ID as the applicationId for the application.

    applicationId

Munkaterület azonosítójaWorkspace ID

Ez az attribútum szükséges mindkét hitelesítési típushoz (a fő fiókkal és a szolgáltatásnévvel történőhöz).This attribute is needed for both AuthenticationTypes (master account and service principal).

A workspaceId mezőbe írja be a Power BI-ban szereplő alkalmazás-munkaterület (csoport) GUID-azonosítóját.Fill in the workspaceId information with the app workspace (group) GUID from Power BI. Ezt az információt beszerezheti az URL-címből, ha be van jelentkezve a Power BI szolgáltatásban vagy a PowerShell-lel.You can get this information either from the URL when signed into the Power BI service or using Powershell.

URL-címURL

workspaceId

PowerShellPowershell

Get-PowerBIworkspace -name "App Owns Embed Test"

a PowerShell munkaterület-azonosítója

JelentésazonosítóReport ID

Ez az attribútum szükséges mindkét hitelesítési típushoz (a fő fiókkal és a szolgáltatásnévvel történőhöz).This attribute is needed for both AuthenticationTypes (master account and service principal).

A jelentésazonosító mezőbe írja be a Power BI-ban szereplő jelentés GUID-azonosítóját.Fill in the reportId information with the report GUID from Power BI. Ezt az információt beszerezheti az URL-címből, ha be van jelentkezve a Power BI szolgáltatásban vagy a PowerShell-lel.You can get this information either from the URL when signed into the Power BI service or using Powershell.

URL-címURL

jelentésazonosító

PowerShellPowershell

Get-PowerBIworkspace -name "App Owns Embed Test" | Get-PowerBIReport

a PowerShell jelentésazonosítója

Power BI-felhasználónév és -jelszóPower BI username and password

Ezek az attribútumok csak a fő fiók hitelesítési típusához szükségesek.These attributes are needed only for the master account AuthenticationType.

Ha szolgáltatásnevet használ a hitelesítéséhez, akkor nem szükséges kitöltenie a felhasználónév és a jelszó attribútumokat.If you're using service principal to authenticate, then you don't need to fill in the username or password attributes.

  • A pbiUsername mezőbe írja be a fő Power BI-fiók nevét.Fill in the pbiUsername with the Power BI master account.
  • A pbiPassword mezőbe írja be a fő Power BI-fiók jelszavát.Fill in the pbiPassword with the password for the Power BI master account.

Alkalmazás titkos kódjaApplication secret

Ez az attribútum csak a szolgáltatásnév hitelesítési típushoz szükséges.This attribute is needed only for the service principal AuthenticationType.

Az ApplicationSecretmező tartalmát az Azure Alkalmazásregisztrációk szakaszának Kulcsok részéből másolhatja be.Fill in the ApplicationSecret information from the Keys section of your App registrations section in Azure. Ez az attribútum szolgáltatásnév használatakor működik.This attribute works when using service principal.

Az ApplicationSecret beszerzéséhez kövesse az alábbi lépéseket:To get the ApplicationSecret, follow these steps:

  1. Jelentkezzen be az Azure Portalra.Sign in to the Azure portal.

  2. A bal oldali navigációs panelen válassza a Minden szolgáltatás, majd az Alkalmazásregisztrációk elemet.In the left-hand navigation pane, select All services and then select App registrations.

    Alkalmazásregisztráció keresése

  3. Válassza ki azt az alkalmazást, amelyhez használni kívánja az ApplicationSecret kulcsot.Select the application that needs to use the ApplicationSecret.

    Alkalmazás kiválasztása

  4. A Kezelés területen válassza a Tanúsítványok és titkos kulcsok lehetőséget.Select Certificates and secrets under Manage.

  5. Válassza az Új titkos ügyfélkód elemet.Select New client secrets.

  6. A Leírás mezőbe írjon be egy nevet, és válasszon ki egy időtartamot.Enter a name in the Description box and select a duration. Ezután kattintson a Mentés gombra az alkalmazás Értékének lekéréséhez.Then select Save to get the Value for your application. Ha bezárja a Kulcsok panelt a kulcsérték mentése után, az értékmező csak rejtettként fog megjelenni.When you close the Keys pane after saving the key value, the value field shows only as hidden. Ebben az esetben nem tudja lekérni a kulcsértéket.At that point, you aren't able to retrieve the key value. Ha elveszíti kulcsértéket, hozzon létre egy újat az Azure Portalon.If you lose the key value, create a new one in the Azure portal.

    Kulcsérték

BérlőTenant

Ez az attribútum csak a szolgáltatásnév hitelesítési típushoz szükséges.This attribute is needed only for the service principal AuthenticationType.

Töltse ki a bérlő adatait az Azure-bérlőazonosítójával.Fill in the tenant information with your azure tenant ID. Ezt az információt beszerezheti az Azure AD felügyeleti központról, ha be van jelentkezve a Power BI szolgáltatásban, vagy a PowerShell használatával is.You can get this information from the Azure AD admin center when signed into the Power BI service or by using Powershell.

Alkalmazás futtatásaRun the application

  1. Válassza a Futtatás lehetőséget a Visual Studióban.Select Run in Visual Studio.

    Alkalmazás futtatása

  2. Kattintson a Jelentés beágyazása lehetőségre.Then select Embed Report. Válassza ki az alkalmazásban a jelentést, az irányítópultot vagy a csempét annak megfelelően, hogy melyiket szeretné kipróbálni.Depending on which content you choose to test with - reports, dashboards or tiles - then select that option in the application.

    Tartalom kiválasztása

  3. Most megtekintheti a jelentést a mintaalkalmazásban.Now you can view the report in the sample application.

    Alkalmazás megtekintése

Tartalom beágyazása az alkalmazásbanEmbed content within your application

Bár a tartalombeágyazás lépései elvégezhetők a Power BI REST API-kkal, a cikkben bemutatott mintakódok a .NET SDK-val készültek.Even though the steps to embed your content are done with the Power BI REST APIs, the example codes described in this article are made with the .NET SDK.

Az ügyfelek számára történő beágyazáshoz az alkalmazásban a fő fióknak egy hozzáférési jogkivonatra vagy szolgáltatásnévre van szüksége az Azure AD-ből.Embedding for your customers within your application requires you to get an access token for your master account or service principal from Azure AD. Mielőtt hívásokat intézhetne a Power BI REST API-khoz, be kell szereznie egy Azure AD hozzáférési jogkivonatot a Power BI-alkalmazáshoz.You're required to get an Azure AD access token for your Power BI application before you make calls to the Power BI REST APIs.

A Power BI-ügyfél hozzáférési jogkivonattal való létrehozásához célszerű létrehozni a Power BI-ügyfélobjektumot, amely lehetővé teszi a Power BI REST API-k használatát.To create the Power BI Client with your access token, you want to create your Power BI client object, which allows you to interact with the Power BI REST APIs. A Power BI-ügyfél létrehozásához az AccessToken hozzáférési jogkivonatot a Microsoft.Rest.TokenCredentials objektummal kell becsomagolni.You create the Power BI client object by wrapping the AccessToken with a Microsoft.Rest.TokenCredentials object.

using Microsoft.IdentityModel.Clients.ActiveDirectory;
using Microsoft.Rest;
using Microsoft.PowerBI.Api.V2;

var tokenCredentials = new TokenCredentials(authenticationResult.AccessToken, "Bearer");

// Create a Power BI Client object. it's used to call Power BI APIs.
using (var client = new PowerBIClient(new Uri(ApiUrl), tokenCredentials))
{
    // Your code to embed items.
}

A beágyazni kívánt tartalomelem lekéréseGet the content item you want to embed

A Power BI-ügyfélobjektummal lekérheti a beágyazni kívánt elem hivatkozását.You can use the Power BI client object to retrieve a reference to the item you want to embed.

Itt láthat arra mintakódot, hogyan kérhető le az első jelentés egy adott munkaterületről.Here is a code sample of how to retrieve the first report from a given workspace.

A tartalomelemek (beágyazni kívánt jelentések, irányítópultok vagy csempék) lekéréséről példát a mintaalkalmazás Services\EmbedService.cs fájljában találhat.A sample of getting a content item whether it's a report, dashboard, or tile that you want to embed is available within the Services\EmbedService.cs file in the sample application.

using Microsoft.PowerBI.Api.V2;
using Microsoft.PowerBI.Api.V2.Models;

// You need to provide the workspaceId where the dashboard resides.
ODataResponseListReport reports = await client.Reports.GetReportsInGroupAsync(workspaceId);

// Get the first report in the group.
Report report = reports.Value.FirstOrDefault();

A beágyazási token létrehozásaCreate the embed token

Generált egy beágyazási tokent, amely a JavaScript API-ból használható.Generated an embed token, which can be used from the JavaScript API. A beágyazási token a beágyazott elemre vonatkozik.The embed token is specific to the item you're embedding. Ez azt jelenti, hogy amikor Power BI-tartalmat ágyaz be, mindig létre kell hoznia egy új beágyazási tokent.So at any time you embed a piece of Power BI content, you need to create a new embed token for it. További információt (beleértve a használandó hozzáférési szintet) a GenerateToken API-ban talál.For more information, including which accessLevel to use, see GenerateToken API.

A tartalomelemekhez (beágyazni kívánt jelentések, irányítópultok vagy csempék) beágyazási jogkivonatának létrehozásáról példát a mintaalkalmazás Services\EmbedService.cs fájljában találhat.A sample of creating an embed token for a report, dashboard, or tile want to embed is available within the Services\EmbedService.cs file in the sample application.

using Microsoft.PowerBI.Api.V2;
using Microsoft.PowerBI.Api.V2.Models;

// Generate Embed Token.
var generateTokenRequestParameters = new GenerateTokenRequest(accessLevel: "view");
EmbedToken tokenResponse = client.Reports.GenerateTokenInGroup(workspaceId, report.Id, generateTokenRequestParameters);

// Generate Embed Configuration.
var embedConfig = new EmbedConfig()
{
    EmbedToken = tokenResponse,
    EmbedUrl = report.EmbedUrl,
    Id = report.Id
};

Létrejött egy osztály az EmbedConfig és a TileEmbedConfig elemekhez.A class is created for EmbedConfig and TileEmbedConfig. Minta a Models\EmbedConfig.cs és a Models\TileEmbedConfig.cs fájlban érhető el.A sample is available within the Models\EmbedConfig.cs file and the Models\TileEmbedConfig.cs file.

Elem betöltése a JavaScript használatávalLoad an item using JavaScript

A JavaScript használatával egy jelentést tölthet be a div elembe a weblapon.You can use JavaScript to load a report into a div element on your web page.

A JavaScript API teljes körű mintáját a Playground eszköz segítségével használhatja.For a full sample of using the JavaScript API, you can use the Playground tool. Ez a demókörnyezeti eszköz lehetőséget ad a Power BI Embedded különböző mintáinak gyors kipróbálására.The Playground tool is a quick way to play with different types of Power BI Embedded samples. A JavaScript API-ról a PowerBI-JavaScript wiki oldalon talál további információkat.You can also get more Information about the JavaScript API by visiting the PowerBI-JavaScript wiki page.

Íme egy minta, amely az EmbedConfig és a TileEmbedConfig modellt használja egy jelentés nézeteivel együtt.Here is a sample that uses an EmbedConfig model and a TileEmbedConfig model along with views for a report.

A nézetek jelentésekhez, irányítópultokhoz vagy csempékhez való hozzáadásáról példát a mintaalkalmazás Views\Home\EmbedReport.cshtml, Views\Home\EmbedDashboard.cshtml és Views\Home\Embedtile.cshtml fájljaiban találhat.A sample of adding a view for a report, dashboard, or tile is available within the Views\Home\EmbedReport.cshtml, Views\Home\EmbedDashboard.cshtml, or Views\Home\Embedtile.cshtml files in the sample application.

<script src="~/scripts/powerbi.js"></script>
<div id="reportContainer"></div>
<script>
    // Read embed application token from Model
    var accessToken = "@Model.EmbedToken.Token";

    // Read embed URL from Model
    var embedUrl = "@Html.Raw(Model.EmbedUrl)";

    // Read report Id from Model
    var embedReportId = "@Model.Id";

    // Get models. models contains enums that can be used.
    var models = window['powerbi-client'].models;

    // Embed configuration used to describe what and how to embed.
    // This object is used when calling powerbi.embed.
    // This also includes settings and options such as filters.
    // You can find more information at https://github.com/Microsoft/PowerBI-JavaScript/wiki/Embed-Configuration-Details.
    var config = {
        type: 'report',
        tokenType: models.TokenType.Embed,
        accessToken: accessToken,
        embedUrl: embedUrl,
        id: embedReportId,
        permissions: models.Permissions.All,
        settings: {
            filterPaneEnabled: true,
            navContentPaneEnabled: true
        }
    };

    // Get a reference to the embedded report HTML element
    var reportContainer = $('#reportContainer')[0];

    // Embed the report and display it within the div container.
    var report = powerbi.embed(reportContainer, config);
</script>

Átállás éles üzemreMove to production

Most, hogy elkészült az alkalmazás fejlesztésével, ideje dedikált kapacitással ellátni az alkalmazás-munkaterületet.Now that you've completed developing your application, it's time to back your app workspace with a dedicated capacity.

Fontos

Az éles üzemre való átálláshoz ez kötelező lépés.Dedicated capacity is required to move to production.

Dedikált kapacitás létrehozásaCreate a dedicated capacity

Dedikált kapacitás létrehozásával dedikált erőforrást rendelhet egy ügyfélhez.By creating a dedicated capacity, you can take advantage of having a dedicated resource for your customer. Dedikált kapacitást a Microsoft Azure Portalon vásárolhat.You can purchase a dedicated capacity within the Microsoft Azure portal. A Power BI Embedded-kapacitások létrehozásával kapcsolatos részletekért tekintse meg a Power BI Embedded-kapacitás az Azure Portalon való létrehozásával kapcsolatos cikket.For details on how to create a Power BI Embedded capacity, see Create Power BI Embedded capacity in the Azure portal.

Az alábbi táblázatból megtudhatja, milyen kapacitású Power BI Embedded-kapacitás felel meg a leginkább az igényeinek.Use the table below to determine which Power BI Embedded capacity best fits your needs.

KapacitáscsomópontCapacity Node Magok száma összesenTotal cores
(Háttérrendszer + előtérrendszer)(Backend + frontend)
Háttérrendszerbeli magokBackend Cores Előtérrendszerbeli magokFrontend Cores DirectQuery-/élő kapcsolat korlátaiDirectQuery/live connection limits
A1A1 1 virtuális mag1 v-core(s) 0,5 mag, 3 GB RAM0.5 core(s), 3-GB RAM 0,5 mag0.5 cores Másodpercenként 50 5 per second
A2A2 2 virtuális mag2 v-core(s) 1 mag, 5 GB RAM1 core(s), 5-GB RAM 1 mag1 cor(e) Másodpercenként 1010 per second
A3A3 42 virtuális mag4 v-core(s) 2 mag, 10 GB RAM2 core(s), 10-GB RAM 2 mag2 core(s) Másodpercenként 1515 per second
A4A4 8 virtuális mag8 v-core(s) 4 mag, 25 GB RAM4 core(s), 25-GB RAM 4 mag4 core(s) Másodpercenként 3030 per second
A5A5 16 virtuális mag16 v-core(s) 8 mag, 50 GB RAM8 core(s), 50-GB RAM 8 mag8 core(s) Másodpercenként 6060 per second
A6A6 32 virtuális mag32 v-core(s) 16 mag, 100 GB RAM16 core(s), 100-GB RAM 16 mag16 core(s) Másodpercenként 120120 per second

A termékváltozatokkal nem férhet hozzá a Power BI-tartalmakhoz INGYENES Power BI-licenccel.With A SKUs, you can't access Power BI content with a FREE Power BI license.

A PRO licenccel a beágyazási tokenek elsődlegesen fejlesztési tesztelésre használhatók, ezért a Power BI fő fiókja vagy a szolgáltatásnév csak korlátozott mennyiségű tokent tud előállítani.Using embed tokens with PRO licenses are intended for development testing, so the number of embed tokens a Power BI master account or service principal can generate is limited. Éles környezetben használt beágyazásokhoz dedikált kapacitás szükséges.A dedicated capacity requires embedding in a production environment. Dedikált kapacitásokkal nincs korlátja a beágyazási tokenek előállításának.There's no limit on how many embed tokens you can generate with a dedicated capacity. Az Elérhető szolgáltatások oldalon ellenőrizheti a használati értéket, amely százalékosan jelzi az aktuális beágyazott használatot.Go to Available Features to check the usage value that indicates the current embedded usage in percentage. A használati mennyiséget fő fiókonként számoljuk.The usage amount is based per master account.

További információ: Tanulmány a beágyazott analitikai kapacitás tervezéséről.For more information, see Embedded analytics capacity planning whitepaper.

Alkalmazás-munkaterület hozzárendelése dedikált kapacitáshozAssign an app workspace to a dedicated capacity

A dedikált kapacitás létrehozása után hozzárendelheti az alkalmazás-munkaterületet ehhez a kapacitáshoz.Once you create a dedicated capacity, you can assign your app workspace to that dedicated capacity.

Ha szolgáltatásnévvel szeretne dedikált kapacitást hozzárendelni egy munkaterülethez, használja a Power BI REST API-t.To assign a dedicated capacity to a workspace using service principal, use the Power BI REST API. Ha a Power BI REST API-t használja, akkor a szolgáltatásnév objektumazonosítóját is használnia kell.When you are using the Power BI REST APIs, make sure to use the service principal object ID.

Dedikált kapacitás fő fiókkal történő munkaterülethez rendeléséhez kövesse az alábbi lépéseket.Follow the steps below to assign a dedicated capacity to a workspace using a master account.

  1. A Power BI szolgáltatásban bontsa ki a munkaterületeket, és kattintson a három pont elemre azon munkaterület mellett, amelyiket tartalombeágyazáshoz használ.Within the Power BI service, expand workspaces and select the ellipsis for the workspace you're using for embedding your content. Válassza a Munkaterületek szerkesztése lehetőséget.Then select Edit workspaces.

    Munkaterület szerkesztése

  2. Bontsa ki a Speciális elemet, engedélyezze a Dedikált kapacitást, majd kattintson a létrehozott dedikált kapacitásra.Expand Advanced, then enable Dedicated capacity, then select the dedicated capacity you created. Kattintson a Mentés gombra.Then select Save.

    Dedikált kapacitás hozzárendelése

  3. A Mentés kiválasztása után meg kell jelennie egy gyémántnak az alkalmazás-munkaterület neve mellett.After you select Save, you should see a diamond next to the app workspace name.

    egy kapacitáshoz hozzárendelt alkalmazás-munkaterület

Következő lépésekNext steps

Ebben az oktatóanyagban bemutattuk, hogyan lehet Power BI-tartalmat beágyazni az ügyfelek alkalmazásaiba.In this tutorial, you've learned how to embed Power BI content into an application for your customers. Megpróbálkozhat Power BI-tartalom beágyazásával a szervezete számára is.You can also try to embed Power BI content for your organization.

További kérdései vannak?More questions? Kérdezze meg a Power BI közösségétTry asking the Power BI Community