Power BI 대시보드, 보고서 및 타일 포함Embed your Power BI dashboards, reports and tiles

응용 프로그램 내에서 Power BI 콘텐츠를 포함하는 데 필요한 단계에 대해 알아봅니다.Learn about the steps you need to take to embed Power BI content within your application.

Microsoft는 사용자의 콘텐츠 액세스, 공유 및 배포 방법에 대한 유연성을 높여주는 새로운 용량 기반 라이선스 모델인 Power BI Premium을 발표했습니다.Microsoft announced Power BI Premium, a new capacity-based licensing model that increases flexibility for how users access, share and distribute content. 또한, 이 제품은 Power BI 서비스에 향상된 확장성 및 성능을 제공합니다.The offering also delivers additional scalability and performance to the Power BI service. Power BI Embedded에서도 Microsoft Azure 내에서 용량을 만들 수 있게 할 수 있습니다.Power BI Embedded was also announced that allows for creating capacity within Microsoft Azure. Power BI Embedded는 응용 프로그램 및 고객에 집중합니다.Power BI Embedded is focused on your application and your customers.

이 문서에서는 조직 및 고객 모두에 대한 Power BI 콘텐츠를 포함하는 방법을 살펴봅니다.This article will look at embedding your Power BI content for both your organization and your customers. 두 시나리오의 단계는 유사합니다.The steps are similar between the two scenarios. 단계가 고객에 대한 콘텐츠를 포함하는 방법에 해당될 때 설명선이 만들어집니다.Callouts will be made when a step is specific to embedding for your customer.

이렇게 하려면 응용 프로그램으로 수행해야 하는 몇 가지 단계가 있습니다.There are a few steps you have to do with your application to make this possible. 응용 프로그램 내에서 포함되는 콘텐츠를 만들고 사용하도록 허용하는 데 필요한 단계를 거치게 됩니다.We will go through the steps needed to allow you to create and use embedded content within your application.

참고

Power BI API는 계속 그룹으로 앱 작업 영역을 참조합니다.The Power BI APIs still refer to app workspaces as groups. 그룹에 대한 참조는 앱 작업 영역과 작업 중임을 의미합니다.Any references to groups mean that you are working with app workspaces.

1단계: 포함된 분석 개발 환경 설정Step 1: Setup your embedded analytics development environment

응용 프로그램으로 대시보드 및 보고서 포함을 시작하기 전에 사용자 환경이 포함을 허용하도록 설정되었는지 확인해야 합니다.Before you start embedding dashboards and reports into your application, you need to make sure your environment is setup to allow for embedding. 설치의 일부로 다음을 수행해야 합니다.As part of the setup, you will need to do the following.

참고

Power BI 용량은 응용 프로그램을 개발하는 데 필요하지 않습니다.Power BI capacity is not required for development of your application. 응용 프로그램의 개발자는 Power BI Pro 라이선스가 필요합니다.The developers of the application will need to have a Power BI Pro license.

Azure Active Directory 테넌트Azure Active Directory tenant

Power BI에서 항목을 포함하기 위해 Azure AD(Azure Active Directory) 테넌트가 필요합니다.You will need an Azure Active Directory (Azure AD) tenant in order to embed items from Power BI. 이 테넌트는 하나 이상의 Power BI Pro 사용자가 있어야 합니다.This tenant must have at least one Power BI Pro user. 또한 테넌트 내에서 Azure AD 앱을 정의해야 합니다.You will also need to define an Azure AD app within the tenant. 기존 Azure AD 테넌트를 활용하거나 포함 목적으로 특별히 새 테넌트를 만들 수 있습니다.You can make use of an existing Azure AD tenant or create a new one specifically for embedding purposes.

고객에 대한 콘텐츠를 포함하는 경우 사용할 테넌트 설정을 확인해야 합니다.You will need to determine what tenant setup to use if you are embedding for your customers.

  • 기존 회사 Power BI 테넌트를 사용합니까?Use your existing corporate Power BI tenant?
  • 응용 프로그램에 대한 별도 테넌트를 사용합니까?Use a separate tenant for your application?
  • 각 고객에 대한 별도 테넌트를 사용합니까?Use a separate tenant for each customer?

기존 테넌트를 사용하지 않으려는 경우 응용 프로그램 또는 각 고객에 대해 새 테넌트를 만들도록 결정할 수 있습니다. Azure Active Directory 테넌트 만들기 또는 Azure Active Directory 테넌트를 가져오는 방법을 참조하세요.If you do not want to use an existing tenant, you can decide to create a new tenant for your application, or one for each customer, see Create an Azure Active Directory tenant or How to get an Azure Active Directory tenant.

