次の方法で共有


セマンティック モデルの 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 統合を有効にする前に、Power BI Premium または Fabric 容量のワークスペースに 1 つ以上の インポート セマンティック モデル が必要です。 インポート セマンティック モデルは、データが Power BI のメモリ内ストレージに完全にインポートされるデータ モデルの一種であり、高速で効率的なクエリを実行できます。

権限

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

OneLake 統合を有効にする

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

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

管理ポータル

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

  • ユーザーは Fabric 項目を作成できます 。OneLake 統合を含め、運用環境に対応した Fabric 機能を有効にします。 この設定は、組織レベルと容量レベルの両方で管理できます。 無効にした場合、ユーザーはセマンティック モデルに対して OneLake 統合を有効にできません。OneLake 統合用に現在構成されているセマンティック モデルは、OneLake へのインポート テーブルのエクスポートを停止します。 OneLake 統合は、組織全体で既定で有効になっています。 次の図は、この設定が有効になっていることを示しています。

    ユーザーが Fabric アイテムを作成できるようにする管理ポータル設定のスクリーンショット。

  • セマンティック モデルでは、OneLake にデータをエクスポートできます。OneLake 統合用に構成されたセマンティック モデルで、インポート テーブルを OneLake に送信できます。 組織全体に適用されます。 次の図は、この設定が有効になっていることを示しています。

    セマンティック モデルを onelake にエクスポートできるようにする管理ポータル設定のスクリーンショット。

モデルの更新

モデル インポート データを OneLake の Delta テーブルに書き込むには、モデルに対して少なくとも 1 つの手動またはスケジュールされた更新を実行する必要があります。 手動更新を実行するか、スケジュールされた更新を待ちます。 エクスポート期間を分析するには、更新履歴の OneLake 統合タブのログ エントリを確認します。

エクスポート期間を分析するための更新履歴の OneLake 統合タブ

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

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

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

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

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

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

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

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

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

ショートカット

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

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

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

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

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

考慮事項と制限事項

  • ワークスペース管理者、メンバー、共同作成者、およびセマンティック モデルに対する直接書き込みアクセス許可を持つユーザーには、OneLake のエクスポートされた成果物フォルダーに対する読み取りアクセス許可が付与されます。

  • セマンティック モデルに対する読み取りアクセス許可を持つユーザーは、セマンティック モデルに対して RLS/OLS ロールが定義されていない場合にのみ、OneLake の成果物フォルダーに対する読み取りアクセス許可を取得します。

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

  • BYOK 対応ワークスペースのセマンティック モデルはサポートされていません。

  • 複数地域 の容量はまだサポートされていません。

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

  • 古いバージョンのデルタ テーブルは、3 日後に削除されます。 古いバージョンを使用しているが、削除されたバージョンのデータを使用する他の実行エンジンは、使用可能なバージョンに進む必要があります。