セマンティック モデルの OneLake 統合

セマンティック モデルの Microsoft OneLake 統合により、モデル テーブルにインポートされたデータを OneLake の デルタ テーブルに自動的に書き込むこともできます。 Delta 形式は、Microsoft Fabric のすべてのコンピューティング エンジンの統合テーブル形式です。 OneLake 統合では、すべての主要なパフォーマンス機能を有効にしてデータをエクスポートし、よりシームレスなデータ アクセスと高いパフォーマンスを提供します。

データ サイエンティスト、データベース アナリスト、アプリ開発者、データ エンジニア、その他のデータ コンシューマーは、Power BI でビジネス インテリジェンスと財務レポートを作成するときと同じデータにアクセスできます。 T-SQL、Python、Scala、PySpark、Spark SQL、R、コードなし/ロー コード ソリューションはすべて、デルタ テーブルからのデータのクエリに使用できます。

組織で OneLake 統合ソリューションを実装する前に、この記事で後述する考慮事項と制限事項を必ずお読みください。

前提条件

セマンティック モデルの OneLake 統合は、Power BI Premium P SKU と Microsoft Fabric F SKU でのみサポートされます。 Power BI Pro、Premium Per User、または Power BI Embedded A/EM SKU ではサポートされていません。

OneLake 統合を有効にする前に、次のものが必要です。

• Power BI Premium または Fabric のキャパシティ上のワークスペース内にある 1 つ以上のインポート セマンティック モデル。
• モデルに対して有効になっている大規模セマンティック モデルの保存形式。

アクセス許可

モデル フォルダーの内容にアクセスし、Lakehouse エクスプローラーでフォルダーにリンクするショートカットを作成するには、モデル共同作成者 (読み取り、書き込み、探索) アクセス許可が必要です。

OneLake 統合を有効にする

セマンティック モデルの設定で、OneLake 統合を展開し、スライダーをクリックして [オン] をクリックし、[適用] を選択します。

管理ポータル

グローバル管理者とテナント管理者は、Power BI 管理ポータルで次の設定を使って OneLake 統合を制御できます。

• [Semantic models can export data to OneLake]\(セマンティック モデルは OneLake にデータをエクスポートできます\) - 組織レベルでの OneLake 統合を有効にします。 無効にすると、ユーザーはセマンティック モデルに対して OneLake 統合を有効にできず、OneLake 統合用に現在構成されているセマンティック モデルは、OneLake へのインポート テーブルのエクスポートを停止します。 OneLake 統合は、組織全体に対し既定で有効になります。

• [Users can store semantic model tables in OneLake]\(ユーザーは OneLake にセマンティック モデル テーブルを保存できます\) - 組織内のすべてのユーザーまたは選ばれたユーザーは、セマンティック モデル用に OneLake 統合を構成できます。 特定のユーザーについて無効にすると、そのユーザーは OneLake 統合を有効にできなくなりますが、OneLake 統合用に既に構成されているセマンティック モデルは、引き続きインポート テーブルを OneLake にエクスポートします。 そのユーザーは、OneLake 統合用に既に構成されているセマンティック モデルの OneLake 統合を無効にできますが、OneLake 統合を再度有効にすることはできません。 設定するには、[Semantic models can export data to OneLake]\(セマンティック モデルは OneLake にデータをエクスポートできます\) テナント設定を有効にする必要があります。 既定では、組織内のすべてのユーザーが、セマンティック モデル用に OneLake 統合を構成できます。

モデルの更新

モデル インポート データを OneLake のデルタ テーブルに書き込むには、モデルに対して少なくとも 1 つの手動またはスケジュールされた更新を実行する必要があります。 手動更新を実行するか、スケジュールされた更新が実行されるまで待機します。

OneLake のデルタ テーブルをエクスポートする

デルタ テーブルはさまざまな方法でエクスポートできます。 セマンティック モデルで XMLA 読み取り/書き込みモードが有効になっている場合は、表形式オブジェクト モデル (TOM) と表形式モデル スクリプト言語 (TMSL) を使用してプログラムでエクスポートできます。

たとえば、SQL Server Management Studio (SSMS) を使用して、次の TMSL コマンドを実行できます。

{  
 "export": {  
   "layout": "delta",
   "type": "full",  
   "objects": [  
     {  
       "database": "<database name>"  
     }  
   ]  
 }  
}

エクスポート ファイルを探索する

エクスポート後、OneLake と Windows エクスプローラーを統合する OneLake エクスプローラーを使用して、デルタ テーブルのエクスポート ファイルを見つけることができます。

1. OneLake エクスプローラーでワークスペース フォルダーを右クリックし、[OneLake から同期] を選択します。

2. Windows エクスプローラーを使用してデータ ファイルを見つけます。 ワークスペース フォルダーで、セマンティック モデルに一致し、末尾が .SemanticModel で終わる名前のサブフォルダーを検索します。 セマンティック モデル フォルダーには、デルタ テーブルの parquet ファイルとログを含むサブフォルダー内のすべてのインポート モード テーブルが含まれています。

   

ショートカット

セマンティック モデルの Lakehouse テーブルにショートカットを作成することで、Fafbric の他のワークロードからすばやく簡単にアクセスできます。

1. Lakehouse エクスプローラーで、[テーブル] を右クリックし、[新しいショートカット] を選択します。

2. [新しいショートカット] で、[Microsoft OneLake] を選択します。

3. [データ ソースの種類を選択] でセマンティック モデルを選択し、追加するテーブルを選びます。

   

考慮事項と制限事項

• プレビュー期間中、小数点が 18 を超える値を持つ通貨データ型は、デルタ ファイルにエクスポートすると、精度が低下する可能性があります。

• プレビュー期間中、BYOK 対応ワークスペースのセマンティック モデルはサポートされません。

• プレビュー期間中、Lakehouse にエクスポートされたモデルの上に構築されたショートカット テーブルは、SQL エンドポイントを使用してクエリを実行することはできません。

• プレビュー期間中は、複数地域 の容量はまだサポートされません。

• プレビュー期間中、モデルを OneLake 宛てにエクスポートする操作は課金されませんが、(そのエクスポートで取り込んだ) OneLake 上のモデルのコンピューティングとストレージ使用量は課金されます。

• エクスポートされたモデル テーブルに対する共同作成者アクセス許可を持ち、ワークスペースに対してはビューアーアクセス許可のみを持つユーザーの場合、モデル フォルダーは Lakehouse エクスプローラーに表示されますが、選択するとエラーが返されます。

• メジャー、DirectQuery テーブル、ハイブリッド テーブル、計算グループ テーブル、システム管理集計テーブルを Delta 形式テーブルにエクスポートすることはできません。

• 1 つのバージョンのデルタ テーブルのみがエクスポートされ、OneLake に格納されます。 以前のバージョンのデルタ テーブルは、エクスポートが成功した後に削除されます。 古いバージョンのデータを使用しているが削除された他の実行エンジンでは、一時的なエラーが発生する可能性があります。

関連するコンテンツ

• OneLake とは
• OneLake ファイル エクスプローラーの概要