Aracılığıyla paylaş

Dağıtım öncesi ve sonrası betiklere genel bakış

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

Dağıtım öncesi ve sonrası betikleri, dağıtım sırasında yürütülecek projeye dahil edilen SQL betikleridir. Dağıtım öncesi/sonrası betikler .dacpac içinde bulunur ancak veritabanı nesne modeline derlenmez veya doğrulanmaz. Dağıtım planı çalıştırılmadan önce bir dağıtım öncesi betik çalıştırılır, ancak betik çalıştırılmadan önce dağıtım planı hesaplanır. Dağıtım planı tamamlandıktan sonra, dağıtım sonrası betiği yürütülür.

SQL proje dosyası örneği ve söz dizimi

SQL proje dosyasında tek bir dağıtım öncesi betiği ve tek bir dağıtım sonrası betiği belirtilebilir.

SQL proje dosyasındaki aşağıdaki örnek, prep-db.sql dosyasını dağıtım öncesi bir betik olarak ekler.

...
  <ItemGroup>
    <PreDeploy Include="prep-db.sql" />
  </ItemGroup>

Bir SQL proje dosyasındaki aşağıdaki örnek, populate-app-settings.sql dosyasını dağıtım sonrası betik olarak ekler.

...
  <ItemGroup>
    <PostDeploy Include="populate-app-settings.sql" />
  </ItemGroup>
</Project>

Birden çok dosya, her dosyayı sırayla çağıran bir SQLCMD betiği kullanılarak dağıtım öncesi veya sonrası betiğin parçası olarak yürütülebilir.

:r .\scripts\script1.sql
:r .\scripts\script2.sql

Bu dosyalar, Visual Studio'daki dosya özelliklerinde Build Action özelliği Remove olarak ayarlanarak veya .sqlproj dosyasına Build özniteliği Remove olarak bir giriş eklenerek veritabanı modeli derlemesinden hariç tutulmalıdır. SQL projesi oluşturulduğunda, Microsoft.Build.Sql proje SDK'sı tarafından, ek dosyalar .dacpac içindeki dağıtım öncesi veya dağıtım sonrası betiklerine dahil edilerek birleştirilir.

...
  <ItemGroup>
    <Build Remove="scripts\script1.sql" />
    <Build Remove="scripts\script2.sql" />
  </ItemGroup>
</Project>

Tip

Dosya uzantısını .dacpac'dan .zip'e değiştirerek ve .zip'yi bir klasöre açarak proje derlemesi sonrasında dağıtım öncesi ve dağıtım sonrası betiklerini doğrulayabilirsiniz. Dağıtım öncesi ve dağıtım sonrası betikler için tek .sql bir dosya vardır ve kaynak SQL projesinde başvuruda bulunılan tüm dosyaların tüm Transact-SQL içeriğini içermelidir.

Dağıtım öncesi ve sonrası betikleri ekle

Çözüm Gezgini'nde projeye sağ tıklayın ve Ekle>Betik'i seçin. Dağıtım Öncesi Betiği veya Dağıtım Sonrası Betiği seçin.

Betik dosyası projeye eklenir ve betiği tamamlayabileceğiniz sorgu düzenleyicisinde açılır. Bu betik, proje her dağıtıldığında, dağıtım planı yürütülmeden önce veya sonra çalıştırılır.

Çözüm Gezgini'ndeproje düğümüne sağ tıklayın, Ekle'yiseçin ve ardından Yeni Öğe'yiseçin. Yeni Öğe Ekle iletişim kutusu görüntülenir ve Tüm Şablonları Göster'i seçin. ve ardından Tablo. Dağıtım Öncesi Betiği veya Dağıtım Sonrası Betiği seçin.

Betik dosyası projeye eklenir ve betiği tamamlayabileceğiniz sorgu düzenleyicisinde açılır. Bu betik, proje her dağıtıldığında, dağıtım planı yürütülmeden önce veya sonra çalıştırılır.

VS Code veya Azure Data Studio'nun Veritabanı Projeleri görünümünde projeye sağ tıklayın ve Dağıtım Öncesi Betik Ekle veya DağıtımSonrası Betik Ekle'yi seçin. Dosya uzantısı olmadan bir script adı sağlayın.

Betik dosyası projeye eklenir ve betiği tamamlayabileceğiniz sorgu düzenleyicisinde açılır. Bu betik, proje her dağıtıldığında, dağıtım planı yürütülmeden önce veya sonra çalıştırılır.

.sqlproj dosyasını doğrudan düzenleyerek dağıtım öncesi veya sonrası betikleri ekleyin. <PreDeploy> dosyasının <PostDeploy> bölümüne <ItemGroup> veya .sqlproj öğesi ekleyin.

Örneğin, betiği scripts\before-script.sql projemize dağıtım öncesi betik olarak eklemek için:

...
  <ItemGroup>
    <PreDeploy Include="scripts\before-script.sql" />
  </ItemGroup>

Bu scripts\before-script.sql betik, proje her dağıtıldığında dağıtım planı uygulanmadan önce yürütülür.

İlgili içerik

  • Last updated on