アップグレードウィザードを使ってDataflow Gen1をDataflow Gen2(CI/CD)にアップグレード

Microsoft FabricのDataflows Upgrade Wizardは、Power BI Dataflow Gen1のアイテムをInplaceでDataflow Gen2(CI/CD)にアップグレードするガイド付き体験です。 アップグレードは各データフローのID、名前、スケジュール、接続を保持します。 単一のデータフローをアップグレードすることも、ワークスペースから複数のデータフローを同時にアップグレードすることも可能です。

ほとんどのデータフローでは、下流の意味モデルやレポートは変更なしで動作し続けます。 アップグレード前に、 評価ステータス と 既知の制限 を確認して、どのデータフローに注意が必要かを確認し、イン ベントリ でそれらを読み取る下流項目を見つけてください。 アップグレード後は、アップグレード後を参照してください。

前提条件

開始する前に次の操作を実行してください。

• Dataflow Gen1はFabric容量に割り当てられたワークスペースに存在している必要があります。
• Fabric アイテムの作成は、該当するスコープで許可されている必要があります（管理者設定 Users can create Fabric items が、テナント、キャパシティ、またはユーザー グループ レベルで有効になっている）。
• ワークスペースには管理者、メンバー、または貢献者のアクセスが必要です。
• Dataflow Gen1の所有者でなければなりませんね。 もしそうでなければ、ウィザードはデータフローを 「アップグレード不可」と報告します。 オーナーにアップグレードを実行するよう依頼するか、Take Over を使ってまずオーナーになるようにしましょう。

Dataflow Gen1をDataflow Gen2(CI/CD)にアップグレードする

ワークスペースのアイテムリストからDataflowsアップグレードウィザードを起動できます。

1. ワークスペースで、アップグレードしたいDataflow Gen1の横にある省略記号(...)を選択し、「 Upgrade to Dataflow Gen2 (Preview)」を選択します。

   

2. Power BI Dataflows Gen1(プレビュー)のアップグレードウィザードは概要ステップで開きます。 アップグレードの動作と 注意 通知を確認し、その後 「開始」を選択してください。

   

3. Dataflows Gen1を選択してください。 あなたが始めたDataflow Gen1はすでに選択済みです。 より多くのデータフローを一緒にアップグレードするには、このワークスペースから追加のDataflow Gen1項目を選択してください。 ステータス欄は各データフローの評価状況を示します。 ステータスの隣にあるインジケーターにカーソルを合わせると、そのデータフローに適用される理由が表示されます。 アップグレード後はほとんどの理由を処理できますが、50以上のクエリが有効なデータフローではまずアクションが必要です。 次へを選択します。

   

4. [レビュー]。 ウィザードが作成しようとしているDataflow Gen2(CI/CD)項目を確認しましょう。 各アップグレードされたデータフローは元のDataflow Gen1と同じ名前を維持します。項目タイプのみがDataflow Gen2(CI/CD)に変更されます。 [アップグレード] を選択します。

   

5. モニター。 ウィザードはアップグレードの進行状況を示します。 終了すると 「アップグレード完了 」が表示され、ワークスペースでアップグレードされたDataflow Gen2(CI/CD)アイテムを確認できます。 データフローがアップグレードに失敗した場合、エラーとしてリスト表示されます。 ウィザードを閉じるために OK を選択してください。

   

評価の状態

データフローを選択すると、ウィザードはそれぞれを評価し、以下のいずれかの状態を返します。

注目が必要状態には複数の理由があるかもしれません。 Select Dataflows Gen1ステップのステータス横のインジケーターにカーソルを合わせると、そのデータフローに適用されるすべての理由が表示されます。

評価はデータフロー自体をチェックし、それを読む項目自体をチェックするわけではなく、すべての制限を検出するわけではありません。 アップグレード前に 既知の制限 を確認しましょう。

注意が必要

注意が必要なデータフローをアップグレードすることは可能ですが、推奨されるアクションを実行してデータフローやその下流の項目を正常に動作させ続けます。