Power BI Pro 사용자 계정 만들기Create a Power BI Pro user account

콘텐츠를 포함할 수 있는 단일 Power BI Pro 계정만이 필요합니다.You only need a single Power BI Pro account to embed content. 그러나 항목에 대한 특정 액세스를 갖는 몇 명의 다른 사용자를 가질 수 있습니다.However, you may want to have a few different users that have specific access to items. 테넌트 내에서 고려할 가능한 사용자를 살펴보면 다음과 같습니다.Here is a look at possible users to consider within your tenant.

다음 계정은 테넌트 내에 있고 할당된 Power BI Pro 라이선스가 있어야 합니다.The following accounts will need to exist within your tenant and have a Power BI Pro license assigned to them. Power BI 내에서 앱 작업 영역을 사용하는 데 Power BI Pro 라이선스가 필요합니다.A Power BI Pro license is required to work with app workspaces within Power BI.

조직/테넌트 관리 사용자An organization/tenant admin user

조직/테넌트 전역 관리 사용자는 고객에 대한 콘텐츠를 포함하는 경우 응용 프로그램에서 사용하는 계정으로 사용하지 않는 것이 좋습니다.It is recommended that your organization/tenant Global Admin user should not be used as account your application uses if embedding for your customers. 테넌트 내에서 해당 응용 프로그램 계정이 가지는 액세스 권한을 최소화하기 위한 것입니다.This is to minimize access that the application account has within your tenant. 이 관리 사용자는 포함 목적으로 만든 모든 앱 작업 영역의 관리자여야 합니다.It is recommended that the admin user be an admin of all app workspaces created for the purpose of embedding.

콘텐츠를 만드는 분석가용 계정Accounts for analysts that will create content

Power BI에 대한 콘텐츠를 만드는 여러 사용자가 있을 수 있습니다.You may have multiple users that create content for Power BI. Power BI에 콘텐츠를 만들고 배포하는 각 분석가에 대해 Power BI Pro 계정이 필요합니다.You will need a Power BI Pro account for each analyst that is creating and deploying content to Power BI.

고객에 대한 콘텐츠를 포함하는 응용 프로그램 마스터 사용자 계정An application master user account for embedding for your customers

마스터 계정은 고객에 대한 콘텐츠를 포함하는 경우 응용 프로그램에서 사용하는 계정입니다.The master account is the account your application will use when embedding content for your customers. 이 시나리오는 ISV 응용 프로그램에 일반적입니다.The scenario is typically for ISV applications. 마스터 계정은 조직 내에서 필요한 유일한 필수 계정입니다.The master account is really the only required account you need within your organization. 분석가 및 관리자 계정으로 사용할 수도 있지만, 권장하지는 않습니다.It can also be used as the admin and analyst account, but it is not recommended. 응용 프로그램 백 엔드는 이 계정에 대한 자격 증명을 저장하고 Power BI API에 사용할 Azure AD 인증 토큰을 획득하기 위해 사용합니다.Your application's backend will store the credentials for this account and use it for acquiring an Azure AD auth token for use with the Power BI APIs. 이 계정은 고객에 대해 사용할 응용 프로그램에 대한 embed 토큰을 생성하는 데 사용됩니다.This account will be used to generate an embed token for the application to use for your customers.

마스터 계정은 응용 프로그램에서 사용하는 Power BI Pro 라이선스가 있는 일반 사용자이며The master account is just a regular user with a Power BI Pro license that you use with your application. 포함에 사용되는 앱 작업 영역의 관리자여야 합니다.The account must be an admin of the app workspace that is being used for embedding.

앱 등록 및 사용 권한App registration and permissions

REST API를 호출하려면 Azure AD에 응용 프로그램을 등록해야 합니다.You will need to register your application with Azure AD in order to make REST API calls. 자세한 내용은 포함된 Power BI 콘텐츠에 Azure AD 앱 등록을 참조하세요.For more information, see Register an Azure AD app to embed Power BI content.

앱 작업 영역 만들기Create app workspaces

