DACPAC ファイルを確認する

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceMicrosoft Fabric 内の SQL データベース

既存の SQL プロジェクトを SDK スタイルのプロジェクトに変換するプロセスは、.sqlproj ファイルを手動で編集して、Microsoft.Build.Sql SDK スタイルのプロジェクト形式を含めます。 変換を開始する前に、プロジェクト ファイルをバックアップし、プロジェクトの .dacpac をアーカイブすることをお勧めします。 プロジェクトからビルドされた "before" と "after" .dacpac を比較することで、変換プロセスが正しく完了したことを確認できます。

DacpacVerify CLI (プレビュー) は、2 つの.dacpac ファイルを比較し、ファイル間の違いを出力するコマンド ライン ツールです。 このツールは、変換の前後に .dacpac ファイルを比較することで、プロジェクトの変換が成功したことを確認するのに役立ちます。

[前提条件]

SqlPackage コマンド ライン ツールと同様に、DacpacVerify CLI (プレビュー) は dotnet ツールとして使用できます。 DacpacVerify は Windows、macOS、Linux にインストールでき、 コンピューターに .NET SDK をインストールする必要があります。 DacpacVerify CLI をインストールするには、次のコマンドを実行します。

dotnet tool install --global Microsoft.DacpacVerify --prerelease

DacpacVerify ツール

DacpacVerify ツールの基本的な使用方法には、 dacpacverify コマンドを実行した後、比較する 2 つの .dacpac ファイルへのパスが含まれます。

dacpacverify before.dacpac after.dacpac

このツールは、2 つのファイル間の違いの概要を出力します。 .dacpac ファイルの検証には、次のものが含まれます。

• デプロイ前スクリプト
• デプロイ後のスクリプト
• SQLCMD 変数
• データベース参照
• データベースのプロパティ/オプション
• データベース オブジェクト (テーブル、ビュー、ストアド プロシージャなど)

変換されたプロジェクトを確認する

この例では、SQL プロジェクト変換の前後に .dacpac ファイルを比較して、プロジェクト変換を検証します。 変換の前に、プロジェクトをビルドし、 .dacpac ファイルを作成します。既定では、 bin/Debug フォルダーになります。 後で別のフォルダーにbefore.dacpac名前と比較するために、.dacpac ファイルのコピーを作成します。

元の SQL プロジェクト

