Power BI 작업 영역 컬렉션 콘텐츠를 Power BI Embedded로 마이그레이션하는 방법How to migrate Power BI Workspace Collection content to Power BI Embedded

Power BI 작업 영역 컬렉션에서 Power BI Embedded로 마이그레이션하고 앱에서 포함하기 위한 고급 기능을 활용하는 방법을 알아봅니다.Learn how to migrate from Power BI Workspace Collection to Power BI Embedded and leverage advances for embedding in apps.

Microsoft는 최근에 사용자의 콘텐츠 액세스, 공유 및 배포 방법에 대한 유연성을 높여주는 새로운 용량 기반 라이선스 모델인 Power BI Embedded를 발표했습니다.Microsoft recently announced Power BI Embedded, a new capacity-based licensing model that increases flexibility for how users access, share and distribute content. 또한, 이 제품은 향상된 확장성 및 성능을 제공합니다.The offering also delivers additional scalability and performance.

Power BI Embedded를 사용하면 단일 API 표면, 일관성 있는 기능 집합, 콘텐츠 포함 시 대시보드, 게이트웨이, 작업 영역 등의 최신 Power BI 기능 액세스가 제공됩니다.With Power BI Embedded, you will have one API surface, a consistent set of capabilities and access to the latest Power BI features – such as dashboards, gateways and workspaces – when embedding your content. 더 나아가 Power BI Desktop을 시작하고 Power BI Embedded를 통해 배포를 진행할 수 있습니다.Moving forward you'll be able to start with Power BI Desktop and move to deployment with Power BI Embedded.

현재 Power BI 작업 영역 컬렉션은 제한된 시간 동안 계속 사용할 수 있습니다.The current Power BI Workspace Collection will continue to be available for a limited time. 기업계약을 체결한 고객은 기존 계약이 만료될 때까지 액세스할 수 있습니다. 직접 또는 CSP 채널을 통해 Power BI 작업 영역 컬렉션을 구매한 고객은 Power BI Embedded의 일반 공급 릴리스에서 1년간 액세스를 유지합니다.Customers under an Enterprise Agreement will have access through the expiration of their existing agreements; customers that acquired Power BI Workspace Collection through Direct or CSP channels will maintain access for one year from the General Availability release of Power BI Embedded. 이 아티클에서는 Power BI 작업 영역 컬렉션에서 새 Power BI Embedded 환경으로 마이그레이션하는 방법에 대한 일부 지침과 애플리케이션에서 예상되는 변경 내용을 제공합니다.This article will provide some guidance for migrating from Power BI Workspace Collection to the new Power BI Embedded experience and what to expect for changes in your application.

중요

마이그레이션은 Power BI Embedded에 종속되어 실행되지만, 임베드 토큰 사용 시 애플리케이션 사용자의 Power BI에 대한 종속은 없습니다.While the migration will take a dependency on Power BI Embedded, there is not a dependency on Power BI for the users of your application when using an embed token. 즉, 애플리케이션에서 포함된 콘텐츠를 보기 위해 Power BI에 등록할 필요가 없습니다.They do not need to sign up for Power BI to view the embedded content in your application. Power BI Embedded 이외 사용자에게 이 포함 방법을 사용할 수 있습니다.You can use this embedding approach to Embedded non-Power BI users.

흐름 포함

새 Power BI Embedded에 마이그레이션을 시작하기 전에 포함 설정 도구를 사용하여 새 Power BI Embedded 환경을 설정할 수 있는 연습을 신속하게 설명할 수 있습니다.Before you get started migrating to the new Power BI Embedded, you can quickly go through a walkthrough that helps you set up your new Power BI Embedded environment using the Embedding setup tool.

사용자에게 적합한 솔루션을 선택합니다.Choose the solution that is right for you:

마이그레이션 준비Prepare for the migration