DirectQueryやリンクされたエンティティの理由は、依存関係の証明ではなく検出信号です。 アップグレードする前に、実際のコンシューマー（リネージビューまたはインベントリを参照）を確認してください。 データフローはリンクされたエンティティ関係の両側に存在するため、両方のリンクされたエンティティの理由が適用される場合は両方のアクションを実行します。

アップグレード不可

ウィザードは、あなたがデータフローの所有者でない場合、「 アップグレード不可 」と報告します。 ウィザードでアップグレードを実行できるのは所有者だけです。 オーナーに運営してもらうか、 Take Over を使ってオーナーになって自分で運営するのも良いでしょう。

アップグレード後

ワークスペースでは、元のDataflow Gen1の代わりにDataflow Gen2(CI/CD)項目が表示され、名前とIDも同じです。 これらの手順を順番に完了させてください。

1. アップグレードされた各データフローを更新してください。 アップグレードは新しいデータフローを更新しないため、リフレッシュするまでデータは保持されません。 それを読み取る下流のデータフローは、この最初の更新が完了するまでエラーを返します。
2. アップグレードされたデータフローを読み取る下流データフローを開いて保存してください。 保存すると、アップグレードされたデータフローに再割り当てされます。 このステップをスキップすると、下流のデータフローは古いデータを返し続けます。
3. アップグレードしたデータフローに適用された「注意が必要」アクションをすべて完了してください。

既知の制限

アップグレード前にこれらの制限を確認してください。

アップグレードはそのまま行われており、元に戻せません

このアップグレードにより、元のDataflow Gen1は同じIDと名前を使用する新しいDataflow Gen2(CI/CD)に置き換えられます。 アップグレードは元に戻せません。 元のDataflow Gen1を維持しながらアップグレードするには、 代わりにSave As を使ってDataflow Gen2(CI/CD)コピーを作成してください。

過去のデータが引き継がれません

Dataflow Gen1に保存されるデータは、ソースからのデータのキャッシュです。ソースシステムは記録システムとして残ります。 Dataflow Gen2は異なるストレージアーキテクチャを使用しているため、アップグレード後はこのキャッシュデータは利用できません。 もしソースから過去のデータを再読み込みできない場合は、アップグレード前にデータフローデータをバックアップし(例えばレイクハウスに)、アップグレードしたデータフロー上でデータのデスティネーションを設定して、今後のリフレッシュを永続化させてください。

従来のPower BI Dataflowsコネクタはアップグレードされたデータフローを読み取れません

レガシーのPower BI DataflowsコネクタはDataflow Gen2(CI/CD)項目に接続できないため、そのコネクタ経由でこのデータフローを消費するアイテムは、次にリフレッシュされたときに失敗します。 インポートされたデータを保持しているアイテムはその間ずっとそのデータを表示し続けるので、アップグレード直後は影響を受けていないように見えます。 それらの項目を最新の Power Platform Dataflows コネクターに更新してください。 手順については、 消費者を最新のPower Platform Dataflowsコネクタに更新するをご覧ください。

データフローをアップグレード中はリフレッシュできません

手動やスケジュールされたリフレッシュは、ウィザードがデータフローをアップグレードしている間は実行されません。 アップグレードが完了したらデータフローを更新してください。

失敗したアップグレードは24時間以内に再試できません

アップグレードが失敗した場合、ウィザードは元のDataflow Gen1を復元します。 そのデータフローの新しいアップグレードは24時間経過しないと始められません。 すぐに再試行しても失敗します。

アップグレード後30日間はアウトバウンドアクセス保護を有効にすることはできません

アップグレードされたDataflow Gen1は、最大30日間ソフト削除状態のまま保持されます。 その期間中は、ワークスペースでアウトバウンドアクセス保護(OAP)を有効にすることはできません。 保持期間が過ぎるのを待つか、すでにOAPが有効になっているワークスペースを使うのが良いでしょう。

Power BI REST APIを使用するアプリケーション

Dataflow Gen2はFabric REST APIを使用しており、Power BI REST APIと完全なパリティを持っていません。 もしアプリケーションがPower BI REST APIを通じてGen1のデータフローをトリガーまたは管理した場合、それらの呼び出しを確認し、対応するFabric REST APIエンドポイントに更新してください。

