배포 프로세스 이해Understand the deployment process

배포 프로세스를 사용하여 파이프라인의 한 단계에서 다른 단계로(일반적으로 개발에서 테스트로, 테스트에서 프로덕션으로) 콘텐츠를 복제할 수 있습니다.The deployment process lets you clone content from one stage in the pipeline to another, typically from development to test, and from test to production.

배포하는 동안 Power BI는 현재 단계에서 대상 단계로 콘텐츠를 복사합니다.During deployment, Power BI copies the content from the current stage, into the target one. 복사 프로세스 동안 복사된 항목 간의 연결이 유지됩니다.The connections between the copied items are kept during the copy process. 또한 Power BI는 구성된 데이터 세트 규칙을 대상 단계의 업데이트된 콘텐츠에 적용합니다.Power BI also applies the configured dataset rules to the updated content in the target stage. 배포되는 항목 수에 따라 콘텐츠를 배포하는 데 다소 시간이 걸릴 수 있습니다.Deploying content may take a while, depending on the number of items being deployed. 이 시간 동안 Power BI 포털의 다른 페이지로 이동할 수 있지만 대상 단계의 콘텐츠를 사용할 수는 없습니다.During this time, you can navigate to other pages in the Power BI portal, but you cannot use the content in the target stage.

빈 단계에 콘텐츠 배포Deploying content to an empty stage

빈 단계에 콘텐츠를 배포하는 경우 원본 작업 영역의 보고서, 대시보드 및 데이터 세트에 대한 메타데이터가 대상 단계에 복사됩니다.When you deploy content to an empty stage, the metadata of the reports, dashboards, and datasets in the workspace you're deploying from, is copied to the stage you're deploying to. 대상 단계에 대한 새 작업 영역이 프리미엄 용량에 생성됩니다.A new workspace for the stage you deployed to, is created on a Premium capacity.

한 단계에서 다음 단계로 콘텐츠를 배포하는 방법에는 두 가지가 있습니다.There are two ways to deploy content from one stage to the next one. 모든 콘텐츠를 배포할 수도 있고, 배포할 콘텐츠 항목을 선택할 수도 있습니다.You can deploy all the content, or you can select which content items to deploy.

배포 파이프라인의 이후 단계에서 이전 단계로 콘텐츠를 배포할 수도 있습니다.You can also deploy content backwards, from a later stage in the deployment pipeline, to an earlier one.

배포가 완료되면 새로 복사된 콘텐츠를 사용할 수 있도록 데이터 세트를 새로 고칩니다.After the deployment is complete, refresh the datasets so that you can use the newly copied content. 데이터 세트 새로 고침은 데이터가 한 단계에서 다른 단계로 복사되지 않기 때문에 필요합니다.The dataset refresh is required because data isn't copied from one stage to another. 배포 프로세스 중에 복사되는 항목 속성과 복사되지 않는 항목 속성을 이해하려면 배포하는 동안 복사되는 항목 속성 섹션을 검토하세요.To understand which item properties are copied during the deployment process, and which item properties are not copied, review the item properties copied during deployment section.

프리미엄 용량 작업 영역 만들기Creating a Premium capacity workspace

처음 배포하는 동안 배포 파이프라인은 사용자에게 프리미엄 용량 권한이 있는지 확인합니다.During first-time deployment, deployment pipelines checks if you have Premium capacity permissions.

용량 권한이 있는 경우에는 대상 단계에 작업 영역의 콘텐츠가 복사되고 해당 단계에 대한 새 작업 영역이 프리미엄 용량에 생성됩니다.If you have capacity permissions, the content of the workspace is copied to the stage you're deploying to, and a new workspace for that stage is created on the Premium capacity.

용량 권한이 없는 경우 작업 영역이 생성되지만 콘텐츠가 복사되지 않습니다.If you don't have capacity permissions, the workspace is created but the content isn’t copied. 용량 관리자에게 작업 영역을 용량에 추가하도록 요청하거나 해당 용량에 대한 할당 권한을 요청할 수 있습니다.You can ask a capacity admin to add your workspace to a capacity, or ask for assignment permissions for the capacity. 나중에 작업 영역이 용량에 할당되면 이 작업 영역에 콘텐츠를 배포할 수 있습니다.Later, when the workspace is assigned to a capacity, you can deploy content to this workspace.