Power BI 작업 영역 컬렉션에서 Power BI Embedded로 마이그레이션할 준비를 하기 위해 해야 할 일이 몇 가지 있습니다.There are a few things you need to do to prepare for migrating from Power BI Workspace Collection to Power BI Embedded. Power BI Pro 라이선스가 있는 사용자와 함께, 사용 가능한 테넌트가 필요합니다.You will need a tenant available, along with a user that has a Power BI Pro license.

  1. Azue AD(Azure Active Directory) 테넌트에 액세스할 수 있는지 확인합니다.Make sure you have access to an Azure Active Directory (Azure AD) tenant.

    사용할 테넌트 설정을 결정해야 합니다.You need to determine which tenant setup to use.

  2. 애플리케이션 "마스터" 계정으로 작동할 이 새 테넌트 내에서 사용자를 만듭니다.Create a user within this new tenant that will act as your application "master" account. 해당 계정은 Power BI에 등록해야 하며 할당된 Power BI Pro 라이선스가 있어야 합니다.That account needs to sign up for Power BI and needs to have a Power BI Pro license assigned to it.

Azure AD 내 계정Accounts within Azure AD

다음 계정은 테넌트 내에 있어야 합니다.The following accounts will need to exist within your tenant.

참고

이러한 계정이 작업 영역을 사용하려면 Power BI Pro 라이선스가 있어야 합니다.These accounts will need to have Power BI Pro licenses in order to use workspaces.

  1. 테넌트 관리 사용자.A tenant admin user.

    이 사용자는 포함 목적으로 만들어진 모든 작업 영역의 구성원을 지정하는 것이 좋습니다.It is recommended that this user be a member of all workspaces created for the purpose of embedding.

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

    필요에 따라 이러한 사용자를 작업 영역에 할당해야 합니다.These users should be assigned to workspaces as needed.

  3. 애플리케이션 마스터 사용자 계정 또는 Embedded 계정.An application master user account, or Embedded account.

    애플리케이션 백 엔드는 이 계정에 대한 자격 증명을 저장한 후 Power BI REST API에 사용할 Azure AD 토큰을 획득하기 위해 사용합니다.The applications backend will store the credentials for this account and use it for acquiring an Azure AD token for use with the Power BI REST APIs. 이 계정은 애플리케이션에 대한 임베드 토큰을 생성하는 데 사용됩니다.This account will be used to generate the embed token for the application. 또한 이 계정은 포함용으로 만들어진 작업 영역의 관리자여야 합니다.This account also needs to be an admin of the workspaces created for embedding.

참고

이는 조직에서 포함의 목적으로 사용할 일반 사용자 계정일 뿐입니다.This is just a regular user account in your organization that will be used for the purposes of embedding.

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

Azure AD 내에서 애플리케이션을 등록하고 일부 사용 권한을 부여해야 합니다.You will need to register an application within Azure AD and grant certain permissions.

애플리케이션 등록Register an application

REST API 호출을 실행하려면 Azure AD를 사용해 애플리케이션을 등록해야 합니다.You will need to register your application with Azure AD in order to make REST API calls. 여기에는 Azure Portal로 이동하여 Power BI 앱 등록 페이지 외에도 추가 구성을 적용하는 것이 포함됩니다.This includes going to the Azure portal to apply additional configuration in addition to the Power BI app registration page. 자세한 내용은 Power BI 콘텐츠를 포함하려면 Azure AD 앱 등록을 참조하세요.For more information, see Register an Azure AD app to embed Power BI content.

애플리케이션 마스터 계정을 사용하여 애플리케이션을 등록해야 합니다.You should register the application using the application master account.

작업 영역 만들기(필수)Create workspaces (Required)

애플리케이션에서 여러 고객에게 서비스를 제공하는 경우, 보다 완벽한 격리를 위해 작업 영역을 활용할 수 있습니다.You can take advantage of workspaces to provide better isolation if your application is servicing multiple customers. 대시보드와 보고서는 고객 간에 격리됩니다.Dashboards and reports would be isolated between your customers. 그런 다음, 작업 영역당 하나의 Power BI 계정을 사용하여 고객 간에 애플리케이션 환경을 더욱 격리할 수 있습니다.You could then use a Power BI account per workspace to further isolate application experiences between your customers.

