Aracılığıyla paylaş

SQL projeleri sistem nesneleri

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

SQL projeleri, proje derleme işlemi sırasında veritabanı nesnesi başvurularını doğrular. Varsayılan olarak, SQL projeleri veritabanı modeline sistem nesneleri içermez ve bu da projeniz sistem nesnelerine başvurular içeriyorsa doğrulama hatalarına yol açabilir. Bu doğrulama hatalarını çözmek için projenizin hedef platformuna master.dacpac bir veritabanı başvurusu eklersiniz.

master.dacpac Veritabanı başvurusu, Microsoft.Build.Sql SDK stili SQL projelerinde paket başvurusu olarak veya hem SDK stilinde hem de özgün SQL projelerinde yapıt başvurusu olarak eklenebilir.

Paket referansı ekle

Kullanılabilir sistem veritabanı paketleri şunlardır:

SQL projesine paket başvurusu eklemenin en doğrudan yöntemi .NET komut satırı arabirimini (CLI) kullanmaktır. Aşağıdaki örnek, Azure SQL Veritabanı master sistem veritabanına bir SQL projesine paket başvurusu ekler:

dotnet add <path-to-sqlproj> package Microsoft.SqlServer.Dacpacs.Azure.Master

Bu komut dosyaya aşağıdaki girdiyi .sqlproj ekler (paket sürümü, komut çalıştırıldığında kullanılabilen en son sürümü yansıtır):

...
    <ItemGroup>
        <PackageReference Include="Microsoft.SqlServer.Dacpacs.Azure.Master" Version="170.0.1" />
    </ItemGroup>
</Project>

Artifakt referansı ekle

VS Code ve Visual Studio SQL proje arabirimleri, projenizin hedef platformu için master.dacpac dosyasına bir yapıt referansı eklemek amacıyla bir yöntem sunar.

Dosyada .sqlproj yapılan düzenlemeler, Visual Studio'daki Azure SQL Veritabanı master sistem veritabanına yapıt başvurusu ekleyen aşağıdaki örneğe benzer olacaktır:

<ItemGroup>
    <ArtifactReference Include="$(DacPacRootPath)\Extensions\Microsoft\SQLDB\Extensions\SqlServer\AzureV12\SqlSchemas\master.dacpac">
      <HintPath>$(DacPacRootPath)\Extensions\Microsoft\SQLDB\Extensions\SqlServer\AzureV12\SqlSchemas\master.dacpac</HintPath>
      <SuppressMissingDependenciesErrors>False</SuppressMissingDependenciesErrors>
      <DatabaseVariableLiteralValue>master</DatabaseVariableLiteralValue>
    </ArtifactReference>
  </ItemGroup>

Uygulamaların yükleme konumundaki master.dacpac dosyalarına, bazı CI/CD sistemleri için kırılgan olabilecek şekilde başvurulmaktadır. Derleme sisteminiz sistem veritabanı dosyalarını içermiyorsa, master.dacpac dosyasını çözümünüzdeki bir konuma kopyalayabilir ve Include ile HintPath özniteliklerini bu konuma işaret edecek şekilde güncelleştirebilirsiniz.

Fabric'de SQL veritabanı

Doku sistem nesnelerindeki SQL veritabanı pakete Microsoft.SqlServer.Dacpacs.DbFabric dahil edilir, ancak Doku ortamındaki SQL veritabanı için veritabanı başvurusunu doğru yapılandırmak için ek adımlar gerekebilir.

Fabric'deki tümleşik kaynak denetimi ile oluşturulan SQL projesi, paket başvurusunu ve DatabaseVariableLiteralValue olarak ayarlanan master özelliğini içerir. Fabric'deki SQL veritabanı master veritabanına erişim sağlamadığından, ancak kullanıcı veritabanında aynı sistem nesnelerine başvurulabildiği için bu özellik gerekmektedir.

Visual Studio veya VS Code'da yeni bir SQL projesi oluşturursanız, DatabaseVariableLiteralValue özelliğini, Fabric ortamındaki SQL veritabanında kullanılan veritabanı adıyla eşleştirecek şekilde master güncelleştirmeniz gerekir.

  <ItemGroup>
    <PackageReference Include="Microsoft.SqlServer.Dacpacs.DbFabric">
      <SuppressMissingDependenciesErrors>False</SuppressMissingDependenciesErrors>
      <DatabaseVariableLiteralValue>master</DatabaseVariableLiteralValue>
      <Version>170.0.0</Version>
    </PackageReference>
  </ItemGroup>

İlgili içerik

  • Last updated on