PPU(사용자 단위 Premium)를 사용하는 경우 PPU와 연결된 용량에 작업 영역이 자동으로 만들어집니다.If you're using Premium Per User (PPU), your workspace is automatically created in the capacity associated with your PPU. 이러한 경우에는 용량 권한이 필요하지 않습니다.In such cases capacity permissions are not required. 그러나 한 PPU 사용자가 만든 작업 영역에는 다른 PPU 사용자들만 액세스할 수 있습니다.However, workspaces created by a PPU user, can only be accessed by other PPU users. 또한 이러한 작업 영역에서 만든 콘텐츠는 PPU 사용자들만 사용할 수 있습니다.In addition, content created in such workspaces can only be consumed by PPU users.

작업 영역 및 콘텐츠 소유권Workspace and content ownership

배포하는 사용자는 자동으로 복제된 데이터 세트의 데이터 세트 소유자와 새 작업 영역의 유일한 관리자가 됩니다.The deploying user automatically becomes the dataset owner of the cloned datasets, and the only admin of the new workspace.

기존 작업 영역에 콘텐츠 배포Deploy content to an existing workspace

운영 중인 프로덕션 파이프라인의 콘텐츠를 기존 작업 영역이 있는 단계에 배포하는 작업에는 다음이 포함됩니다.Deploying content in a working production pipeline, to a stage that has an existing workspace, includes the following:

  • 이미 콘텐츠가 포함된 단계에 새 콘텐츠를 추가합니다.Deploying new content as an addition, to a stage that already contains content.

  • 현재 작업 단계에서 새 콘텐츠를 배포하여 이전 콘텐츠를 대체합니다.New content deployed to replace old content, in a current working stage.

배포 프로세스Deployment process

현재 단계의 콘텐츠가 대상 단계로 복사됩니다.Content from the current stage is copied over to the target stage. Power BI가 대상 단계에서 기존 콘텐츠를 식별하여 덮어씁니다.Power BI identifies existing content in the target stage and overwrites it. 덮어쓸 콘텐츠 항목을 식별하기 위해 배포 파이프라인이 부모 항목과 해당 복제본 간의 연결을 사용합니다.To identify which content item needs to be overwritten, deployment pipelines uses the connection between the parent item and its clones. 이 연결은 새 콘텐츠를 만들 때 유지됩니다.This connection is kept when new content is created. 덮어쓰기 작업은 항목의 콘텐츠만 덮어씁니다.The overwrite operation only overwrites the content of the item. 항목의 ID, URL 및 사용 권한은 변경되지 않고 그대로 유지됩니다.The item's ID, URL, and permissions remain unchanged.

대상 단계에서는 복사되지 않는 항목 속성은 배포 이전 상태로 유지됩니다.In the target stage, item properties that are not copied, remain as they were before deployment. 새 콘텐츠와 새 항목이 현재 단계에서 대상 단계로 복사됩니다.New content and new items are copied from the current stage to the target stage.

데이터 세트 새로 고침Refreshing the dataset

가능한 경우 대상 데이터 세트의 데이터가 유지됩니다.Data in the target dataset is kept when possible. 데이터 세트 변경 내용이 없는 경우 데이터는 배포 전 상태로 유지됩니다.If there are no changes to a dataset, the data is kept as it was before the deployment.

테이블 또는 측정값을 추가하는 것과 같이 약간만 변경된 경우에는 Power BI가 원래 데이터를 유지하며 필요한 항목만 새로 고치도록 새로 고침이 최적화됩니다.With small changes, such as adding a table or measures, Power BI keeps the original data, and the refresh is optimized to refresh only what's needed. 중단이 발생하는 스키마 변경이나 데이터 원본 연결 변경의 경우에는 전체 새로 고침이 필요합니다.For breaking schema changes, or changes in the data source connection, a full refresh is required.

