配置パイプラインのトラブルシューティングDeployment pipelines troubleshooting

この記事では、配置パイプラインの問題のトラブルシューティングについて説明します。Use this article to troubleshoot issues in deployment pipelines.

全般General

Power BI の配置パイプラインとはどのようなものですか?What's deployment pipelines in Power BI?

Power BI の配置パイプラインがどのようなものであるかを理解するには、配置パイプラインの概要に関するページを参照してください。To understand what's deployment pipelines in Power BI, refer to the deployment pipelines overview.

配置パイプラインの使用を開始するにはどうすればよいですか。How do I get started with deployment pipelines?

配置パイプラインの使用を開始するには、使用開始の手順を利用してください。Get started with deployment pipelines using the get started instructions.

配置パイプラインのボタンが表示されないのはなぜですか。Why can't I see the deployment pipelines button?

以下の条件が満たされていない場合は、配置パイプラインのボタンを表示することができません。If the following conditions are not met, you'll not be able to see the deployment pipelines button.

ワークスペースにパイプライン ステージ タグが表示されないのはなぜですか?Why can't I see the pipeline stage tag in my workspace?

デプロイ パイプラインには、パイプラインに割り当てられているワークスペースのパイプライン ステージ タグが表示されます。Deployment pipelines displays a pipeline stage tag in workspaces that are assigned to a pipeline. "開発" および "テスト" ステージのタグは常に表示されます。Tags for the Development and Test stages are always visible. ただし、パイプラインへのアクセス権を持っている場合、または ワークスペース管理者である場合にのみ、"運用環境" タグが表示されます。However, you'll only see the Production tag if you have access to the pipeline or if you're a workspace admin.

運用環境パイプライン ワークスペースの運用環境タグのスクリーンショット。A screenshot of the production tag in a production pipeline workspace.

ライセンスLicensing

配置パイプラインを操作するには、どのようなライセンスが必要ですか。What licenses are needed to work with deployment pipelines?

配置パイプラインを使用するには、次のいずれかのライセンスを持っている必要があります。To use deployment pipelines, you need to have one of the following licenses:

詳細については、「配置パイプラインへのアクセス」を参照してください。For more information, see accessing deployment pipelines.

パイプラインのワークスペースには、どのような種類の容量を割り当てることができますか。What type of capacity can I assign to a workspace in a pipeline?

パイプラインを機能させるには、配置パイプライン内のすべてのワークスペースが容量内に存在する必要があります。All workspaces in a deployment pipeline must reside within a capacity for the pipeline to be functional. ただし、パイプライン内の異なるワークスペースに対して、異なる容量を使用できます。However, you can use different capacities for different workspaces in a pipeline. また、同じパイプライン内の異なるワークスペースに対して、異なる容量の種類を使用することもできます。You can also use different capacity types for different workspaces in the same pipeline.

開発とテストでは、ユーザーごとの Pro Power BI アカウントと共に A または EM 容量を使用できます。For development and testing, you can use A or EM capacity alongside a Pro Power BI account for each user. また、開発およびテストのステージで、各ユーザーに PPU を使用することもできます。You can also use a PPU for each user in the development and test stages.

運用ワークスペースの場合は、P 容量が必要です。For production workspaces, you need a P capacity. ISV が埋め込みアプリケーションを使用してコンテンツを配布する場合は、運用環境で A または EM 容量を使用することもできます。If you're an ISV distributing content through embedded applications, you can also use A or EM capacities for production. PPU は、運用ワークスペースでも使用できます。PPUs can also be used for production workspaces.

注意

PPU を使用してワークスペースを作成すると、他の PPU ユーザーのみがワークスペースにアクセスしてそのコンテンツを使用できるようになります。When you create a workspace with a PPU, only other PPU users will be able to access the workspace and consume its content.

技術的な質問Technical

パイプラインにワークスペースを割り当てようとするときに、一部のワークスペースが表示されないのはなぜですか。Why can't I see all my workspaces when I try to assign a workspace to a pipeline?

パイプラインにワークスペースを割り当てるには、以下の条件を満たす必要があります。To assign a workspace to a pipeline, the following conditions must be met:

これらの条件を満たしていないワークスペースは、選択できるワークスペースの一覧に表示されません。Workspaces that don't meet these conditions, are not displayed in the list of workspaces you can select from.

パイプラインのすべてのステージにワークスペースを割り当てるにはどうすればよいですか。How can I assign workspaces to all the stages in a pipeline?