<?xml version="1.0" encoding="utf-8"?>
<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003" ToolsVersion="4.0">
  <PropertyGroup>
    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
    <Name>ConversionTest</Name>
    <SchemaVersion>2.0</SchemaVersion>
    <ProjectVersion>4.1</ProjectVersion>
    <ProjectGuid>{<unique identifier>}</ProjectGuid>
    <DSP>Microsoft.Data.Tools.Schema.Sql.Sql160DatabaseSchemaProvider</DSP>
    <OutputType>Database</OutputType>
    <RootPath>
    </RootPath>
    <RootNamespace>ConversionTest</RootNamespace>
    <AssemblyName>ConversionTest</AssemblyName>
    <ModelCollation>1033, CI</ModelCollation>
    <DefaultFileStructure>BySchemaAndSchemaType</DefaultFileStructure>
    <DeployToDatabase>True</DeployToDatabase>
    <TargetFrameworkVersion>v4.7.2</TargetFrameworkVersion>
    <TargetLanguage>CS</TargetLanguage>
    <AppDesignerFolder>Properties</AppDesignerFolder>
    <SqlServerVerification>False</SqlServerVerification>
    <IncludeCompositeObjects>True</IncludeCompositeObjects>
    <TargetDatabaseSet>True</TargetDatabaseSet>
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
    <OutputPath>bin\Release\</OutputPath>
    <BuildScriptName>$(MSBuildProjectName).sql</BuildScriptName>
    <TreatWarningsAsErrors>False</TreatWarningsAsErrors>
    <DebugType>pdbonly</DebugType>
    <Optimize>true</Optimize>
    <DefineDebug>false</DefineDebug>
    <DefineTrace>true</DefineTrace>
    <ErrorReport>prompt</ErrorReport>
    <WarningLevel>4</WarningLevel>
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
    <OutputPath>bin\Debug\</OutputPath>
    <BuildScriptName>$(MSBuildProjectName).sql</BuildScriptName>
    <TreatWarningsAsErrors>false</TreatWarningsAsErrors>
    <DebugSymbols>true</DebugSymbols>
    <DebugType>full</DebugType>
    <Optimize>false</Optimize>
    <DefineDebug>true</DefineDebug>
    <DefineTrace>true</DefineTrace>
    <ErrorReport>prompt</ErrorReport>
    <WarningLevel>4</WarningLevel>
  </PropertyGroup>
  <PropertyGroup>
    <VisualStudioVersion Condition="'$(VisualStudioVersion)' == ''">11.0</VisualStudioVersion>
    <!-- Default to the v11.0 targets path if the targets file for the current VS version isn't found -->
    <SSDTExists Condition="Exists('$(MSBuildExtensionsPath)\Microsoft\VisualStudio\v$(VisualStudioVersion)\SSDT\Microsoft.Data.Tools.Schema.SqlTasks.targets')">True</SSDTExists>
    <VisualStudioVersion Condition="'$(SSDTExists)' == ''">11.0</VisualStudioVersion>
  </PropertyGroup>
  <Import Condition="'$(SQLDBExtensionsRefPath)' != ''" Project="$(SQLDBExtensionsRefPath)\Microsoft.Data.Tools.Schema.SqlTasks.targets" />
  <Import Condition="'$(SQLDBExtensionsRefPath)' == ''" Project="$(MSBuildExtensionsPath)\Microsoft\VisualStudio\v$(VisualStudioVersion)\SSDT\Microsoft.Data.Tools.Schema.SqlTasks.targets" />
  <ItemGroup>
    <Folder Include="Properties" />
  </ItemGroup>
  <ItemGroup>
    <Build Include="Table1.sql" />
    <Build Include="View1.sql" />
    <Build Include="View2.sql" />
  </ItemGroup>
  <ItemGroup>
    <SqlCmdVariable Include="EnvironmentName">
      <DefaultValue>
      </DefaultValue>
      <Value>$(SqlCmdVar__1)</Value>
    </SqlCmdVariable>
  </ItemGroup>
</Project>

最小限に変換された SQL プロジェクト

VS Code またはその他のテキスト エディターの変換ガイドの必要な手順にのみ従うことで、プロジェクト ファイルは dotnet build を使用してビルドされ、.dacpac ファイルが作成されるようになりました。 SDK 参照の追加に加えて、以下を削除しました。

• <Import> 要素
• <Folder> 要素
• <Build>.sqlproj フォルダー内にある要素

最小変換後のプロジェクト ファイルは次のようになります。