고객에 대한 대시보드 및 보고서를 포함하는 경우 해당 대시보드 및 보고서는 앱 작업 영역 내에 있어야 합니다.If you are embedding dashboards and reports for your customers, those dashboards and reports have to be placed within an app workspace. 위에서 언급한 마스터 계정은 앱 작업 영역의 관리자여야 합니다.The master account, that was mentioned above, must be an admin of the app workspace.

  1. 먼저 작업 영역을 만듭니다.Start by creating the workspace. 작업 영역 > 앱 작업 영역 만들기를 선택합니다.Select Workspaces > Create app workspace.

    앱 작업 영역 만들기

    사용자와 동료가 공동 작업하는 콘텐츠를 넣는 곳이 됩니다.This will be the place to put content that you and your colleagues collaborate on.

  2. 작업 영역에 이름을 지정합니다.Give the workspace a name. 해당하는 작업 영역 ID를 사용할 수 없는 경우 편집하여 고유한 ID를 입력합니다.If the corresponding Workspace ID isn't available, edit it to come up with a unique ID.

    또한 앱의 이름도 됩니다.This will be the name of the app, too.

    작업 영역 이름 지정

  3. 설정할 몇 가지 옵션이 있습니다.You have a few options to set. 공개를 선택할 경우 조직의 누구나 작업 영역에 있는 것을 볼 수 있습니다.If you choose Public, anyone in your organization can see what’s in the workspace. 한편으로, 비공개는 해당 작업 영역의 구성원만 콘텐츠를 볼 수 있음을 의미합니다.Private, on the other hand, means only members of the workspace can see its contents.

    개인 또는 공개 설정

    그룹을 만든 후에 공개/개인 설정을 변경할 수 없습니다.You can't change the Public/Private setting after you've created the group.

  4. 또한, 구성원이 편집할 수 있거나 보기 전용 액세스 권한을 가질지 선택할 수도 있습니다.You can also choose if members can edit or have view-only access.

    편집 또는 보기 전용 설정

    콘텐츠를 편집할 수 있도록 앱 작업 영역에 사용자를 추가합니다.Only add people to the app workspace so they can edit the content. 콘텐츠를 보기만 하려면 작업 영역에 추가하지 마십시오.If they're only going to view the content, don't add them to the workspace. 앱을 게시할 때 해당 사용자를 포함할 수 있습니다.You can include them when you publish the app.

  5. 작업 영역에 대한 액세스 권한을 원하는 사람의 메일 주소를 추가하고 추가를 선택합니다.Add email addresses of people you want to have access to the workspace, and select Add. 개인이 아닌 그룹 별칭은 추가할 수 없습니다.You can’t add group aliases, just individuals.

  6. 각 사용자가 구성원 또는 관리자인지 결정합니다.Decide whether each person is a member or an admin.

    구성원 또는 관리자 설정

    관리자는 다른 구성원 추가를 포함해 작업 영역 자체를 편집할 수 있습니다.Admins can edit the workspace itself, including adding other members. 구성원은 보기 전용 액세스 권한이 있는 경우를 제외하고 작업 영역의 콘텐츠를 편집할 수 있습니다.Members can edit the content in the workspace, unless they have view-only access. 관리자 및 멤버는 앱을 게시할 수 있습니다.Both admins and members can publish the app.

  7. 저장을 선택합니다.Select Save.

Power BI는 작업 영역을 만들고 엽니다.Power BI creates the workspace and opens it. 구성원으로 속해 있는 작업 영역 목록에 나타납니다.It appears in the list of workspaces you’re a member of. 사용자가 관리자이므로, 줄임표(…)를 선택하여 뒤로 이동한 후 새 구성원을 추가하거나 권한을 변경하여 변경 사항을 적용할 수 있습니다.Because you’re an admin, you can select the ellipsis (…) to go back and make changes to it, adding new members or changing their permissions.

작업 영역 편집

보고서 만들기 및 업로드Create and upload your reports

Power BI Desktop을 사용하여 보고서 및 데이터 집합을 만든 다음, 이러한 보고서를 앱 작업 영역으로 게시할 수 있습니다.You can create your reports and datasets using Power BI Desktop and then publish those reports to an app workspace. 보고서를 게시하는 최종 사용자는 앱 작업 영역에 게시하기 위해 Power BI Pro 라이선스가 필요합니다.The end user publishing the reports need to have a Power BI Pro license in order to publish to an app workspace.

2단계: 콘텐츠 포함Step 2: Embed your content

응용 프로그램 내에서 Power BI를 사용하여 인증해야 합니다.Within your application, you will need to authenticate with Power BI. 고객에 대한 콘텐츠를 포함하는 경우 응용 프로그램 내에서 마스터 계정에 대한 자격 증명을 저장합니다.If you are embedding content for your customers, you will store the credentials for the master account within your application. 자세한 내용은 사용자를 인증하고 Power BI 앱에 대한 Azure AD 액세스 토큰 가져오기를 참조하세요.For more information, see Authenticate users and get an Azure AD access token for your Power BI app.

