Özgün SQL projesini SDK stili projeye dönüştürme

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen ÖrneğiMicrosoft Fabric'te SQL veritabanı

Yeni BIR SDK stili SQL projesi oluşturmak hızlı bir görevdir. Ancak, mevcut SQL projeleriniz varsa, yeni özelliklerden faydalanmak için onları SDK tarzı SQL projelerine dönüştürebilirsiniz.

Projeyi dönüştürdükten sonra, SDK tarzı projenin yeni özelliklerini kullanabilirsiniz, örneğin:

• Çapraz platform oluşturma desteği
• Basitleştirilmiş proje dosya formatı
• Paket referansları

Dönüşümü dikkatlice tamamlamak için şu adımları izleyin:

1. Özgün proje dosyasının yedeğini oluşturun.
2. Karşılaştırma için özgün projeden bir .dacpac dosya oluşturun.
3. Proje dosyasını SDK stilinde bir proje olarak değiştirin.
4. Karşılaştırma için değiştirilen projeden bir .dacpac dosya oluşturun.
5. .dacpac dosyalarının aynı olduğunu doğrulayın.

Visual Studio'daki SQL Server Veri Araçları (SSDT) SDK tarzı projeleri desteklemiyor. Projeyi dönüştürdükten sonra, aşağıdaki araçlardan birini kullanarak projeyi oluştur veya düzenleyin:

• Visual Studio Code'ta SQL Veritabanı Projeleri uzantısı
• Database DevOps in SQL Server Management Studio (SSMS)
• Komut satırı
• SQL Server Veri Araçları, SDK tarzı (önizleme) Visual Studio 2022'de

Prerequisites

1. Adım: Özgün proje dosyasının yedeğini oluşturma

Projeyi dönüştürmeden önce özgün proje dosyasının yedeğini oluşturun. Bu şekilde, gerekirse özgün projeye geri dönebilirsiniz.

Dosya Gezgini'nde, dönüştürmek istediğiniz projeye ait .sqlproj dosyasının, dosya uzantısının sonuna .original eklenmiş bir kopyasını oluşturun. Örneğin MyProject.sqlproj, MyProject.sqlproj.original olur.

2. Adım: Karşılaştırma için özgün projeden dosya .dacpac oluşturma

dotnet build

# optionally specify the project file
dotnet build MyDatabaseProject.sqlproj

Derleme işlemi, varsayılan olarak projenin .dacpac klasörüne bir bin\Debug dosyası oluşturur. Dosya Gezgini kullanarak, derleme süreci tarafından oluşturulan dosyayı .dacpac bulup proje dizininin dışındaki yeni bir klasöre kopyalayın.original_project.dacpac Dönüşümünüzü daha sonra doğrulamak için bu .dacpac dosyayı karşılaştırmak için kullanın.

3. Adım: Proje dosyasını SDK stilinde bir proje olarak değiştirme

Proje dosyasını değiştirmek, el ile gerçekleştirilen ve en iyi şekilde metin düzenleyicisinde gerçekleştirilen bir işlemdir. .sqlproj Dosyayı bir metin düzenleyicisinde açın ve aşağıdaki değişiklikleri yapın:

Gerekli: SDK referansını ekleyin

Proje öğesinin içinde, Microsoft.Build.Sql'e ve aşağıdaki kod parçacığında Sdk'nin dahil olduğu en son sürüme başvurmak amacıyla bir https://www.nuget.org/packages/Microsoft.build.sql öğesi ekleyin.

<?xml version="1.0" encoding="utf-8"?>
<Project DefaultTargets="Build" ToolsVersion="4.0">
  <Sdk Name="Microsoft.Build.Sql" Version="#.#.#" />
...

Gerekli: Gereksiz derleme hedefi içeri aktarmalarını kaldırma

