DACPAC ファイルを開梱する

2025-04-17

データ層アプリケーション (DAC) は、データベースモデル全体の自己完結型ユニットであり、DAC パッケージまたは .dacpacと呼ばれる成果物に移植可能です。運用環境に展開する前に .dacpac の内容を確認し、既存の DAC をアップグレードする前にアップグレードアクションを検証することをお勧めします。 .dacpacコンテンツの検証は、組織内で開発されていないパッケージを展開する場合に特に重要です。この記事では、Windows、macOS、Linux 用の .dacpac からデータベースモデルをアンパックするいくつかの方法について説明します。

警告

不明なソースまたは信頼されていないソースから .dacpac をデプロイしないことをお勧めします。このような DAC には、意図しないコードを実行したり、スキーマを変更してエラーを発生させたりする悪意のあるコードが含まれている可能性があります。不明なソースまたは信頼されていないソースの DAC を使用する前に、データベースエンジンの分離されたテストインスタンスに配置し、DAC をアンパックして、ストアドプロシージャやその他のユーザー定義コードなどのコードを調べます。

.dacpacの内容を調べるオプションは次のとおりです。

Visual Studio で SQL プロジェクトに .dacpac をインポートする
SqlPackage コマンドラインユーティリティを使用して、.dacpac を抽出する
ファイルを展開して XML コンテンツを表示する
.dacpacをテストインスタンスにデプロイする

.dacpacをデータベースから抽出した直後にアンパックしてオブジェクト定義を表示する方が、プロパティ /p:ExtractTarget=Fileで SqlPackage で Extract を使用すると、より効率的に実行できます。その結果、指定したソースデータベースのオブジェクト定義を含む 1 つの .sql ファイルが直接作成されます。

Visual Studio で DACPAC を SQL プロジェクトにインポートする

.dacpacを Visual Studio の SQL プロジェクトにインポートすると、.dacpacの内容が.sql ファイルに変換され、フォルダーに編成されます。インポート後、 .dacpac からのデプロイ後スクリプトとデプロイ前スクリプトがソリューションエクスプローラーに表示されます。

Visual Studio の一部として SQL Server Data Tools をインストールし、新しい SQL プロジェクトを作成します。
ソリューションエクスプローラーで、空のプロジェクトを右クリックし、[インポート] を選択し、データ層アプリケーションパッケージから選択します。

DACPAC を展開して XML コンテンツを表示する

.dacpac ファイルを展開すると、生の XML コンテンツがテキストエディターで表示できるようになります。 .dacpac内で特定のコンポーネントを検索する場合、XML コンテンツを確認すると、情報に簡単にアクセスできます。

.dacpac ファイルのファイル拡張子を.zipに変更します。
OS によって提供されるユーティリティを使用して、.zip ファイルを解凍します。コマンドラインからファイルを解凍するには:
```
unzip AdventureWorks.dacpac
```
結果の内容には、 DacMetadata.xml、 Origin.xml、および model.xmlが含まれます。

DACPAC をテストインスタンスにデプロイする

.dacpacをテストインスタンスにデプロイすると、.dacpacの内容がデータベースにパブリッシュされ、そこでさまざまな接続されたデータベースツールからオブジェクトを参照できるようになります。

注

テストインスタンスをローカルで作成するオプションの 1 つは、 Docker の SQL Server を使用することです。

Azure Data Studio を使用して DACPAC をデプロイする

Azure Data Studio に SQL Server dacpac 拡張機能をインストールします。
目的のインスタンスに接続します。サーバーノードを右クリックし、メニューから [データ層アプリケーションウィザード ] を選択します。
ウィザードから デプロイ オプションを選択し、[ ターゲットデータベース ] オプションを [新しいデータベース] に設定します。
デプロイ後、オブジェクトエクスプローラーで接続されているサーバー上のデータベースに移動し、データベースオブジェクトを参照します。

SqlPackage を使用して DACPAC をデプロイする

SqlPackage をインストールします。
SqlPackage CLI を使用して、 .dacpac ファイルを目的のインスタンスに発行します。 .dacpacをデータベースに発行するコマンドの例については、「SqlPackage の発行の例」を参照してください。

DACPAC 展開機能を備えたその他のツール

Azure Data Studio や SqlPackage 以外にも、他の多くのツールを使用して、 .dacpac をデータベースにデプロイできます。いくつかの例を次に示します。

SQL Server Management Studio
Visual Studio: SQL Server データツール

`Unpack()` メソッドを呼び出す

Microsoft.SqlServer.DacFx .NET API には、.dacpacをフォルダーにアンパックするためのメソッドが用意されています。このメソッドを使用すると、.dacpacをプログラムでフォルダーにアンパックすることができます。次の .NET アプリケーションの例では、2 つの引数 ( .dacpac ファイルへのパスと出力フォルダーへのパス) を受け取ります。結果は、3 つの XML ファイルに変換された .dacpac の内容と、すべてのデータベースオブジェクトを含む単一の.sql ファイルです。

using Microsoft.SqlServer.Dac;

namespace DacUnpack
{
    class Program
    {
        static void Main(string[] args)
        {
            var dacpacPath = args[0];
            var outputPath = args[1];

            if (!Directory.Exists(outputPath))
            {
                Directory.CreateDirectory(outputPath);
            }

            Console.WriteLine("Unpacking {0} to {1}", dacpacPath, outputPath);
            using(DacPackage dacpac = DacPackage.Load(dacpacPath))
            {
                dacpac.Unpack(outputPath);
            }
        }
    }
}

次の方法で共有

DACPAC ファイルを開梱する

Visual Studio で DACPAC を SQL プロジェクトにインポートする

DACPAC を展開して XML コンテンツを表示する

DACPAC をテスト インスタンスにデプロイする

Azure Data Studio を使用して DACPAC をデプロイする

SqlPackage を使用して DACPAC をデプロイする

DACPAC 展開機能を備えたその他のツール

Unpack() メソッドを呼び出す

関連コンテンツ

フィードバック

その他のリソース

DACPAC をテストインスタンスにデプロイする

`Unpack()` メソッドを呼び出す