パイプラインごとに、1 つのワークスペースを割り当てることができます。You can assign one workspace per pipeline. ワークスペースがパイプラインに割り当てられたら、それを次のパイプライン ステージに配置できます。Once a workspace is assigned to a pipeline, you can deploy it to the next pipeline stages. 最初のデプロイ時に、ソース ステージの項目のコピーを使用して新しいワークスペースが作成されます。During first-time deployment, a new workspace is created with copies of the items in the source stage. コピーされた項目間のリレーションシップは保持されます。The relationships of the copied items are kept. 詳細については、配置パイプラインにワークスペースを割り当てる方法に関するページを参照してください。For more information, see how to assign a workspace to a deployment pipeline.

最初の配置が失敗したのですが、なぜでしょうか。Why did my first deployment fail?

最初の配置が失敗した原因として、さまざまなものが考えられます。Your first deployment may have failed due to a number of reasons. それらの理由の一部を次の表に示します。Some of these reasons are listed in the table below.

ErrorError アクションAction
Premium 容量のアクセス許可がない。You don't have premium capacity permissions. Premium 容量を持つ組織で働いている場合は、容量管理者にワークスペースを容量に追加するように依頼するか、容量に対する割り当てアクセス許可を要求します。If you work in an organization that has a Premium capacity, ask a capacity admin to add your workspace to a capacity, or ask for assignment permissions for the capacity. ワークスペースが容量に追加されたら、再配置します。After the workspace is in a capacity, redeploy.

Premium 容量を持つ組織で働いていない場合は、Premium Per User (PPU) の購入を検討してください。If you don't work in an organization with Premium capacity, consider purchasing Premium Per User (PPU).
ワークスペースに対するアクセス許可がない。You don't have workspace permissions. デプロイするには、ワークスペース メンバーになっている必要があります。To deploy, you need to be a workspace member. ワークスペース管理者に、適切なアクセス許可を付与するよう依頼します。Ask your workspace admin to grant you the appropriate permissions.
Power BI 管理者がワークスペースの作成を無効にしている。Your Power BI admin disabled the creation of workspaces. Power BI 管理者に連絡してサポートを依頼します。Contact your Power BI admin for support.
ワークスペースが新しいワークスペース エクスペリエンスでない。Your workspace isn't a new workspace experience. 新しいワークスペース エクスペリエンスでコンテンツを作成します。Create your content in the new workspace experience. クラシック ワークスペースにコンテンツがある場合は、新しいワークスペース エクスペリエンスにアップグレードできます。If you have content in a classic workspace, you can upgrade it to a new workspace experience.
選択的配置を使用しており、コンテンツのデータセットを選択していない。You're using selective deployment and are not selecting your content's dataset. 次のいずれかの操作を行います。Do one of the following:

データセットにリンクされているコンテンツの選択を解除します。Unselect the content that is linked to your dataset. 選択されていないコンテンツ (レポートやダッシュボードなど) は、次のステージにコピーされません。Your unselected content (such as reports or dashboards) will not be copied to the next stage.

選択したコンテンツにリンクされているデータセットを選択します。Select the dataset that's linked to the selected content. データセットが次のステージにコピーされます。Your dataset will be copied to the next stage.

配置を試みているときに、自分のワークスペースに "サポートされていない成果物" があることを示す警告が表示されます。I'm getting a warning that I have 'unsupported artifacts' in my workspace when I'm trying to deploy. どの成果物がサポートされていないかを知るには、どうすればよいですか。How can I know which artifacts are not supported?

配置パイプラインでサポートされていない項目と成果物の包括的な一覧については、以下のセクションを参照してください。For a comprehensive list of items and artifacts that are not supported in deployment pipelines, see the following sections:

ルールの破損により配置が失敗したのはなぜですか。Why did my deployment fail due to broken rules?

データセット ルールの構成で問題が発生した場合は、データセット ルールにアクセスし、データセット ルールの制限事項に従っていることを確認してください。If you have problems configuring dataset rules, visit dataset rules, and make sure you follow the dataset rule limitations.

以前は配置が成功していて、破損したルールによって突然失敗した場合は、再発行されているデータセットが原因である可能性があります。If your deployment was previously successful, and is suddenly failing with broken rules, it may be due to a dataset being republished. ソース データセットに対して以下の変更を行うと、配置が失敗します。The following changes to the source dataset, result in a failed deployment:

パラメーター ルールParameter rules

  • パラメーターの削除A removed parameter

  • パラメーター名の変更A changed parameter name

データ ソース ルールData source rules

データセット ルールに値がありません。Your dataset rules are missing values. この問題は、データセットが変更された場合に発生する可能性があります。This may have happened if your dataset changed.

破損したリンクのために配置が失敗した場合に表示される、無効なルールに関するエラーのスクリーンショット。