기존 작업 영역이 포함된 단계에 배포하기 위한 요구 사항Requirements for deploying to a stage with an existing workspace

배포된 콘텐츠가 프리미엄 용량에 있는 한, 다음 조건을 충족하는 사용자는 기존 작업 영역이 포함된 스테이지에 배포할 수 있습니다.As long as the deployed content resides on a premium capacity, a user that meets the following conditions, can deploy it to a stage with an existing workspace:

  • 원본 및 대상 배포 단계의 두 작업 영역 모두에 속하는 구성원인 Pro 라이선스가 있는 사용자 또는 PPU 사용자.A user with a Pro license or a PPU user, who's a member of both workspaces in the source and target deployment stages.

  • 배포하려는 대상 작업 영역에 있는 모든 데이터 세트의 소유자.An owner of all the datasets in the target workspace that are about to be deployed.

자세한 내용은 사용 권한 섹션을 검토하세요.For more information, review the permissions section.

배포된 항목Deployed items

한 파이프라인 단계에서 다른 파이프라인 단계로 콘텐츠를 배포하는 경우 복사된 콘텐츠에는 다음과 같은 Power BI 항목이 포함됩니다.When you deploy content from one pipeline stage to another, the copied content contains the following Power BI items:

  • 데이터 세트Datasets

  • 보고서Reports

  • 대시보드Dashboards

지원되지 않는 항목Unsupported items

배포 파이프라인은 다음 항목을 지원하지 않습니다.Deployment pipelines doesn't support the following items:

  • PBIX에서 시작하지 않은 데이터 세트Datasets that do not originate from a PBIX

  • 지원되지 않는 데이터 세트를 기반으로 한 보고서Reports based on unsupported datasets

  • 템플릿 앱 작업 영역Template app workspaces

  • 페이지를 매긴 보고서Paginated reports

  • 데이터 흐름Dataflows

  • 푸시 데이터 세트PUSH datasets

  • 통합 문서Workbooks

배포하는 동안 복사되는 항목 속성Item properties copied during deployment

다음 항목 속성은 배포하는 동안 복사되어 대상 단계의 항목 속성을 덮어씁니다.During deployment, the following item properties are copied and overwrite the item properties at the target stage:

복사되지 않는 항목 속성Item properties that are not copied

다음 항목 속성은 배포하는 동안 복사되지 않습니다.The following item properties are not copied during deployment:

  • 데이터 - 데이터는 복사되지 않고 메타데이터만 복사됩니다.Data - Data isn't being copied, only metadata is copied

  • URLURL

  • IDID

  • 권한 - 작업 영역 또는 특정 항목의 경우Permissions - For a workspace or a specific item

  • 작업 영역 설정 - 각 단계에는 자체 작업 영역이 있습니다.Workspace settings - Each stage has its own workspace

  • 앱 콘텐츠 및 설정 - 앱을 배포하려면 Power BI 앱 배포를 참조하세요.App content and settings - To deploy your apps, see deploying Power BI apps

다음 데이터 세트 속성도 배포하는 동안 복사되지 않습니다.The following dataset properties are also not copied during deployment:

  • 역할 할당Role assignment

  • 새로 고침 일정Refresh schedule

  • 데이터 원본 자격 증명Data source credentials

  • 쿼리 캐싱 설정(용량에서 상속 가능)Query caching settings (can be inherited from the capacity)

  • 인증 설정Endorsement settings

증분 새로 고침Incremental refresh

배포 파이프라인은 증분 새로 고침을 지원합니다. 이 기능을 사용하면 리소스 소비를 줄이면서 더 빠르고 안정적으로 큰 데이터 세트를 새로 고칠 수 있습니다.Deployment pipelines supports incremental refresh, a feature that allows large datasets faster and more reliable refreshes, with lower consumption.

배포 파이프라인은 데이터와 파티션을 모두 유지하면서 증분 새로 고침을 사용하여 데이터 세트 업데이트를 수행할 수 있습니다.With deployment pipelines, you can make updates to a dataset with incremental refresh while retaining both data and partitions. 데이터 세트를 배포하면 정책이 함께 복사됩니다.When you deploy the dataset, the policy is copied along.