중요

Power BI가 아닌 사용자에게 포함을 활용하기 위해 개인 작업 영역을 사용할 수 없습니다.You cannot use a personal workspace to take advantage of embedding to non-Power BI users.

Power BI 내에서 작업 영역을 만들려면 Pro 라이선스가 있는 사용자가 필요합니다.You will need a user that has a Pro license in order to create a workspace within Power BI. 작업 영역을 만드는 Power BI 사용자가 기본적으로 작업 영역의 관리자가 됩니다.The Power BI user that creates the workspace will be an admin of that workspace by default.

참고

애플리케이션 마스터 계정은 작업 영역의 관리자여야 합니다.The application master account needs to be an admin of the workspace.

콘텐츠 마이그레이션Content migration

작업 영역 컬렉션에서 Power BI Embedded로 콘텐츠를 마이그레이션하는 것은 현재 솔루션과 동시에 수행할 수 있으며 가동 중지 시간이 필요하지 않습니다.Migrating your content from your workspace collections to Power BI Embedded can be done in parallel to your current solution and doesn't require any downtime.

마이그레이션 도구는 Power BI 작업 영역 컬렉션에서 Power BI Embedded로 콘텐츠 복사를 지원하기 위해 사용할 수 있습니다.A migration tool is available for you to use in order to assist with copying content from Power BI Workspace Collection to Power BI Embedded. 특히 콘텐츠가 많은 경우입니다.Especially if you have a lot of content. 자세한 내용은 Power BI Embedded 마이그레이션 도구를 참조하세요.For more information, see Power BI Embedded migration tool.

콘텐츠 마이그레이션은 주로 두 개의 API에 의존합니다.Content migration relies mainly on two APIs.

  1. PBIX 다운로드 - 이 API는 2016년 10월 이후 Power BI에 업로드된 PBIX 파일을 다운로드할 수 있습니다.Download PBIX - this API can download PBIX files which were uploaded to Power BI after October 2016.
  2. PBIX 가져오기 - 이 API는 Power BI에 모든 PBIX를 업로드합니다.Import PBIX - this API uploads any PBIX to Power BI.

일부 관련된 코드 조각은 Power BI 작업 영역 컬렉션에서 콘텐츠 마이그레이션을 위한 코드 조각을 참조하세요.For some related code snippets, see Code snippets for migrating content from Power BI Workspace Collection.

보고서 유형Report types

다소 다른 마이그레이션 흐름이 필요한 여러 종류의 보고서가 있습니다.There are several types of reports, each requiring a somewhat different migration flow.

캐시된 데이터 세트 및 보고서Cached dataset & report

캐시된 데이터 세트는 라이브 연결 또는 DirectQuery 연결과는 대조적으로 데이터를 가져온 PBIX 파일을 가리킵니다.Cached datasets refer to PBIX files that had imported data as opposed to a live connection or DirectQuery connection.

흐름Flow

  1. PaaS 작업 영역에서 PBIX API 다운로드를 호출합니다.Call Download PBIX API from PaaS workspace.
  2. PBIX를 저장합니다.Save PBIX.
  3. SaaS 작업 영역에 PBIX 가져오기를 호출합니다.Call Import PBIX to SaaS workspace.

DirectQuery 데이터 세트 및 보고서DirectQuery dataset & report

흐름Flow

  1. GET https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources를 호출하고 수신된 연결 문자열을 저장합니다.Call GET https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources and save connection string received.
  2. PaaS 작업 영역에서 PBIX API 다운로드를 호출합니다.Call Download PBIX API from PaaS workspace.
  3. PBIX를 저장합니다.Save PBIX.
  4. SaaS 작업 영역에 PBIX 가져오기를 호출합니다.Call Import PBIX to SaaS workspace.
  5. POST https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.SetAllConnections를 호출하여 연결 문자열을 업데이트합니다.Update connection string by calling - POST https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.SetAllConnections
  6. GET https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.GetBoundGatewayDataSources을 호출하여 GW 및 데이터 소스 식별자를 가져옵니다.Get GW and datasource identifiers by calling - GET https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.GetBoundGatewayDataSources
  7. PATCH https://api.powerbi.com/v1.0/myorg/gateways/{gateway_id}/datasources/{datasource_id}를 호출하여 사용자의 자격 증명을 업데이트합니다.Update user's credentials by calling - PATCH https://api.powerbi.com/v1.0/myorg/gateways/{gateway_id}/datasources/{datasource_id}

