Fabric Data Warehouse (プレビュー) のデプロイ前およびデプロイ後のスクリプト

適用対象:✅ Warehouse in Microsoft Fabric

Important

デプロイ前スクリプトとデプロイ後スクリプトを使用すると、Fabricにウェアハウスをデプロイする一環として、カスタム Transact-SQL コマンドを実行できます。デプロイ前およびデプロイ後のスクリプトを使用して、データのクリーンアップ、参照データのシード処理、またはウェアハウスのスキーマで表されていない SQL セキュリティの適用を行います。

Fabric Data Warehouseでは、デプロイ前または配置後のスクリプトは共有 SQL クエリです。これらのスクリプトは、SQL データベースプロジェクトで作成し、Fabric ポータルから指定できます。この指定は、ウェアハウスレベルのメタデータとして格納され、ウェアハウスの .sqlproj ファイルの一部としてソース管理にコミットされるため、手動で再適用することなく、Git とデプロイパイプラインをラウンドトリップします。

この記事では、デプロイ前およびデプロイ後のスクリプトの概要、Fabric ポータルでスクリプトを構成する方法、ソース管理パイプラインとデプロイパイプラインでの動作方法、および Visual Studio Code および SQL Server Management Studio (SSMS) でそれらを作成する方法について説明します。

Important

発行する前に、デプロイスクリプトと設定を常に確認してください。意図しないデータ損失を防ぐために、まず開発環境とテスト環境でテストします。

デプロイ前スクリプトと配置後スクリプトとは

ワークスペースをソース管理に接続すると、各ウェアハウスはSQLデータベースプロジェクトとして表示されます。これは、ウェアハウススキーマを構成するSQLオブジェクト(テーブル、ビュー、ストアドプロシージャ、関数)のソース制御スクリプトです。各オブジェクトは、.sqlなどのデータ定義言語 (DDL) 構文を含むCREATE TABLE ファイルとして格納されます。オブジェクトはスキーマの 目的の状態 を記述し、配置プロセスはその目的の状態をターゲットウェアハウスと比較し、ターゲットがプロジェクトと一致するようにオブジェクトを作成、変更、または削除する差分 T-SQL スクリプトを生成します。

デプロイ前スクリプトとデプロイ後スクリプトは、スキーマのデプロイを中心に実行される Transact-SQL を使用して、このプロセスを拡張します。

スキーマ配置計画が適用される前に、デプロイ前スクリプトが実行されます。
デプロイ後のスクリプトは、スキーマデプロイ計画の完了後に実行されます。

デプロイ前またはデプロイ後のスクリプトは、ウェアハウスの Queries フォルダーに格納されている共有クエリの 1 つです。 1 つのウェアハウスでは、デプロイ前スクリプトとデプロイ後スクリプトが最大 1 つサポートされます。この指定は、スクリプトコンテンツを複製するのではなく、ウェアハウスレベルのメタデータとして格納されるため、わずかなストレージオーバーヘッドが追加されます。

指定された各スクリプトは、ウェアハウスがデプロイされるたびに実行されるため、Transact-SQL はべき等になるように作成してください（繰り返し実行しても安全）。

Tip

スクリプトが 冪等性の場合、何度も実行しても問題が起きません。複数のデータベースに展開でき、ステータスを事前に決める必要はありません。

一般的なユースケース

参照および静的データ管理: スキーマのデプロイ後に、参照テーブル、構成テーブル、または参照テーブルから行を挿入、更新、または削除します。
データのクリーンアップ: スキーマの変更が適用される前または後に、古いデータまたは一時データを削除します。
環境のセットアップ: 開発環境、テスト環境、運用環境で異なる設定を適用するか、状態を初期化します。
メタデータドリブンパイプラインの初期化: ダウンストリームパイプラインの手順で必要なウェアハウスの状態を準備します。
SQL セキュリティ: ロール、ユーザー、 GRANT/DENY のアクセス許可などのウェアハウステーブルデータと SQL セキュリティ機能は、SQL データベースプロジェクトには含まれません。デプロイ後のスクリプトを使用して、テスト環境と運用環境の違いなど、デプロイ後にこれらのオブジェクトを再作成します。例については、 SQL セキュリティのデプロイ後スクリプトの例を参照してください。