파이프라인에서 증분 새로 고침 활성화Activating incremental refresh in a pipeline

증분 새로 고침을 사용하도록 설정하려면 Power BI Desktop에서 설정한 다음 데이터 세트를 게시합니다.To enable incremental refresh, turn it on in Power BI Desktop, and then publish your dataset. 게시한 후 증분 새로 고침 정책은 파이프라인 전체에서 비슷하며 Power BI Desktop에서만 작성할 수 있습니다.After you publish, the incremental refresh policy is similar across the pipeline, and can be authored only in Power BI Desktop.

파이프라인이 증분 새로 고침으로 구성된 후에는 다음 흐름을 사용하는 것이 좋습니다.Once your pipeline is configured with incremental refresh, we recommend that you use the following flow:

  1. Power BI Desktop에서 PBIX 파일을 변경합니다.Make changes to your PBIX file in Power BI Desktop. 긴 대기 시간을 방지하려면 데이터 샘플을 사용하여 변경할 수 있습니다.To avoid long waiting times, you can make changes using a sample of your data.

  2. PBIX 파일을 개발 단계에 업로드합니다.Upload your PBIX file to the development stage.

  3. 테스트 단계에 콘텐츠를 배포합니다.Deploy your content to the test stage. 배포 후에는 변경한 내용이 사용 중인 전체 데이터 세트에 적용됩니다.After deployment, the changes you made will apply to the entire dataset you're using.

  4. 테스트 단계에서 변경한 내용을 검토하고 확인한 후 프로덕션 단계에 배포합니다.Review the changes you made in the test stage, and after you verify them, deploy to the production stage.

사용 예Usage examples

다음은 증분 새로 고침을 배포 파이프라인과 통합할 수 있는 방법의 몇 가지 예입니다.Below are a few examples of how you may integrate incremental refresh with deployment pipelines.

  • 새 파이프라인을 만들고 증분 새로 고침을 사용하도록 설정된 데이터 세트가 있는 작업 영역에 연결합니다.Create a new pipeline and connect to it a workspace with a dataset that has incremental refresh enabled.

  • 이미 개발 작업 영역에 있는 데이터 세트에서 증분 새로 고침을 사용하도록 설정합니다.Enable incremental refresh in a dataset that's already in a development workspace.

  • 증분 새로 고침을 사용하는 데이터 세트가 있는 프로덕션 작업 영역에서 파이프라인을 만듭니다.Create a pipeline from a production workspace that has a dataset that uses incremental refresh. 이 작업을 수행하려면 작업 영역을 새 파이프라인의 프로덕션 단계에 할당하고 이전 단계 배포를 사용하여 테스트 단계에 배포한 다음 개발 단계에 배포합니다.This is done by assigning the workspace to a new pipeline's production stage, and using backwards deployment to deploy to the test stage, and then to the development stage.

  • 증분 새로 고침을 사용하는 데이터 세트를 기존 파이프라인의 일부인 작업 영역에 게시합니다.Publish a dataset that uses incremental refresh to a workspace that's part of an existing pipeline.

제한 사항 및 고려 사항Limitations and considerations

증분 새로 고침의 경우 배포 파이프라인은 향상된 데이터 세트 메타데이터를 사용하는 데이터 세트만 지원합니다.For incremental refresh, deployment pipelines only supports datasets that use enhanced dataset metadata. Power BI Desktop 2020년 9월 릴리스부터 Power BI Desktop을 사용하여 만들거나 수정한 모든 데이터 세트는 향상된 데이터 세트 메타데이터를 자동으로 구현합니다.Beginning with the September 2020 release of Power BI Desktop, all datasets created or modified with Power BI Desktop automatically implement enhanced dataset metadata.