이전 데이터 세트 및 보고서Old dataset & reports

2016년 10월 이전에 만든 데이터 세트/보고서입니다.These are datasets/reports created before October 2016. PBIX 다운로드는 2016년 10월 이전에 업로드된 PBIX를 지원하지 않습니다Download PBIX doesn't support PBIXs which were uploaded before October 2016

흐름Flow

  1. 개발 환경에서 PBIX를 가져옵니다(내부 소스 제어).Get PBIX from your development environment (your internal source control).
  2. SaaS 작업 영역에 PBIX 가져오기를 호출합니다.Call Import PBIX to SaaS workspace.

푸시 데이터 세트 및 보고서Push Dataset & report

PBIX 다운로드는 푸시 API 데이터 세트를 지원하지 않습니다.Download PBIX doesn't support Push API datasets. 푸시 API 데이터 세트 데이터는 PaaS에서 SaaS로 이식할 수 없습니다.Push API dataset data can't be ported from PaaS to SaaS.

흐름Flow

  1. 데이터 세트 Json으로 "데이터 세트 만들기" API를 호출하여 SaaS 작업 영역에 데이터 세트를 만듭니다.Call "Create dataset" API with dataset Json to create dataset in SaaS workspace.
  2. 만든 데이터 세트*에 대한 보고서를 다시 작성합니다.Rebuild report for the created dataset*.

다음을 시도하여 PaaS에서 SaaS로 푸시 api 보고서를 마이그레이션하는 데 일부 해결 방법을 사용할 수 있습니다.It is possible, using some workarounds, to migrate the push api report from PaaS to SaaS by trying the following.

  1. 일부 더미 PBIX를 PaaS 작업 영역으로 업로드합니다.Uploading some dummy PBIX to PaaS workspace.
  2. 푸시 api 보고서를 복제하고 1단계의 더미 PBIX에 바인딩합니다.Clone the push api report and bind it to the dummy PBIX from step 1.
  3. 더미 PBIX를 사용하여 푸시 API 보고서를 다운로드합니다.Download push API report with the dummy PBIX.
  4. SaaS 작업 영역에 더미 PBIX를 업로드합니다.Upload dummy PBIX to your SaaS workspace.
  5. SaaS 작업 영역에 푸시 데이터 세트를 만듭니다.Create push dataset in your SaaS workspace.
  6. 푸시 api 데이터 세트에 보고서를 다시 바인딩합니다.Rebind report to push api dataset.

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

Power BI 작업 영역 컬렉션에서 마이그레이션한 콘텐츠뿐 아니라 Power BI Desktop을 사용하여 보고서와 데이터 세트를 만든 다음, 작업 영역에 해당 보고서를 게시할 수 있습니다.In addition to the content you migrated from the Power BI Workspace Collection, you can create your reports and datasets using Power BI Desktop and then publish those reports to a workspace. 보고서를 게시하는 최종 사용자가 작업 영역에 게시하려면 Power BI Pro 라이선스가 있어야 합니다.The end user publishing the reports need to have a Power BI Pro license in order to publish to a workspace.

애플리케이션 다시 빌드Rebuild your application

  1. powerbi.com 내에서 보고서 위치와 Power BI REST API를 사용하려면 애플리케이션을 수정해야 합니다.You will need to modify your application to use the Power BI REST APIs and the report location inside powerbi.com.
  2. 애플리케이션에 대한 마스터 계정을 사용하여 AuthN/AuthZ 인증을 다시 빌드하세요.Rebuild your AuthN/AuthZ authentication using the master account for your application. Embed 토큰을 사용하여 이 사용자가 다른 사용자 대신 작업하도록 할 수 있습니다.You can take advantage of using an embed token to allow this user to act on behalf of other users.
  3. 애플리케이션에 powerbi.com에서 보고서를 포함 합니다.Embed your reports from powerbi.com into your application.

