セマンティック モデルの OneLake 統合
重要
セマンティック モデルの 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 エクスプローラーを使用して、デルタ テーブルのエクスポート ファイルを見つけることができます。
OneLake エクスプローラーでワークスペース フォルダーを右クリックし、[OneLake から同期] を選択します。
Windows エクスプローラーを使用してデータ ファイルを見つけます。 ワークスペース フォルダーで、セマンティック モデルに一致し、末尾が .SemanticModel で終わる名前のサブフォルダーを検索します。 セマンティック モデル フォルダーには、デルタ テーブルの parquet ファイルとログを含むサブフォルダー内のすべてのインポート モード テーブルが含まれています。
ショートカット
セマンティック モデルの Lakehouse テーブルにショートカットを作成することで、Fafbric の他のワークロードからすばやく簡単にアクセスできます。
Lakehouse エクスプローラーで、[テーブル] を右クリックし、[新しいショートカット] を選択します。
[新しいショートカット] で、[Microsoft OneLake] を選択します。
[データ ソースの種類を選択] でセマンティック モデルを選択し、追加するテーブルを選びます。
考慮事項と制限事項
プレビュー期間中、小数点が 18 を超える値を持つ通貨データ型は、デルタ ファイルにエクスポートすると、精度が低下する可能性があります。
プレビュー期間中、BYOK 対応ワークスペースのセマンティック モデルはサポートされません。
プレビュー期間中、Lakehouse にエクスポートされたモデルの上に構築されたショートカット テーブルは、SQL エンドポイントを使用してクエリを実行することはできません。
プレビュー期間中は、複数地域 の容量はまだサポートされません。
プレビュー期間中、モデルを OneLake 宛てにエクスポートする操作は課金されませんが、(そのエクスポートで取り込んだ) OneLake 上のモデルのコンピューティングとストレージ使用量は課金されます。
エクスポートされたモデル テーブルに対する共同作成者アクセス許可を持ち、ワークスペースに対してはビューアーアクセス許可のみを持つユーザーの場合、モデル フォルダーは Lakehouse エクスプローラーに表示されますが、選択するとエラーが返されます。
メジャー、DirectQuery テーブル、ハイブリッド テーブル、計算グループ テーブル、システム管理集計テーブルを Delta 形式テーブルにエクスポートすることはできません。
1 つのバージョンのデルタ テーブルのみがエクスポートされ、OneLake に格納されます。 以前のバージョンのデルタ テーブルは、エクスポートが成功した後に削除されます。 古いバージョンのデータを使用しているが削除された他の実行エンジンでは、一時的なエラーが発生する可能性があります。