증분 새로 고침을 사용하도록 설정된 활성 파이프라인에 데이터 세트를 다시 게시하는 경우 데이터 손실 가능성으로 인해 배포에 실패하게 되는 변경은 다음과 같습니다.When republishing a dataset to an active pipeline with incremental refresh enabled, the following changes will result in deployment failure due to data loss potential:

  • 증분 새로 고침을 사용하지 않는 데이터 세트를 다시 게시하여 증분 새로 고침을 사용하는 데이터 세트를 대체.Republishing a dataset that doesn't use incremental refresh, to replace a dataset that has incremental refresh enabled.

  • 증분 새로 고침을 사용하도록 설정된 테이블 이름 바꾸기.Renaming a table that has incremental refresh enabled.

  • 증분 새로 고침을 사용하도록 설정된 테이블에서 계산되지 않은 열의 이름 바꾸기.Renaming non-calculated columns in a table with incremental refresh enabled.

열 추가, 열 제거, 계산 열 이름 바꾸기 등의 다른 변경은 허용됩니다.Other changes such as adding a column, removing a column, and renaming a calculated column, are permitted. 하지만 변경이 표시에 영향을 주는 경우에는 변경 내용이 표시되기 전에 새로 고쳐야 합니다.However, if the changes affect the display, you'll need to refresh before the change is visible.

Power BI 앱 배포Deploying Power BI apps

Power BI 앱은 무료 Power BI 소비자에게 콘텐츠를 배포하는 권장 방법입니다.Power BI apps are the recommended way of distributing content to free Power BI consumers. 배포 파이프라인을 사용하여 배포 파이프라인에서 Power BI 앱을 관리할 수 있습니다. 따라서 앱의 수명 주기에 대한 제어 및 유연성이 확대됩니다.Using deployment pipelines you can manage Power BI apps in a deployment pipeline, so that you have more control and flexibility when it comes to your app's lifecycle.

최종 사용자의 관점에서 각 앱 업데이트를 테스트할 수 있도록 각 배포 파이프라인 단계에 대한 앱을 만듭니다.Create an app for each deployment pipeline stage, so that you can test each app update from an end user's point of view. 배포 파이프라인을 사용하면 이 프로세스를 쉽게 관리할 수 있습니다.A deployment pipeline allows you to manage this process easily. 작업 영역 카드의 게시 또는 보기 단추를 사용하여 특정 파이프라인 단계에서 앱을 게시하거나 볼 수 있습니다.Use the publish or view button in the workspace card, to publish or view the app in a specific pipeline stage.

프로덕션 단계의 오른쪽 아래에 있는 앱 게시 단추를 강조 표시하는 스크린샷A screenshot highlighting the publish app button, at the bottom right of the production stage.

프로덕션 단계에서 오른쪽 아래 모서리에 있는 주 작업 단추를 클릭하면 Power BI의 앱 업데이트 페이지가 열려 앱 사용자가 콘텐츠 업데이트를 사용할 수 있습니다.In the production stage, the main action button on the bottom-right corner opens the update app page in Power BI, so that any content updates become available to app users.

프로덕션 단계의 오른쪽 아래에 있는 앱 업데이트 단추를 강조 표시하는 스크린샷A screenshot highlighting the update app button, at the bottom right of the production stage.

중요

배포 프로세스에는 앱 콘텐츠 또는 설정 업데이트가 포함되지 않습니다.The deployment process does not include updating the app content or settings. 콘텐츠 또는 설정에 변경 내용을 적용하려면 필요한 파이프라인 단계에서 수동으로 앱을 업데이트해야 합니다.To apply changes to content or settings, you need to manually update the app in the required pipeline stage.

권한Permissions

파이프라인 권한과 작업 영역 권한은 별도로 부여 및 관리됩니다.Pipeline permissions and workspace permissions are granted and managed separately. 예를 들어 파이프라인 액세스 권한이 있고 작업 영역 권한이 없는 사용자는 파이프라인을 보고 다른 사용자와 공유할 수 있습니다.For example, a user with pipeline access that doesn't have workspace permissions, will be able to view the pipeline and share it with others. 그러나 이 사용자는 파이프라인 또는 작업 영역 페이지에서 작업 영역의 콘텐츠를 볼 수 없으며 배포를 수행할 수 없습니다.However, this user will not be able to view the content of the workspace in the pipeline, or in the workspace page, and will not be able to perform deployments.

