Microsoft Fabric Advent Calendar 2025

Direct Lake セマンティックモデルをテナント間で移行する方法

Last updated at 2025-12-24Posted at 2025-12-22

はじめに

Direct Lake セマンティックモデルは Power BI サービス/Fabric (クラウド側) で保存され .pbix 形式での保存ができません。ローカルに保存するには Power BI プロジェクト形式 (.pbip) にエクスポートすることになります。

開発環境と本番環境を分ける場合、1つのテナントでワークスペースを分けることが多いのですが、テナントが分かれる場合もあるかと思います。Fabric/Power BI の開発では、ゲストユーザーは Power BI Desktop からの「発行」操作ができないなど、一部の機能に制限があるため、各テナントのユーザーとして作業するのが望ましいです。今回は開発者用の Power BI Pro ライセンスを開発テナントだけに用意して、招待された本番テナントに持ち込むという事情を考慮しています。Fabric アイテムの作成においては有償のユーザーライセンスは不要なので、本番テナントにも開発者用のアカウントを用意することをお勧めします。
今回は、開発テナントで作成した Direct Lake セマンティックモデルをローカルに保存して、本番テナントに反映する方法について手順を示します。

前提事項

開発テナントのユーザーは本番テナントにゲスト招待され、本番ワークスペースのメンバー ロールを付与されている。
本番テナントでは、テナント設定で以下の2つを有効化
- ゲストユーザーによる Microsoft Fabric へのアクセスが可能
  B2B 機能そのものを可能にする設定です。
- ゲストユーザーは Fabric コンテンツを閲覧およびアクセスできます
  ゲストユーザーは、Power BI サービス (Fabric ポータル) 左側のナビゲーションウィンドウを使用して閲覧エクスペリエンスにフルアクセスすることができます。この設定が無効だと、共有されたアイテムへの直接アクセスしかできないため、デプロイ作業を行う場合には有効化が必要となります。

Power BI Desktop の [ファイル] > [オプションと設定] > [オプション] > [プレビュー機能] に移動し、以下の2つの設定を有効化
- Power BI プロジェクト (.pbip) 保存オプション
- TMDL 形式を使用してセマンティックモデルを保存する
OneLake (レイクハウス) への Direct Lake であり、SQL 分析エンドポイントへの Direct Lake ではない。

SQL 分析エンドポイントへの Direct Lake の場合、下記手順4. で確認すべき id が異なります。(以降の手順における内容も未確認です。)

開発環境と本番環境では、レイクハウス、テーブル、列の名前は同じ

名前が異なる場合は、手順5. の編集対象がぐっと増えると思われます。
VS Code で Microsoft Fabric の拡張機能をインストール済み

VS Code 用 Microsoft Fabric 拡張機能を使用すると、VS Code 内で Fabric ワークスペースにアクセスし、表示し、管理することができます。

セマンティックモデルの移行手順

Power BI Desktop で開発テナントのレイクハウスに Direct Lake 接続するセマンティックモデルを作成
Power BI プロジェクト (.pbip) としてエクスポート
VS Code で Microsoft Fabric 拡張機能 (左側の帯の「F」アイコン) を開き、開発環境のアカウントでサインイン
VS Code でコマンド fabric: Switch tenant を実行するか [テナントの切り替え] ボタンをクリックし、本番テナントに切り替え、Direct Lake セマンティックモデルのデータソースとなるレイクハウスの workspaceId と id をメモする
VS Code で .pbip エクスポート時に開いたフォルダーを開き、
.SemanticModel/definition/expressions.tmdl を編集し、Source を本番環境の workspaceId と id に変更する
```
ソース = AzureStorage.DataLake("https://onelake.dfs.fabric.microsoft.com/<workspaceId>/<id>", [HierarchicalNavigation=true])
```
さらに、lineageTag を行ごと削除して、ファイルを保存します。

ファイルはテキストエディターなどで編集しても構いません。
既定では以下に保存されています。
C:\Users\<Username>\Microsoft Fabric\repos\<WorkspaceName>\
VS Code で Microsoft Fabric 拡張機能を開き、 Fabric 本番テナントのワークスペースに同期する
Fabric ポータル (Web 版) で本番テナントに切り替え、同期されたセマンティックモデルを開いて [編集] モードにし、[更新] する

更新が終わると、各テーブルに表示されている赤い [！] アイコンが消えます。