<?xml version="1.0" encoding="utf-8"?>
<Project DefaultTargets="Build" ToolsVersion="4.0">
  <Sdk Name="Microsoft.Build.Sql" Version="1.0.0" />
  <PropertyGroup>
    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
    <Name>ConversionTest</Name>
    <SchemaVersion>2.0</SchemaVersion>
    <ProjectVersion>4.1</ProjectVersion>
    <ProjectGuid>{<unique identifier>}</ProjectGuid>
    <DSP>Microsoft.Data.Tools.Schema.Sql.Sql160DatabaseSchemaProvider</DSP>
    <OutputType>Database</OutputType>
    <RootPath>
    </RootPath>
    <RootNamespace>ConversionTest</RootNamespace>
    <AssemblyName>ConversionTest</AssemblyName>
    <ModelCollation>1033, CI</ModelCollation>
    <DefaultFileStructure>BySchemaAndSchemaType</DefaultFileStructure>
    <DeployToDatabase>True</DeployToDatabase>
    <TargetFrameworkVersion>v4.7.2</TargetFrameworkVersion>
    <TargetLanguage>CS</TargetLanguage>
    <AppDesignerFolder>Properties</AppDesignerFolder>
    <SqlServerVerification>False</SqlServerVerification>
    <IncludeCompositeObjects>True</IncludeCompositeObjects>
    <TargetDatabaseSet>True</TargetDatabaseSet>
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
    <OutputPath>bin\Release\</OutputPath>
    <BuildScriptName>$(MSBuildProjectName).sql</BuildScriptName>
    <TreatWarningsAsErrors>False</TreatWarningsAsErrors>
    <DebugType>pdbonly</DebugType>
    <Optimize>true</Optimize>
    <DefineDebug>false</DefineDebug>
    <DefineTrace>true</DefineTrace>
    <ErrorReport>prompt</ErrorReport>
    <WarningLevel>4</WarningLevel>
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
    <OutputPath>bin\Debug\</OutputPath>
    <BuildScriptName>$(MSBuildProjectName).sql</BuildScriptName>
    <TreatWarningsAsErrors>false</TreatWarningsAsErrors>
    <DebugSymbols>true</DebugSymbols>
    <DebugType>full</DebugType>
    <Optimize>false</Optimize>
    <DefineDebug>true</DefineDebug>
    <DefineTrace>true</DefineTrace>
    <ErrorReport>prompt</ErrorReport>
    <WarningLevel>4</WarningLevel>
  </PropertyGroup>
  <PropertyGroup>
    <VisualStudioVersion Condition="'$(VisualStudioVersion)' == ''">11.0</VisualStudioVersion>
    <!-- Default to the v11.0 targets path if the targets file for the current VS version isn't found -->
    <SSDTExists Condition="Exists('$(MSBuildExtensionsPath)\Microsoft\VisualStudio\v$(VisualStudioVersion)\SSDT\Microsoft.Data.Tools.Schema.SqlTasks.targets')">True</SSDTExists>
    <VisualStudioVersion Condition="'$(SSDTExists)' == ''">11.0</VisualStudioVersion>
  </PropertyGroup>
  <ItemGroup>
    <SqlCmdVariable Include="EnvironmentName">
      <DefaultValue>
      </DefaultValue>
      <Value>$(SqlCmdVar__1)</Value>
    </SqlCmdVariable>
  </ItemGroup>
</Project>

<SqlCmdVariable>要素を誤って削除しても、プロジェクトはビルドされますが、.dacpac ファイルには SQLCMD 変数が含まれません。 DacpacVerify 出力はこの違いを反映し、続行する前に違いを修正する手順をたどります。

プロジェクト ファイルは Microsoft.Build.Sql SDK スタイルの形式に変換されましたが、プロジェクト ファイルをさらに簡略化できます。

完全に変換された SQL プロジェクト

プロジェクト ファイルにさらに変更を加えて、既定に一致するプロパティと要素を SDK から削除できます。 既定値と一致する場合はプロジェクトのプロパティを削除でき、DacpacVerify は.dacpac ファイル内のデータベース プロパティを比較します。

Release構成とDebug構成の<PropertyGroup>要素を削除する場合は、-c Releaseまたは-c Debugオプションを指定して dotnet build コマンドを実行して、各構成でプロジェクトをビルドする必要があります。 構成ごとに .dacpac ファイルを生成することで、2 つの .dacpac ファイルを元のファイルと比較して、同じ .dacpac 出力を確実に生成できます。

最小限の Microsoft.Build.Sql プロジェクトへの変換が完了すると、完全な変換後、プロジェクト ファイルは次のようになります。

<?xml version="1.0" encoding="utf-8"?>
<Project DefaultTargets="Build" ToolsVersion="4.0">
  <Sdk Name="Microsoft.Build.Sql" Version="1.0.0" />
  <PropertyGroup>
    <Name>ConversionTest</Name>
    <ProjectGuid>{<unique-identifier>}</ProjectGuid>
    <DSP>Microsoft.Data.Tools.Schema.Sql.Sql160DatabaseSchemaProvider</DSP>
    <ModelCollation>1033, CI</ModelCollation>
  </PropertyGroup>
  <ItemGroup>
    <SqlCmdVariable Include="EnvironmentName">
      <DefaultValue>
      </DefaultValue>
      <Value>$(SqlCmdVar__1)</Value>
    </SqlCmdVariable>
  </ItemGroup>
</Project>

変換後、プロジェクトをもう一度ビルドし、新しい .dacpac ファイルを作成します。 最後に、DacpacVerify CLI を使用して、元のファイルと変換後の .dacpac ファイルを比較します。

関連コンテンツ

• 元の SQL プロジェクトを SDK スタイルのプロジェクトに変換する
• SQL プロジェクトのツール