SQL プロジェクトファイルの構造と構文

ウェアハウスSQLプロジェクトは、プロジェクトファイル(.sqlproj)内の事前展開および展開後スクリプトを参照し、 PreDeploy および PostDeploy アイテムタイプを使用します。各エントリは、プロジェクト内の 1 つの共有クエリファイルを指します。

次の例では、 pre-deployment.sql をデプロイ前スクリプトとして指定し、 post-deployment.sql を配置後スクリプトとして指定します。

<ItemGroup>
  <PreDeploy Include="pre-deployment.sql" />
  <PostDeploy Include="post-deployment.sql" />
</ItemGroup>

Important

Fabric Data Warehouseでは、デプロイ前スクリプトのファイルは 1 つだけ、配置後スクリプトでは 1 つのファイルのみがサポートされます。 SQLCMD :r コマンドを使用して他のファイルを参照するなど、複数のファイルからスクリプトを作成することはサポートされていません。 .sqlprojにデプロイ前またはデプロイ後のエントリが複数含まれている場合、Git の更新は失敗します。

SQL セキュリティのデプロイ後スクリプトの例

SQL データベースプロジェクトでは SQL セキュリティ機能がキャプチャされないため、配置後スクリプトは、ウェアハウスのデプロイ後に再作成する一般的な方法です。すべてのデプロイで実行できるようにスクリプトを記述します。

次の例では、DataReadersという名前のカスタムデータベースロールを作成し、SELECT スキーマdboアクセス許可を付与します。

-- post-deployment.sql
-- Recreate a role and grant permissions after deployment.
IF NOT EXISTS (SELECT 1 FROM sys.database_principals WHERE name = N'DataReaders')
BEGIN
    CREATE ROLE DataReaders;
END;
GO

GRANT SELECT ON SCHEMA::dbo TO DataReaders;
GO

Note

Fabric Data Warehouseでは、SQL Serverで使用できるすべてのTransact-SQL ステートメントがサポートされるわけではありません。スクリプト内のステートメントがFabric Data Warehouseでサポートされていることを確認します。

Fabric ポータルでデプロイ前と配置後のスクリプトを構成する

Fabric ポータルで、既存の共有クエリをデプロイ前または配置後スクリプトとして指定します。これは、オブジェクトエクスプローラーまたは倉庫アイテムの設定から行うことができます。

共有クエリをデプロイ前スクリプトと配置後スクリプトの両方として同時に指定することはできません。

オブジェクトエクスプローラーから

ウェアハウスエディターで、オブジェクトエクスプローラーの [クエリ] フォルダーを展開します。
使用する共有クエリを右クリックします。
- 必要なら、 クエリを「My queries 」から共有クエリに移してください。
[ デプロイスクリプトの設定] を選択します。この操作により、アイテム設定ウィンドウに移動します。
事前展開スクリプトおよびポストデプロイメントスクリプトフィールドで「スクリプト選択」を選択します。
「 Set a query」をデプロイ前/デプロイ後のスクリプトオプションとして 選び、それぞれの共有クエリを選択します。各ドロップダウンには倉庫内の共有クエリがすべてリストアップされています。

アイテム設定より

倉庫 の設定を開いてください。
CI/CDのセクションに行ってみてください。
事前展開スクリプトおよびポストデプロイメントスクリプトフィールドで「スクリプト選択」を選択します。
「 Set a query」をデプロイ前/デプロイ後のスクリプトオプションとして 選び、それぞれの共有クエリを選択します。各ドロップダウンには倉庫内の共有クエリがすべてリストアップされています。