以前は成功した配置が、破損したリンクのために失敗する場合は、警告が表示されます。When a previously successful deployment fails due to broken links, a warning is displayed. [ルールの構成] を選択すると、失敗したデータセットがマークされているデプロイ設定ペインに移動できます。You can select Configure rules to navigate to the deployment settings pane, where the failed dataset is marked. データセットを選択すると、破損したルールがマークされます。When you select the dataset, the broken rules are marked.

正常に配置するには、破損したルールを修正または削除し、再配置します。To deploy successfully, fix or remove the broken rules, and redeploy.

パイプライン ステージのデータ ソースを変更するにはどうすればよいですか。How can I change the data source in the pipeline stages?

Power BI サービスでは、データ ソース接続を変更することはできません。You can’t change the data source connection in Power BI service.

テスト ステージまたは運用ステージでデータ ソースを変更する場合は、データセット ルールまたは API を使用できます。If you want to change the data source in the test or production stages, you can use dataset rules or APIs. データセット ルールは、次回の配置後にのみ有効になります。Dataset rules will only come into effect after the next deployment.

運用環境でバグを修正しましたが、[deploy to previous stage](前のステージにデプロイする) ボタンを選択できなくなりました。I fixed a bug in production, but now I can't select the 'deploy to previous stage' button. 淡色表示になったのはなぜですか。Why is it greyed out?

逆方向に配置できるのは、配置先が空のステージである場合のみです。You can only deploy backwards to an empty stage. テスト ステージにコンテンツがある場合は、運用環境から逆方向に配置することはできません。If you have content in the test stage, you will not be able to deploy backwards from production.

パイプラインの作成後は、開発ステージを使用してコンテンツを開発し、テスト ステージを使用してそれを確認し、テストしてください。After creating the pipeline, use the development stage to develop your content, and the test stages to review and test it. これらのステージでバグを修正したうえで、修正した環境を運用ステージに配置できます。You can fix bugs in these stages, and then deploy the fixed environment to the production stage.

注意

逆方向の配置では、完全配置のみがサポートされます。Backwards deployment only supports full deployment. 選択的配置はサポートされていませんIt doesn't support selective deployment

配置パイプラインでは Multi-Geo はサポートされていますか。Does deployment pipelines support multi-geo?

Multi-Geo はサポートされています。Multi-geo is supported. 異なる geo のステージ間でコンテンツを配置するのには、時間がかかることがあります。It may take longer to deploy content between stages in different geos.

アクセス許可Permissions

配置パイプラインのアクセス許可モデルとはどのようなものですか。What is the deployment pipelines permissions model?

配置パイプラインのアクセス許可モデルについては、「アクセス許可」のセクションで説明されています。The deployment pipelines permissions model is described the permissions section.

ステージ間でコンテンツを配置できるのはだれですか。Who can deploy content between stages?

コンテンツは、空のステージにも、コンテンツを含むステージにも配置できます。Content can be deployed to an empty stage or to a stage that contains content. コンテンツは、Premium 容量に存在する必要があります。The content must reside on a premium capacity.

  • 空のステージへの配置 - ソース ワークスペースのメンバーまたは管理者であるすべての Pro または PPU のユーザー。Deploying to an empty stage - Any Pro or PPU user, that's a member or admin in the source workspace.

  • コンテンツがあるステージへの配置 - ソースとターゲットの展開ステージの両方でワークスペースのメンバーまたは管理者であるすべての Pro または PPU のユーザー。Deploying to a stage with content - Any Pro or PPU user, who's a member or admin of both workspaces in the source and target deployment stages.

  • データセットのオーバーライド - 配置では、データセットが変更されなかった場合でも、ターゲット ステージに含まれる各データセットがオーバーライドされます。Overriding a dataset - Deployment overrides each dataset that is included in the target stage, even if the dataset wasn't changed. ユーザーは、配置で指定されたすべてのターゲット ステージ データセットの所有者である必要があります。The user must be the owner of all the target stage datasets specified in the deployment.

データセット ルールを構成するには、どのようなアクセス許可が必要ですか。Which permissions do I need to configure dataset rules?

配置パイプラインでデータセット ルールを構成するには、データセットの所有者である必要があります。To configure dataset rules in deployment pipelines, you must be the dataset owner.

パイプラインのワークスペースが表示されないのですが、なぜでしょうか。Why can't I see workspaces in the pipeline?

パイプラインのアクセス許可とワークスペースのアクセス許可は、別々に管理されます。Pipeline and workspace permissions are managed separately. パイプラインのアクセス許可を持っていても、ワークスペースのアクセス許可を持っていない可能性があります。You may have pipeline permissions, but not workspace permissions. 詳細については、「アクセス許可」のセクションを参照してください。For more information, review the permissions section.

次の手順Next steps