사용자를 Power BI 사용자로 매핑Map your users to a Power BI user

애플리케이션 내에서 관리하는 사용자를 애플리케이션의 목적에 맞게 마스터 Power BI 자격 증명으로 매핑합니다.Within your application, you will map users that you manage within the application to a master Power BI credential for the purposes of your application. 이 Power BI 마스터 계정에 대한 자격 증명은 애플리케이션 내에 저장되어 임베드 토큰을 만드는 데 사용됩니다.The credentials for this Power BI master account will be stored within your application and be used to creating embed tokens.

프로덕션 준비가 되면 해야 할 일What to do when you are ready for production

프로덕션으로 전환할 준비가 되면 다음 사항을 수행해야 합니다.When you are ready to move to production, you will need to do the following.

  • 개발에 별도 테넌트를 사용하는 경우 대시보드 및 보고서와 함께 작업 영역을 프로덕션 환경에서 사용할 수 있는지 확인해야 합니다.If you are using a separate tenant for development, then you will need to make sure your workspaces, along with dashboards and reports, are available in your production environment. 또한 Azure AD에 프로덕션 테넌트에 대한 애플리케이션을 만들고 1단계에서 표시된 대로 적절한 앱 사용 권한을 할당했는지 확인해야 합니다.You will also need to make sure that you created the application in Azure AD for your production tenant and assigned the proper app permissions as indicated in Step 1.

  • 필요에 맞는 용량을 구입합니다.Purchase a capacity that fits your needs. 필요한 용량 및 형식을 더 잘 이해하려면 Power BI Embedded 분석 용량 계획 백서를 참조하세요.To better understand how the amount and type of capacity you need, see the Power BI Embedded analytics capacity planning whitepaper. Azure에서 용량을 구입할 수 있습니다.You can purchase capacity in Azure.

  • 작업 영역을 편집하고 고급에서 프리미엄 용량에 할당합니다.Edit the workspace and assign it to a Premium capacity under advanced.

    프리미엄 용량

  • 프로덕션에 업데이트된 애플리케이션을 배포하고 Power BI Embedded에서 보고서 포함을 시작합니다.Deploy your updated application to production and begin embedding reports from the Power BI Embedded.

마이그레이션 후After migration

Azure 내에서 몇 가지 정리를 수행해야 합니다.You should do some cleanup within Azure.

  • Power BI 작업 영역 컬렉션의 Azure Embedded 내에 있는 배포된 솔루션에서 모든 작업 영역을 제거합니다.Remove all workspaces off of the deployed solution within the Azure Embedded of Power BI Workspace Collection.
  • Azure 내에 있는 모든 작업 영역 컬렉션을 삭제합니다.Delete any Workspace Collections that exist within Azure.

다음 단계Next steps

Power BI에 포함Embedding with Power BI
Power BI 작업 영역 컬렉션 마이그레이션 도구Power BI Workspace Collection migration tool
Power BI 작업 영역 컬렉션에서 콘텐츠 마이그레이션을 위한 코드 조각Code snippets for migrating content from Power BI Workspace Collection
Power BI 대시보드, 보고서 및 타일을 포함하는 방법How to embed your Power BI dashboards, reports and tiles
Power BI 프리미엄이란?Power BI Premium - what is it?
JavaScript Git 리포지토리JavaScript API Git repo
Power BI C# Git 리포지토리Power BI C# Git repo
JavaScript 포함 샘플JavaScript embed sample
작업 영역 컬렉션 분석 용량 계획 백서Workspace Collection analytics capacity planning whitepaper
Power BI 프리미엄 백서Power BI Premium whitepaper

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