SQL projelerinin orijinal sürümleri, İçeri Aktarma deyimlerinde çeşitli derleme hedeflerine ve özelliklerine atıfta bulunur. <Import/> Benzersiz ve kasıtlı bir değişiklik olan açıkça eklediğiniz öğeler dışında, ile <Import ...>başlayan satırları kaldırın. örneğinizde .sqlprojvarsa kaldırılacak örnekler:

...
<Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" />
<Import Condition="..." Project="...\Microsoft.Data.Tools.Schema.SqlTasks.targets"/>
<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" />
...

Gerekli: Özellikler klasörünü kaldırma

Özgün SQL projelerinde, çözüm gezginindeki proje özelliklerine erişimi temsil eden bir Properties klasör için bir giriş vardır. Bu öğeyi proje dosyasından çıkarın.

örneğinizde .sqlprojvarsa kaldırmak için:

<ItemGroup>
  <Folder Include="Properties" />
</ItemGroup>

Gerekli: Varsayılan olarak dahil edilen Derleme öğelerini kaldırın

Özgün SQL projeleri, proje dosyasındaki veritabanı nesnelerini açıkça öğe olarak .sql temsil eden tüm <Build Include="..." /> dosyaları listeler. SDK tarzı SQL projelerinde, .sql proje klasör ağacındaki (**/*.sql) tüm dosyalar varsayılan olarak dahil edilir. Derleme performansı sorunlarını önlemek için, bu dosyalar için <Build Include="...." /> öğelerinde belirtilen .sql dosyalarını kaldırın.

Proje dosyasından aşağıdaki gibi satırları kaldırın:

  <Build Include="SalesLT/Products.sql" />
  <Build Include="SalesLT/SalesLT.sql" />
  <Build Include="SalesLT/Categories.sql" />
  <Build Include="SalesLT/CategoriesProductCount.sql" />

Silmeyin:

• <Build Include="..." />SQL proje klasör ağacında olmayan dosyalar için öğeler .sql
• <PreDeploy Include="..." /> veya <PostDeploy Include="..." /> öğeler, çünkü bu düğümler o dosyalar için belirli davranışları belirler
• .sql Dosya olmayan öğeler, örneğin .publish.xml öğelerdeki <None Include="..." /> dosyalar, .refactorlog.xml öğelerdeki <RefactorLog Include="..." /> dosyalar veya .xsd öğelerdeki <Build Include="..." /> dosyalar

İsteğe bağlı: SSDT başvurularını kaldırma

Özgün SQL Server Veri Araçları (SSDT), Visual Studio yüklemesini algılamak için proje dosyasında ek içerik gerektiriyor. SDK stili SQL projelerinde bu satırlar gereksizdir ve kaldırılabilir:

  <PropertyGroup>
    <VisualStudioVersion Condition="'$(VisualStudioVersion)' == ''">11.0</VisualStudioVersion>
    <!-- Default to the v11.0 targets path if the targets file for the current VS version is not 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>

İsteğe bağlı: Varsayılan derleme ayarlarını kaldırma

Orijinal SQL projeleri, Release ve Debug derleme ayarları için iki büyük blok içerirken, SDK tarzı SQL projelerinde SDK bu seçeneklerin varsayılan ayarlarını bilir. Derleme ayarlarında özelleştirmeleriniz yoksa şu blokları kaldırmayı göz önünde bulundurun:

  <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>

Proje özellikleri başvurusu, kullanılabilir özellikleri ve bunların varsayılanlarını listeler.

4. Adım: Çözüm dosyaları

Proje dosyanıza bir çözüm dosyasında (.sln) başvurulabilir. Bir çözüm dosyanız varsa, onu yeni SDK tarzı proje dosyasına referans olacak şekilde güncelleyin. Çözüm dosyanız yoksa bu bölümü atlayabilir ve 5. Adıma geçebilirsiniz.

1. Seçenek: Yeni çözüm dosyası oluşturma

Çözüm dosyası sadece SQL projesini içeriyorsa, çözüm dosyasını kaldırıp SDK tarzı projeyle yeni bir çözüm dosyası oluşturmak daha kolaydır.

dotnet new sln --name MySolution
dotnet sln MySolution.sln add MyDatabaseProject\MyDatabaseProject.sqlproj

Seçenek 2: Çözüm dosyasını düzenleme

Çözüm dosyası birden fazla proje içeriyorsa, çözüm dosyasını yeni SDK tarzı proje dosyasına referans olacak şekilde güncelleyin. Çözüm dosyasını bir metin düzenleyicisinde düzenleyebilir ve proje başvuruyu yeni SDK stili proje dosyasıyla değiştirebilirsiniz. Çözüm dosyasındaki proje başvurusu şu şekilde görünmelidir:

Project("{PROJECT_TYPE_GUID}") = "MyDatabaseProject", "MyDatabaseProject\MyDatabaseProject.sqlproj", "{PROJECT_GUID}"
EndProject

Bir Microsoft.Build.Sql projesi için PROJECT_TYPE_GUID değeri 42EA0DBD-9CF1-443E-919E-BE9C484E4577’dir. Bu, PROJECT_GUID proje dosyası <ProjectGuid> öğesinde bulunan proje için benzersiz bir tanımlayıcıdır. Projenizde bir çözüm dosyanız varsa, değeri PROJECT_GUID değiştirmenize gerek yok. PROJECT_TYPE_GUID değerini Microsoft.Build.Sql proje türü GUID'si olarak değiştirin.

5. Adım: Karşılaştırma için değiştirilen projeden dosya .dacpac oluşturma

dotnet build

# optionally specify the project file
dotnet build MyDatabaseProject.sqlproj

Derleme işlemi, varsayılan olarak projenin .dacpac klasörüne bir bin\Debug dosyası oluşturur. Dosya Gezgini'ni kullanarak derleme işlemi tarafından oluşturulan .dacpac öğesini bulun ve bunu proje dizininin dışında yeni bir klasöre kopyalayın. Dönüşümünüzü daha sonra doğrulamak için bu .dacpac dosyayı karşılaştırmak için kullanın.

6. Adım: Dosyaların aynı olduğunu .dacpac doğrulayın

Dönüştürmenin başarılı olduğunu doğrulamak için özgün ve değiştirilmiş projelerden oluşturulan dosyaları karşılaştırın .dacpac . SQL projelerinin şema karşılaştırma yeteneklerini kullanarak iki .dacpac dosya arasındaki veritabanı modellerindeki farkı görselleştirin. Alternatif olarak, iki .dacpac dosyayı karşılaştırmak için DacpacVerify komut satırı aracını kullanın; bu iki dosyayı dağıtım öncesi/sonrası betikleri ve proje ayarları dahil olmak üzere karşılaştırabilirsiniz.

DacpacVerify'i dotnet aracı olarak kurabilirsiniz. Aracı yüklemek için aşağıdaki komutu çalıştırın:

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

DacpacVerify söz dizimi, iki .dacpac dosyasının dosya yolunu dacpacverify <source DACPAC path> <target DACPAC path> olarak belirtmektir. İki .dacpac dosyayı karşılaştırmak için aşağıdaki komutu çalıştırın:

DacpacVerify original_project.dacpac modified_project.dacpac

Dosyalardaki .dacpac nesneleri karşılaştırmak için şema karşılaştırma aracını kullanabilirsiniz.

Şema karşılaştırması yaptığınızda hiçbir sonuç gösterilmemeli. Farklılıkların olmaması, özgün ve değiştirilmiş projelerin eşdeğer olduğunu ve dosyada aynı veritabanı modelini ürettiğini .dacpac gösterir.

İlgili içerik

• SQL veritabanı projeleri nedir?
• SQL veritabanı projelerini kullanmaya başlama
• SQL projeleri paket referansları