파이프라인 액세스 권한이 있는 사용자User with pipeline access

파이프라인 액세스 권한이 있는 사용자에게는 다음 권한이 있습니다.Users with pipeline access have the following permissions:

  • 파이프라인 보기View the pipeline

  • 다른 사용자와 파이프라인 공유Share the pipeline with others

  • 파이프라인 편집 및 삭제Edit and delete the pipeline

참고

파이프라인 액세스 권한은 작업 영역 콘텐츠를 보거나 작업을 수행할 수 있는 권한을 부여하지 않습니다.Pipeline access doesn't grant permissions to view or take actions on the workspace content.

작업 영역 뷰어Workspace viewer

‘파이프라인 액세스 권한’이 있는 작업 영역 뷰어는 다음 작업도 수행할 수 있습니다.Workspace viewers that have pipeline access, can also do the following:

  • 콘텐츠 사용Consume content

참고

작업 영역 뷰어는 데이터 세트에 액세스하거나 작업 영역 콘텐츠를 편집할 수 없습니다.Workspace viewers cannot access the dataset or edit workspace content.

작업 영역 참가자Workspace contributor

‘파이프라인 액세스 권한’이 있는 작업 영역 참가자는 다음 작업도 수행할 수 있습니다.Workspace contributors that have pipeline access, can also do the following:

  • 콘텐츠 사용Consume content

  • 단계 비교Compare stages

  • 데이터 세트 보기View datasets

작업 영역 구성원Workspace member

‘파이프라인 액세스 권한’이 있는 작업 영역 구성원은 다음 작업도 수행할 수 있습니다.Workspace members that have pipeline access, can also do the following:

  • 작업 영역 콘텐츠 보기View workspace content

  • 단계 비교Compare stages

  • 보고서 및 대시보드 배포Deploy reports and dashboards

  • 작업 영역 제거Remove workspaces

작업 영역 관리자Workspace admin

‘파이프라인 액세스 권한’이 있는 작업 영역 관리자는 ‘작업 영역 구성원’ 작업 이외에 다음 작업도 수행할 수 있습니다.Workspace administrators that have pipeline access, can perform workspace member actions, and also do the following:

  • 작업 영역 할당Assign workspaces

  • 작업 영역 제거Remove workspaces

데이터 세트 소유자Dataset owner

작업 영역 구성원 또는 관리자인 데이터 세트 소유자는 다음 작업도 수행할 수 있습니다.Dataset owners that are either workspace members or admins, can also do the following:

  • 데이터 세트 업데이트Update datasets

  • 규칙 구성Configure rules

참고

이 섹션에서는 배포 파이프라인의 사용자 권한에 대해 설명합니다.This section describes user permissions in deployment pipelines. 이 섹션에 나열된 사용 권한은 다른 Power BI 기능에서는 다르게 적용될 수 있습니다.The permissions listed in this section may have different applications in other Power BI features.

제한 사항Limitations

이 섹션에서는 배포 파이프라인의 제한 사항 대부분을 소개합니다.This section lists most of the limitations in deployment pipelines.

데이터 세트 제한 사항Dataset limitations

  • 실시간 데이터 연결을 사용하는 데이터 세트는 배포할 수 없습니다.Datasets that use real-time data connectivity cannot be deployed.

  • 배포하는 동안 대상 데이터 세트가 라이브 연결을 사용하는 경우 원본 데이터 세트도 이 연결 모드를 사용해야 합니다.During deployment, if the target dataset is using a live connection, the source dataset must use this connection mode too.

  • 배포 후에는 데이터 세트가 배포된 단계에서 데이터 세트를 다운로드할 수 없습니다.After deployment, downloading a dataset (from the stage it's been deployed to) is not supported.

  • 데이터 세트 규칙 제한 사항의 목록은 데이터 세트 규칙 제한 사항을 참조하세요.For a list of dataset rule limitations, see dataset rule limitations.

다음 단계Next steps