政府コミュニティクラウド(GCC)環境はサポートされていません

Fabric Dataflow Gen2は現在GCCで利用できないため、GCC環境でDataflow Gen1をアップグレードすることはできません。

Workspace Viewerはアップグレードされたデータフローからテーブルを利用できません

ビューアワークスペースの役割を持つユーザーはアップグレードされたDataflow Gen2を見ることができますが、Power Platform Dataflowsコネクタを通じてそのテーブルを利用することはできません。 アップグレードされたデータフローを利用する必要があるユーザーに、コントリビューター、メンバー、または管理者ワークスペースの役割を割り当てます。 詳細については、Power Query Dataflow connector - Power Query |Microsoft Learn。

利用者を新しい Power Platform Dataflows コネクタに更新する

レガシーのPower BI DataflowsコネクタはDataflow Gen2(CI/CD)項目を読み取ることができません。 アップグレード後は、レガシーコネクタ経由でアップグレードされたデータフローを消費するセマンティックモデルやデータフローを更新し、代わりに最新の Power Platform Dataflows コネクタを使わせてください。

ウィザードはレガシーコネクタの使用を検出せず、Fabric外に保存されているPower BIデスクトップファイルやExcelワークブックも評価できません。 警告がないからといってローカルファイルが影響を受けていないわけではありません。 アップグレードされたデータフローを読み取る.pbixや .xlsx ファイルの在庫管理を行い、クエリを更新し、更新を検証します。

例:クエリでコネクタを変更する

こちらはレガシーのPower BI Dataflowsコネクタを通じてデータフローを読み取るクエリです。

let
    Source = PowerBI.Dataflows([]),
    #"Navigation 1" = Source{[workspaceId = "<workspace ID>"]}[Data],
    #"Navigation 2" = #"Navigation 1"{[dataflowId = "<dataflow ID>"]}[Data],
    #"Navigation 3" = #"Navigation 2"{[entity = "Customers"]}[Data]
in
    #"Navigation 3"

こちらは同じクエリで、最新の Power Platform Dataflows コネクターを使って更新しました。 2つの点が変わります:コネクタ機能と、レガシーコネクタにはない Workspaces ナビゲーションステップです。 ワークスペースID、データフローID、エンティティ名は同じままです。なぜならアップグレードでこれら3つすべてが保持されるからです。

let
    Source = PowerPlatform.Dataflows([]),
    #"Navigation 1" = Source{[Id = "Workspaces"]}[Data],
    #"Navigation 2" = #"Navigation 1"{[workspaceId = "<workspace ID>"]}[Data],
    #"Navigation 3" = #"Navigation 2"{[dataflowId = "<dataflow ID>"]}[Data],
    #"Navigation 4" = #"Navigation 3"{[entity = "Customers"]}[Data]
in
    #"Navigation 4"

変更の場所

Power Queryで変更を行ってください。

1. アップグレードされたデータフローを読み取るクエリを Advanced Editorで開いてください。
2. クエリを前の例のようにモダンコネクターに更新してください。 クエリで既に使われているワークスペースID、データフローID、エンティティ名を保持してください。
3. 求められたら、組織アカウントを使って Power Platform Dataflows ソースにサインインしてください。 現代のコネクタは従来のものとは別の供給元なので、既に持っている認証情報は引き継がれません。
4. 変更を保存してからリフレッシュして確認してください。

DirectQueryの消費者

DirectQueryはDataflow Gen2ではサポートされていないため、コネクタを切り替えるだけではDirectQuery接続は復元されません。 DirectQueryモードでデータフローを読み取る下流セマンティックモデルについては、コネクターの更新に加え、ストレージモードを インポート または ダイレクトレイク に変更してください。

関連するコンテンツ

• Dataflow Gen2 (CI/CD) への移行には「名前を付けて保存」を使用する
• Dataflow Gen1 から Dataflow Gen2 への移行
• データフローの移行シナリオ
• クエリを Dataflow Gen1 から Dataflow Gen2 に移動する
• CI/CD と Git 統合のサポートを備えたデータフロー Gen2