選択した内容は、倉庫レベルのメタデータとして保存され、オブジェクトエクスプローラーと項目の設定の間で同期されます。

デプロイ前スクリプトと配置後スクリプトのデプロイでの動作

Git 統合を使用する

ワークスペースを Git リポジトリに接続すると、デプロイ前とデプロイ後の指定がコミット時にウェアハウスの .sqlproj ファイルにシリアル化されます。 Git からウェアハウスを更新すると、Fabricは変更をライブウェアハウスに適用し、次の順序でスクリプトを実行します。

デプロイ前スクリプトは、スキーマの変更が適用される前に実行されます。
スキーマ展開計画が適用されます。
デプロイ後スクリプトは、スキーマの変更が完了した後に実行されます。

Git を使用したラウンドトリップの指定: ポータルでスクリプトを構成してコミットするか、 .sqlproj で作成してワークスペースを更新すると、一貫した結果が得られます。コミットと更新を繰り返しても、構成が重複したり失われることはありません。許可されるデプロイ前スクリプトとデプロイ後スクリプトは 1 つだけであるため、Git で作成された構成によって、更新時にウェアハウス内の既存の指定が置き換えられます。

Note

事前展開および展開後スクリプトは、完全なGitワークフローサポートのために最新のソース管理経験が必要です。アップグレードされていないワークスペースでは、デプロイスクリプトのメタデータがソース管理と同期されておらず、デプロイスクリプトはGitベースのワークフローに参加しません。

この制限はGitワークフローにのみ適用され、デプロイパイプライン(ALM)の前提条件ではありません。

デプロイパイプラインを使用する

デプロイメントパイプラインは 、開発、 テスト、本番の各段階で倉庫をプロモーションする際に、事前展開および展開後の両方の指定を使用します。指定されたスクリプトは、各ターゲット環境で確定的に実行されるため、それらを使用して環境のセットアップを適用したり、コンテンツがステージ間を移動するときに SQL セキュリティを再適用したりできます。

ソース管理のないワークスペース内

ウェアハウス項目定義には、ワークスペースがソース管理に接続されていない場合でも、デプロイ前とデプロイ後の指定が含まれます。ウェアハウスのエクスポートには構成が含まれており、インポートすると構成はそのまま復元されます。

SQL データベースプロジェクトで配置前スクリプトと配置後スクリプトを作成する

Fabric ポータルの代わりに、Visual Studio Codeの SQL Database Projects 拡張機能または SQL Server Management Studio の統合 SQL プロジェクトエクスペリエンスを使用して、ウェアハウスの SQL データベースプロジェクトに配置前および配置後のスクリプトを直接作成できます。構成は、Fabric ポータル (オブジェクトエクスプローラー と項目の設定の両方) で、次の Git 更新の後に表示されます。

Visual Studio Code

Visual Studio Codeに SQL Database Projects 拡張機能をインストールします。
ウェアハウスの SQL データベースプロジェクトを開きます。ワークスペースが Git に接続されている場合は、リポジトリを複製してから、ウェアハウスプロジェクトフォルダーを開きます。
[ データベースプロジェクト] ビューで、プロジェクトノードを右クリックし、[ 配置前スクリプトの追加] または [ 配置後スクリプトの追加] を選択します。
ファイル拡張子を付けずにスクリプト名を指定します。スクリプトファイルがプロジェクトに追加され、エディターで開かれます。
スクリプトに Transact-SQL を追加し、ファイルを保存します。次のGitアップデートのために、ファイルが .sharedqueries フォルダに保存されていることを確認してください。
変更をコミットして Git リポジトリにプッシュし、ソース管理からワークスペースを更新して構成を適用します。

SQL Server Management Studio

