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

重要

セマンティック モデルの OneLake 統合は現在、プレビュー段階にあります。

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

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

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

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

前提 条件

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

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

権限

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

OneLake 統合を有効にする

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

モデル設定で OneLake 統合を有効にします。

管理ポータル

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

管理ポータルのテナント設定のスクリーンショット。

  • セマンティック モデルでは、OneLake にデータをエクスポートできます。これにより、組織レベルでの OneLake 統合が可能になります。 無効にした場合、ユーザーはセマンティック モデルに対して OneLake 統合を有効にできません。OneLake 統合用に現在構成されているセマンティック モデルは、OneLake へのインポート テーブルのエクスポートを停止します。 OneLake 統合は、組織全体で既定で有効になっています。

  • ユーザーは、セマンティック モデル テーブルを OneLake に格納できます。これにより、組織内のすべてのユーザーまたは選択したユーザーが、セマンティック モデルの OneLake 統合を構成できます。 特定のユーザーに対して無効にした場合、そのユーザーは OneLake 統合を有効にできなくなりますが、OneLake 統合用に既に構成されているセマンティック モデルは、引き続きインポート テーブルを OneLake にエクスポートします。 そのユーザーは、OneLake 統合用に既に構成されているセマンティック モデルに対して OneLake 統合を無効にできますが、OneLake 統合を再度有効にすることはできません。 この設定では、セマンティック モデルが OneLake テナント設定にデータをエクスポートして有効にする必要があります。 既定では、組織内のすべてのユーザーは、セマンティック モデル用に OneLake 統合を構成できます。

モデルの更新

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

OneLake Delta テーブルをエクスポートする

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

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

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

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

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

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

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

    SSMS で TMSL のエクスポートコマンドを実行します。

ショートカット

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

  1. Lakehouse Explorer で、「テーブル」を右クリックし、「新しいショートカット」を選択してください。

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

  3. データ ソースの種類を選択し、セマンティック モデルを選択し、含めるテーブルを選択します。

    エクスプローラーで OneLake ショートカット

考慮事項と制限事項

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

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

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

  • プレビュー期間中、Multi-Geo 容量はまだサポートされていません。

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

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

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

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