일단 인증하면 응용 프로그램 내에서 Power BI REST API 및 JavaScript API를 사용하여 응용 프로그램에 대시보드 및 보고서를 포함합니다.Once authenticated, within your application, use the Power BI REST APIs and JavaScript APIs to embed dashboards and reports into your application.

조직에 대한 콘텐츠를 포함하는 경우 다음 연습을 참조하세요.For embedding for your organization, see the following walkthroughs:

ISV에서 일반적인 고객에 대한 콘텐츠를 포함하는 경우 다음을 참조하세요.For embeding with your customers, which is typical for ISVs, see the following:

고객에 대한 콘텐츠를 포함하는 경우 embed 토큰이 필요합니다.When embedding for your customers, an embed token is required. 자세한 내용은 GenerateToken을 참조하세요.To learn more see, GenerateToken.

3단계: 프로덕션에 솔루션 승격Step 3: Promote your solution to production

프로덕션으로 이동하려면 몇 가지 추가 단계가 필요합니다.Moving to production requires a few extra steps.

조직에 대한 콘텐츠 포함Embedding for your organization

조직에 대한 콘텐츠를 포함하는 경우 사용자에게 응용 프로그램을 가져오는 방법을 알리기만 하면 됩니다.If you are embedding for your organization, you only need to let people know how to get to your application.

해당 작업 영역이 용량으로 지원되는 경우 무료 사용자는 앱 작업 영역(그룹)에서 포함된 콘텐츠를 사용할 수 있습니다.Free users can consume content that is embedded from an app workspace (group), if that workspace is backed by capacity. 무료 사용자를 앱 작업 영역(그룹)의 멤버로 나열합니다. 그렇지 않으면 401 권한 없음 오류가 표시됩니다.List the Free user as a member of app workspace (group), otherwise you receive a 401 unauthorized error. 다음 표에서는 Office 365 내에서 사용할 수 있는 Power BI Premium SKU를 나열합니다.The following table lists the available Power BI Premium SKUs available within Office 365.

용량 노드Capacity Node 총 코어Total cores
(백 엔드 + 프런트 엔드)(Backend + frontend)
백 엔드 코어Backend Cores 프런트 엔드 코어Frontend Cores DirectQuery/라이브 연결 제한DirectQuery/live connection limits 사용량이 가장 많은 시간에 최대 페이지 렌더링Max page renders at peak hour
EM3EM3 4v-코어4 v-cores 2개 코어, 10GB RAM2 cores, 10GB RAM 2개 코어2 cores 601-1,200601-1,200
P1P1 8v-코어8 v-cores 4개 코어, 25GB RAM4 cores, 25GB RAM 4개 코어4 cores 초당 3030 per second 1,201-2,4001,201-2,400
P2P2 16v-코어16 v-cores 8개 코어, 50GB RAM8 cores, 50GB RAM 8개 코어8 cores 초당 6060 per second 2,401-4,8002,401-4,800
P3P3 32v-코어32 v-cores 16개 코어, 100GB RAM16 cores, 100GB RAM 16개 코어16 cores 초당 120120 per second 4,801-96004,801-9600

참고

Power BI 프리미엄을 구입하려면 테넌트 내에서 전역 또는 대금 청구 관리자여야 합니다.You must be a Global or Billing Admin, within your tenant, in order to purchase Power BI Premium. Power BI 프리미엄을 구입하는 방법에 대한 정보는 Power BI 프리미엄 구매 방법을 참조하세요.For information on how to purchase Power BI Premium, see How to purchase Power BI Premium.

고객에 대한 콘텐츠 포함Embedding for your customers

고객에 대한 콘텐츠를 포함하는 경우 다음을 수행합니다.If you are embedding for your customers, do the following.

  • 개발에 별도 테넌트를 사용하는 경우 대시보드 및 보고서와 함께 앱 작업 영역을 프로덕션 환경에서 사용할 수 있는지 확인해야 합니다.If you are using a separate tenant for development, then you must make sure your app workspaces, along with dashboards and reports, are available in your production environment. Azure AD에서 프로덕션 테넌트에 대한 응용 프로그램을 만들고 1단계에서 표시된 대로 적절한 앱 사용 권한을 할당해야 합니다.Make sure that you create the application in Azure AD for your production tenant and assign the proper app permissions as indicated in Step 1.
  • 필요에 맞는 용량을 구입합니다.Purchase a capacity that fits your needs. 아래 표를 사용하여 필요한 Power BI Embedded 용량 SKU를 이해할 수 있습니다.You can use the table below to understand which Power BI Embedded capacity SKU you may need. 자세한 내용은 포함된 분석 용량 계획 백서를 참조하세요.For more details, see Embedded analytics capacity planning whitepaper. 구입할 준비가 되면 Microsoft Azure Portal 내에서 수행할 수 있습니다.When you are ready to purchase, you can do so within the Microsoft Azure portal. Power BI Embedded 용량을 만드는 방법에 대한 자세한 내용은 Azure Portal에서 Power BI Embedded 용량 만들기를 참조하세요.For details on how to create Power BI Embedded capacity, see Create Power BI Embedded capacity in the Azure portal.

