SQL projeleri özellikleri

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

SQL veritabanı projeleri, tek tek .sql dosyaların içeriğine ek olarak projenin davranışını ve veritabanı düzeyi ayarlarını tanımlayan özellikler içerir. Dosya bu .sqlproj özellikleri depolar. Bu özellikleri, .sqlproj dosyasını doğrudan düzenleyerek ayarlayabilirsiniz. Visual Studio ve VS Code gibi bazı SQL projeleri araçları, proje özelliklerinin birkaçını veya birçoğunun grafik kullanıcı arabiriminde düzenlenmesine erişim sağlar. Bu makalede, SQL veritabanı projeleri için ayarlayabileceğiniz özelliklere genel bir bakış sağlanır.

Yaygın olarak kullanılan SQL projeleri özellikleri şunlardır:

• Hedef platform (DSP)
• Kod analizi
• DacApplicationName ve DacVersion
• Varsayılan şema
• TreatTSqlWarningsAsErrors
• SDK güncelleştirme uyarıları

Veritabanı seçenekleri değişikliklerini devre dışı bırakma

SQL proje yayımlaması sırasında işlem betikleri, proje özelliklerinde tanımlanan değerlere ve varsayılan proje değerlerine göre veritabanı seçeneklerine dönüşür. Veritabanı seçeneklerinin yayımlama sırasında değiştirilmesini önlemek içinScriptDatabaseOptions veya Visual Studio gibi bir araç kullanarak publish özelliğini false olarak ayarlayın. Bu ayarı bir yayımlama profiline de ekleyebilirsiniz.

Ortak proje özellikleri

Hedef platform özelliği, projenin hedeflediğini SQL Server sürümünü belirtir. DSP SQL projesi için hedef platformu ayarlamak için özelliğini kullanın. Daha fazla bilgi için hedef platform makalesine bakın.

Kod analizi, geliştirme yaşam döngüsünün başlarında olası sorunları yakalayarak sürekli tümleştirme ve dağıtım sürecini önemli ölçüde geliştirebilir. Kod analizini etkinleştirme ve özel kurallar dahil etme hakkında daha fazla bilgi için bkz. Kod kalitesini geliştirmek için SQL kod analizi.

Veri katmanı uygulama özellikleri

SQL projesini oluştururken oluşturduğunuz veri katmanı uygulamasını (DAC) tanımlamak için aşağıdaki özellikleri kullanın.

• DacApplicationName: Veri katmanı uygulamasının .dacpacadı. Varsayılan değer proje adıdır.
• DacDescription: Veri katmanı uygulamasının .dacpacisteğe bağlı bir açıklaması.
• DacVersion: Veri katmanı uygulamasının .dacpacsürümü. Varsayılan değer şudur: 1.0.0.0.

Varsayılan şema

özelliği SQL DefaultSchema projesi için varsayılan şemayı ayarlar. Bu özellik tek parçalı adlandırılmış nesneler için geçerlidir. Varsayılan değer şudur: dbo.

T-SQL uyarıları

SuppressTSqlWarnings ve TreatTSqlWarningsAsErrors özellikleri, proje derlemesi sırasında T-SQL uyarılarının nasıl işleneceğini denetler. SuppressTSqlWarnings özelliği, proje derlemesi sırasında virgülle ayrılmış hata numaraları listesi olarak belirtilen T-SQL uyarılarını gizler.

TreatTSqlWarningsAsErrors özelliği T-SQL uyarılarını hata olarak ele alır ve T-SQL uyarılarının derlemede başarısız olmasına neden olur. TreatTSqlWarningsAsErrors için varsayılan değer Falsedeğeridir.

SDK güncelleştirme uyarıları

Microsoft. Build.Sql proje SDK'sı proje derlemesi sırasında SDK'nın yeni sürümlerini otomatik olarak denetler ve daha yeni bir sürüm varsa bir uyarı görüntüler. En son SDK ile projelerin güncel tutulması, hata düzeltmeleri ve söz dizimi eklemeleri de dahil olmak üzere en yeni özelliklere ve iyileştirmelere erişmenizi sağlar. Bu davranışı devre dışı bırakmak için özelliğini olarak SkipCheckForNewSDKVersionayarlayıntrue.

Proje özelliklerinin örnek kullanımı

Aşağıdaki örnek, bir SQL proje dosyasında CompatibilityMode, IsChangeTrackingOn ve TreatTSqlWarningsAsErrors özelliklerinin nasıl ayarlanacağını göstermektedir. CompatibilityMode özelliği 130 olarak ayarlanır, IsChangeTrackingOn özelliği True olarak ayarlanır ve TreatTSqlWarningsAsErrors özelliği True olarak ayarlanır. TreatSqlWarningsAsErrors özelliği yalnızca True derleme yapılandırmasında Release olarak ayarlanır.

<?xml version="1.0" encoding="utf-8"?>
<Project DefaultTargets="Build">
  <Sdk Name="Microsoft.Build.Sql" Version="2.2.0" />
  <PropertyGroup>
    <Name>AdventureWorks</Name>
    <DSP>Microsoft.Data.Tools.Schema.Sql.Sql160DatabaseSchemaProvider</DSP>
    <ModelCollation>1033, CI</ModelCollation>
    <ProjectGuid>{00000000-0000-0000-0000-000000000000}</ProjectGuid>
    <RunSqlCodeAnalysis>true</RunSqlCodeAnalysis>
    <CompatibilityMode>130</CompatibilityMode>
    <IsChangeTrackingOn>True</IsChangeTrackingOn>
  </PropertyGroup>
  <PropertyGroup Condition="'$(Configuration)'=='Release'">
    <TreatTSqlWarningsAsErrors>True</TreatTSqlWarningsAsErrors>
  </PropertyGroup>
</Project>

Tüm proje özellikleri

Bazı proje özellikleri yalnızca SQL Server veritabanlarına veya SQL Server'ın belirli sürümlerine uygulanan veritabanı seçenekleriyle ilişkilendirilir. Projenize bir proje özelliği eklemeden önce, özellik ve veritabanı gereksinimlerinin davranışını anlamak için veritabanı seçeneğine ilişkin ilişkili belgeleri gözden geçirin.

1. Varsayılan değer, altyapı sürümü ve sunucu ayarlarına göre farklılık gösterir.
2. Veritabanı kapsamlı yapılandırma seçenekleri.
3. AUTO 0 değeriyle ayarlanır.
4. Yalnızca bir CREATE DATABASEseçenek olarak uygulanır.
5. Seçeneğin her zaman etkin olduğu Azure SQL Veritabanı için geçerli değildir.

İlgili içerik

• Hedef platforma genel bakış
• Kod kalitesini geliştirmek için SQL kod analizini
• SQL projeleri araçları
• ALTER DATABASE SET options (Transact-SQL)