Git統合Fabricワークスペース内の倉庫のシステムファイルバージョンをアップグレードします

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

この記事では、Git統合Fabricワークスペースで倉庫アイテムを最新のシステムファイルバージョンにアップグレードする方法を説明しています。

Microsoft Fabricは、ウェアハウスを含むアイテムタイプの基礎となるアイテム定義を定期的に更新します。 このアイテム定義が変わると、アイテムのconfig.versionファイルの.platform値はバンプされます。例えば1.0から2.0に。 既存の倉庫変更を壊さないため、Fabricはこのアップデートを自動的に適用しません。 代わりに、Fabricはソースコントロールでシステムアップデート可能通知を表示し、倉庫など特定のアイテムタイプに対していつ更新を適用するか選べます。

前提条件

• 1つ以上の倉庫を含む Gitリポジトリに接続されたワークスペース 。
• 作業空間内で貢献者または上位の役割。

システムファイルの更新が利用可能であることを特定してください

config.version値と$schemaURLには、ウェアハウスの現在のシステムファイルバージョンが含まれています。

1. Gitに接続されたワークスペースに行き、「 ソースコントロール」を選択してください。

2. 倉庫アイテムタイプでシステムアップデートが利用可能であれば、Fabricはソースコントロールペインの上部に「システムアップデート可能」バナーを表示します。

   また、Gitリポジトリのアイテムのconfig.versionファイルの.platformプロパティを確認することで、ウェアハウスの現在のシステムファイルのバージョンも確認できます。 例えば、.platformという名前の倉庫の以下のdwファイルは、2.0のシステムファイルバージョンを示しています。

   {
       "$schema": "https://developer.microsoft.com/json-schemas/fabric/gitIntegration/platformProperties/2.0.0/schema.json",
       "metadata": {
           "type": "Warehouse",
           "displayName": "dw"
       },
       "config": {
           "version": "2.0",
           "logicalId": "5e477a9e-0e1a-bf9b-4eb8-33420d62f352"
       }
   }
   

.platformファイルの詳細については、「自動生成システムファイル」をご覧ください。

システムファイルの更新を適用する前に、既存の変更をコミットしてください

「システムアップデートを適用」を選択する前に、ワークスペース内の保留変更をコミットしてください。

システムアップデートを適用し、倉庫の変更を同時にコミットすると、後で2つの変更セットを分離するのが難しくなります。 既存の変更を先にコミットすると、システムファイルの更新は独立したコミットとして表示されます。 この分離により、レビューや必要に応じてシステムアップデートを元に戻しても、自分の変更に影響を与えずに済むようになります。

1. Fabricワークスペースのソースコントロールに行ってください。
2. 変更リストの保留変更を確認してください。
3. コミットしたいアイテムを選択し、コミットメッセージを追加し、変更をGitリポジトリにコミットします。

変更のコミットについての詳細は、「 Gitへの変更作成およびウェアハウスアップデートのコミット」をご覧ください。

システムアップデートの適用

既存の変更をコミットした後、システムアップデートを適用してください。

1. ソースコントロールで「システムアップデートを適用」を選択します。

   

2. Fabricはワークスペース内のそのアイテムタイプのすべての倉庫にシステムアップデートを適用します。 複数の倉庫がある場合は、すべて同時に更新されます。 個別の倉庫を選択して更新することはできません。

3. 「 システム更新の適用 」通知が完了するまで待ちます。

システムアップデートのレビューとコミット

システムアップデートの適用が完了したら、コミットする前に違いを確認してください。

1. ソースコントロールで「変更リスト」へ行きます。 更新された各倉庫は「保留中の変更」として表示されます。

2. 倉庫を選択し、最新のアイテム定義と現在のバージョンを比較するために「 Review and commit changes 」を選択してください。 .sqlprojファイルと他のシステムファイルを比較して、何が変わったかを正確に確認できます。例えば、更新されたSdkバージョンなどです。

   

3. 変更が予想されていることを確認したら、ウェアハウスアイテムを選択し、コミットメッセージを追加し、システムアップデートをGitリポジトリに コミットするためにコミット を選択します。

ワークスペースに複数の倉庫がある場合、すべて同じシステムアップデートが表示されます。 各倉庫を個別またはまとめて同じ方法でレビュー・コミットし、すべての倉庫が最新バージョンにアップグレードされていることを確認します。

倉庫システムの更新履歴

システムファイルのバージョン履歴およびリリースノートについては、「システムファイルのリリースノート」Fabric Data Warehouse参照してください。

関連するコンテンツ

• 倉庫開発と展開におけるGit統合の使い方
• Fabric Warehouse開発のためのGit統合
• 自動生成されたシステム ファイル
• Gitでの紛争解決