중요

포함 토큰은 개발 테스트 전용이므로 Power BI 마스터 계정에서 생성할 수 있는 포함 토큰의 수는 제한적입니다.Because embed tokens are intended for development testing only, the number of embed tokens a Power BI master account can generate is limited. 프로덕션 포함 시나리오를 위해 용량을 구입해야 합니다.A capacity must be purchased for production embedding scenarios. 용량을 구입할 때 토큰 생성은 제한 없이 포함시킬 수 있습니다.There is no limit to embed token generation when a capacity is purchased.

용량 노드Capacity Node 총 코어Total cores
(백 엔드 + 프런트 엔드)(Backend + frontend)
백 엔드 코어Backend Cores 프런트 엔드 코어Frontend Cores DirectQuery/라이브 연결 제한DirectQuery/live connection limits 사용량이 가장 많은 시간에 최대 페이지 렌더링Max page renders at peak hour
A1A1 1v-코어1 v-cores 0.5개 코어, 3GB RAM.5 cores, 3GB RAM 0.5개 코어.5 cores 초당 55 per second 1-3001-300
A2A2 2v-코어2 v-cores 1개 코어, 5GB RAM1 core, 5GB RAM 1개 코어1 core 초당 1010 per second 301-600301-600
A3A3 4v-코어4 v-cores 2개 코어, 10GB RAM2 cores, 10GB RAM 2개 코어2 cores 초당 1515 per second 601-1,200601-1,200
A4A4 8v-코어8 v-cores 4개 코어, 25GB RAM4 cores, 25GB RAM 4개 코어4 cores 초당 3030 per second 1,201-2,4001,201-2,400
A5A5 16v-코어16 v-cores 8개 코어, 50GB RAM8 cores, 50GB RAM 8개 코어8 cores 초당 6060 per second 2,401-4,8002,401-4,800
A6A6 32v-코어32 v-cores 16개 코어, 100GB RAM16 cores, 100GB RAM 16개 코어16 cores 초당 120120 per second 4,801-96004,801-9600
  • 앱 작업 영역을 편집하고 고급에서 용량에 할당합니다.Edit the app workspace and assign it to a capacity under advanced.

    용량에 앱 작업 영역 할당

  • 프로덕션에 업데이트된 응용 프로그램을 배포하고 Power BI 대시보드 및 보고서를 포함하기 시작합니다.Deploy your updated application to production and begin embedding Power BI dashboards and reports.

관리 설정Admin settings

전역 관리자 또는 Power BI 서비스 관리자는 테넌트에 REST API를 사용하도록 설정하거나 해제할 수 있습니다.Global Admins, or Power BI service administrators, can turn the ability to use the REST APIs, on or off for a tenant. Power BI 관리자는 전체 조직 또는 개별 보안 그룹에 대해 이 설정을 지정할 수 있습니다.Power BI admins can set this setting for the entire organization, or for individual security groups. 기본적으로 전체 조직에서 사용하도록 설정됩니다.It is enabled for the entire organization by default. 이 작업은 Power BI 관리 포털을 통해 수행합니다.This is done through the Power BI admin portal.

다음 단계Next steps

Power BI에 포함Embedding with Power BI
Power BI Embedded 작업 영역 컬렉션 콘텐츠를 Power BI으로 마이그레이션하는 방법How to migrate Power BI Embedded workspace collection content to Power BI
Power BI 프리미엄이란?Power BI Premium - what is it?
Power BI 프리미엄 구매 방법How to purchase Power BI Premium
JavaScript API Git 리포지토리JavaScript API Git repo
Power BI C# Git 리포지토리Power BI C# Git repo
JavaScript 포함 샘플JavaScript embed sample
포함된 분석 용량 계획 백서Embedded analytics capacity planning whitepaper
Power BI 프리미엄 백서Power BI Premium whitepaper

궁금한 점이 더 있나요?More questions? Power BI 커뮤니티에 질문합니다.Try asking the Power BI Community