倉庫開発と展開におけるGit統合の使い方

適用対象: Microsoft Fabric のウェアハウス✅

この記事では、Fabric Git統合とFabric Data Warehouseの使い方について説明します。

Important

この機能は プレビュー段階です

ブランチの作成、Gitリポジトリの更新、Fabricワークスペースへの変更同期、Gitへのウェアハウス変更のコミットなど、一般的な開発ワークフローをカバーしています。 これらのワークフローは、バージョン管理、コラボレーション、倉庫スキーマの変更の管理された展開を可能にします。

Fabric Data WarehouseのためのGitワークフロー

ワークスペースの設定ページから、gitプロバイダーへの接続を簡単に設定できます。 接続を設定するには、「Git 統合での作業開始」を参照してください。 手順に従って Git プロバイダーとして Git リポジトリに接続 し、Azure DevOps または GitHub に接続します。

ブランチの作成、チェックアウト/スイッチ

Fabric Data WarehouseワークスペースのGitブランチを管理できます。 新しいブランチを作成したり、ブランチ間を切り替えたり、別のワークスペースにブランチしたりできます。

現在のブランチウィンドウとドロップダウンリストのFabricポータルからのスクリーンショットです。

  • 新しい支店をチェックしてください: この作業のために新しい分岐を作成してください。 常に新しい業務部門で働き、 mainでは必ず働きましょう。 既存のワークスペースの状態を維持したまま、現在のワークスペースを新しいブランチに接続するには、[新しいブランチのチェックアウト] を選びます。

  • 別のワークスペースに分岐する: ワークスペースをブランチに作成または接続する方法の詳細については、「 別のワークスペースを使って開発する」をご覧ください。

  • 既存の支店間の切り替え: ブランチを切り替えると、ワークスペースは新しいブランチと同期し、ワークスペース内のすべてのアイテムが上書きされます。 詳細については、「 Switch branches」をご覧ください。

ワークフローを分岐させると、各ウェアハウスは他のウェアハウスとの依存関係を分析し、アイテム同期の順序を決定し、分岐ワークフローが期待通りに動作するかを確認します。

新しいブランチのチェックアウトの詳細については、「Git で競合を解決する」を参照してください。

データベースプロジェクトを使ってローカルで開発

Gitリポジトリのウェアハウスデータベースプロジェクトを使って ローカル開発 を行うことができます。 倉庫のデータベースプロジェクトに対してオフラインで開発することも可能です。

  1. ウェアハウスデータベースプロジェクトを含むGitリポジトリをクローンします。
  2. 例えば、Visual Studio CodeSQLデータベースプロジェクト拡張を使ってローカルでデータベースプロジェクトを開いてください。
  3. スキーマの更新やスクリプトの変更はデータベースプロジェクト内で直接行います。
  4. ローカルで変更を検証し、エラーがないかデータベースプロジェクトを構築します。
  5. 開発が完了したら、変更をリモートのGitブランチにコミットしてプッシュしてください。 プッシュされると、更新されたプロジェクト定義はGit統合ワークフローを通じてFabricワークスペースに同期されます。

Gitからワークスペースへの変更を同期します

機能や作業ブランチ(mainではない)で開発を完了した後、GitからFabricワークスペースに更新されたデータベースプロジェクト定義を同期させ、ウェアハウスが最新の承認変更を反映するようにできます。

  1. もし以前に機能ブランチを作成していた場合(例えばブランチ作成やチェックアウト時)、まずプル リクエスト を作成し、変更を対象のブランチにレビューしてマージしてください。 プルリクエストとは、あるブランチから別のブランチに変更をマージするためのリクエストのことです。

  2. プルリクエストがGitでマージされた後、Fabricワークスペースのソースコントロールに行きます。

  3. Gitリポジトリからワークスペースを更新または同期し、最新の変更をウェアハウスに適用します。

    Fabricポータルのスクリーンショットで、ソース管理ウィンドウの「すべて更新」ボタンと、ウェアハウスへの適用待ちの変更が待っています。

  4. GitとFabricワークスペース間の変更を同期している際に競合が発生した場合は、競合解決ガイダンスに従い競合を解決してください。

変更を加え、倉庫のアップデートをGitにコミットしてください

ライブウェアハウスに直接変更を加えたい場合は、ライブウェアハウスの定義からソース管理を更新できます。

Tip

構造化されたバージョン管理形式でスキーマ変更を管理するには、データベースプロジェクト内のウェアハウススキーマファイルを活用してください。 Developで説明されているように、データベースプロジェクト を使ってローカルでウェアハウスのスキーマ変更を計画できます。このセクションで説明するようにライブウェアハウスの状態に直接段階的に変更を加えるのではなく。

変更をレビューし、Gitリポジトリにコミットするには:

  1. ウェアハウスオブジェクトを作成または変更するには、FabricポータルのSQLクエリエディタSQL Server Management Studio(SSMS)、Visual Studio Code用のMSSQL拡張機能、またはその他のクエリツールでT-SQL文を実行します。 これらの変更は ライブウェアハウススキーマを更新します。

  2. FabricワークスペースのSource Controlにアクセスしてください。

  3. 修正された倉庫は変更リストの 保留中の変更項目 として表示されます。

  4. 分岐アウトやワークスペースからGitへの同期ワークフローでは、 システムはDacFxベースのインクリメンタル抽出を用いてスキーマ抽出を実行します。 スキーマ抽出は関連するスキーマの変更のみを捕捉します。 検出された変更点を確認してください:

    • 倉庫の品目定義と現在のブランチバージョンを比較してください。
    • 個別アイテムや複数のアイテムのスキーマの違いを検証してください。
  5. コミットしたい倉庫アイテムを選択してください。

  6. コミットメッセージを追加し、 変更をGitリポジトリにコミットします。

    Fabricポータルのソース制御メニューのスクリーンショットで、コミットダイアログとオプションのコミットメッセージが表示されます。

  7. コミットした後:

    • Gitリポジトリにアクセスしてください。
    • コミット履歴と更新されたデータベースプロジェクト項目で変更を確認しましょう。

    例えば、dbo.CustomersからAddress列を削除したコミットの場合:

    Fabricポータルからのスクリーンショットで、2つのコミットの違いを示しています。