SQL Database プロジェクトエクスペリエンスを含む、SQL Server Management Studio 22 以降を使用します。
ウェアハウスの SQL データベースプロジェクトを開きます。
ソリューションエクスプローラーで、プロジェクトノードを右クリックし、[追加>Script] を選択します。 [配置前スクリプト] または [配置後スクリプト] を選択します。
スクリプトファイルがプロジェクトに追加され、クエリエディターで開かれます。
スクリプトに Transact-SQL を追加し、ファイルを保存します。次のGitアップデートのためにファイルを .sharedqueries フォルダに保存してください。
変更をコミットして Git リポジトリにプッシュし、ソース管理からワークスペースを更新して構成を適用します。

プロジェクトファイルを直接編集する

どのツールでも、 .sqlproj ファイルを編集し、単一の PreDeploy または PostDeploy 項目を ItemGroupに追加することで、スクリプトを指定できます。

<ItemGroup>
  <PreDeploy Include="./sharedqueries/pre-deployment.sql" />
  <PostDeploy Include="./sharedqueries/post-deployment.sql" />
</ItemGroup>

既存の SQL プロジェクトから移行する

SQL Server Data Tools(SSDT)やVisual Studioからすでに<PreDeploy>および<PostDeploy>エントリを含む.sqlprojを移行した場合、インポートプロセスはそれらのエントリを認識し、展開前および展開後の構成Fabricにマッピングします。 Fabricではデプロイ前スクリプトと配置後スクリプトが 1 つしかサポートされないため、インポートする前に、プロジェクトに各種類のエントリが最大 1 つ含まれていることを確認します。

考慮事項と制限事項

1 つのウェアハウスでサポートされるデプロイ前スクリプトは 1 つだけで、デプロイ後のスクリプトは 1 つだけです。スクリプトごとに複数のファイルをサポートしていません。
デプロイ前スクリプトと配置後スクリプトの両方と同じ共有クエリを指定することはできません。
配置前または配置後スクリプトとして指定されている共有クエリを削除すると、対応する指定が自動的にクリアされます。
デプロイ前または配置後のスクリプトとして指定された共有クエリをユーザークエリに変更すると、対応する指定が自動的にクリアされます。
デプロイ前およびデプロイ後のスクリプトは、すべてのウェアハウスデプロイで実行されます。 Transact-SQL スクリプトは、繰り返し実行しても失敗したり重複するオブジェクトを作成したりしないよう、冪等である必要があります。
デプロイ前および配置後のスクリプトは、ビルド時にデータベースモデルに対して検証されません。スクリプトのエラーはデプロイ時に表示され、スクリプトエラーによってデプロイが停止します。
Fabric Data Warehouse でサポートされているTransact-SQL のみを使用できます。
デプロイを実行する ID には、スクリプトコンテンツを実行するために必要なアクセス許可が必要です。

フィードバック

このページはお役に立ちましたか?

最終更新: 2026-09-30

Fabric Data Warehouse (プレビュー) のデプロイ前およびデプロイ後のスクリプト

デプロイ前スクリプトと配置後スクリプトとは

一般的なユース ケース

SQL プロジェクト ファイルの構造と構文

SQL セキュリティのデプロイ後スクリプトの例

Fabric ポータルでデプロイ前と配置後のスクリプトを構成する

オブジェクト エクスプローラーから

アイテム設定より

デプロイ前スクリプトと配置後スクリプトのデプロイでの動作

Git 統合を使用する

デプロイ パイプラインを使用する

ソース管理のないワークスペース内

SQL データベース プロジェクトで配置前スクリプトと配置後スクリプトを作成する

Visual Studio Code

SQL Server Management Studio

プロジェクト ファイルを直接編集する

既存の SQL プロジェクトから移行する

考慮事項と制限事項

関連するコンテンツ

フィードバック

その他のリソース

一般的なユースケース

SQL プロジェクトファイルの構造と構文

オブジェクトエクスプローラーから

デプロイパイプラインを使用する

SQL データベースプロジェクトで配置前スクリプトと配置後スクリプトを作成する

プロジェクトファイルを直接編集する