Aracılığıyla paylaş

Microsoft Fabric'da SQL veritabanı kaynak denetimi tümleştirmesi

Şunun için geçerlidir:✅SQL veritabanı Microsoft Fabric'da

Bu öğreticide, Doku git tümleştirme kaynağı denetimiyle Doku'daki SQL veritabanınızla çalışmayı öğreneceksiniz.

Microsoft Fabric'daki bir SQL veritabanında kaynak denetimi tümleştirmesi veya "git tümleştirmesi" bulunur ve BU da SQL kullanıcılarının zaman içinde veritabanı nesnelerinin tanımlarını izlemesine olanak sağlar. Bu tümleştirme, bir ekibin şunları yapmasını sağlar:

  • Veritabanını kaynak denetimine işleyin; bu da canlı veritabanını otomatik olarak yapılandırılan kaynak denetimi deposundaki koda dönüştürür (örneğin, Azure DevOps).
  • Kaynak denetim deposunun içeriğinden veritabanı nesnelerini güncelleyin. Kodun kaynak denetim deposunda doğrulanmasından sonra veritabanına farklı bir değişiklik uygulayın.

Canlı veritabanı ve kaynak denetimi arasındaki basit işleme ve güncelleştirme döngüsünün diyagramı.

Git'i bilmiyorsanız önerilen birkaç kaynak şunlardır:

Bu makalede, dokudaki SQL veritabanıyla geliştirme sürecinizi yönetmek için tek tek veya birlikte kullanılabilecek bir dizi yararlı senaryo sunulur:

Bu makaledeki senaryolar, Kullanıma Sunulan Veriler bölümünde ele alınmıştır. Fabric'deki kaynak kontrol entegrasyonuna genel bir bakış için videoyu izleyin.

Önkoşullar

  • Mevcut bir Fabric kapasitesine ihtiyacınız vardır. Şayet yapmazsanız, bir Fabric deneme sürümü başlatın.
  • Git tümleştirme kiracı ayarlarını etkinleştirdiğinizden emin olun.
  • Yeni bir çalışma alanı oluşturun veya var olan bir Fabric çalışma alanını kullanın.
  • Fabric üzerinde mevcut bir SQL veritabanı oluşturun veya kullanın. Henüz bir veritabanınız yoksa, Doku'da yeni bir SQL veritabanı oluşturun.
  • İsteğe bağlı: VS Code için Visual Studio Code, MSSQL uzantısını ve SQL projelerini uzantısını yükleyin.

Ayarlama

Bu depo bağlantısı, depodaki tek bir dalın söz konusu çalışma alanıyla ilişkili olması için çalışma alanı düzeyinde geçerlidir. Depoda birden çok dal olabilir, ancak yalnızca çalışma alanı ayarlarında seçilen daldaki kod çalışma alanını doğrudan etkiler.

Çalışma alanınızı bir kaynak denetimi deposuna bağlama adımları için bkz . Git tümleştirmesini kullanmaya başlama. Çalışma alanınız bir Azure DevOps veya GitHub uzak depoya bağlanabilir.

Fabric SQL veritabanını kaynak denetimine ekleme

Bu senaryoda, veritabanı nesnelerini kaynak denetimine işleyeceksiniz. Nesneleri doğrudan bir test veritabanında oluşturduğunuz ve bu veritabanını uygulama kodunuz gibi kaynak denetiminde takip ettiğiniz bir uygulama geliştiriyor olabilirsiniz. Sonuç olarak, veritabanı nesnelerinizin tanımlarının geçmişine erişebilirsiniz ve geliştirme sürecinizi daha da özelleştirmek için dallanma ve birleştirme gibi Git kavramlarını kullanabilirsiniz.

  1. SQL veritabanınıza Yapı SQL düzenleyicisinde, SQL Server Management Studio, Visual Studio Code için MSSQL uzantısında veya diğer dış araçlarda bağlanın.
  2. Veritabanında yeni bir tablo, saklı yordam veya başka bir nesne oluşturun.
  3. Veritabanının ... menüsünü seçin, Git eşitleme durumunu yenile'yi seçin.
  4. Kaynak denetim masasını açmak için Kaynak denetimi düğmesini seçin.
  5. İstenen veritabanının yanındaki onay kutusunu seçin. Onayla seçin. Doku hizmeti veritabanından nesne tanımlarını okur ve bunları uzak depoya yazar.
  6. Artık kod deposu kaynak görünümünde veritabanı nesnelerinin geçmişini görüntüleyebilirsiniz.

Var olan nesneleri düzenlemek de dahil olmak üzere veritabanını düzenlemeye devam ettikçe, önceki adımları izleyerek bu değişiklikleri kaynak denetimine işleyebilirsiniz.

Fabric SQL veritabanını kaynak denetiminden güncelleştirin

Bu senaryoda, VS Code'daki SQL projeleri uzantısında kod olarak veritabanı nesneleri oluşturacak ve ardından dosyaları kaynak denetimine işleyeceksiniz. Sonrasında, kaynak denetim entegrasyonunu kullanarak Fabric SQL veritabanını güncelleyeceksiniz. Bu senaryo, VS Code'da çalışmayı tercih eden, SQL projelerini kullanan mevcut uygulamalara sahip olan veya daha gelişmiş CI/CD işlem hattı gereksinimlerine sahip olan geliştiricilere yöneliktir.

  1. VS Code'un en son sürümünü ve VS Code için mssql ve SQL projeleri uzantılarını yüklediğinizden emin olun.
    • VS Code'un tümleşik git kaynak denetimini kullanacaksınız.
  2. Çalışma alanınızda yeni bir SQL veritabanı oluşturun ve herhangi bir nesne eklemeden kaynak denetimine işleyin. Bu adım boş SQL projesini ve SQL veritabanı öğesi meta verilerini depoya ekler.
  3. Kaynak denetim deposunu yerel makinenize kopyalayın.
    • Azure DevOps kullanıyorsanız kaynak denetim projesi için ... bağlam menüsünü seçin. Azure DevOps deponuzu yerel makinenize kopyalamak için Clone öğesini seçin. Azure DevOps'e yeniyseniz, Azure DevOps için "git ile kodlama" kılavuzuna bakın.
    • GitHub kullanıyorsanız, depodaki Code düğmesini seçin ve depoyu yerel makinenize kopyalamak için URL'yi kopyalayın. GitHub'a yeniyseniz bir depoyu klonlama kılavuzuna bakın.
  4. Kopyalanan klasörü Visual Studio Code açın. Çalışma alanınızla ilişkilendirilmiş dal varsayılan olmayabilir. Dalını değiştirdikten sonra VS Code'da adlı <yourdatabase>.SQLDatabase bir klasör görmeniz gerekir.
  5. Veritabanınızın klasör yapısı içinde veritabanında oluşturmak istediğiniz en az bir tablo için bir .sql dosya oluşturun. Dosya, tablonun CREATE TABLE ifadesini içermelidir. Örneğin, klasöründe aşağıdaki içeriğe MyTable.sql sahip adlı dbo/Tables bir dosya oluşturun:
    CREATE TABLE dbo.MyTable
(
    Id INT PRIMARY KEY,
    ExampleColumn NVARCHAR(50)
);
  6. Söz diziminin geçerli olduğundan emin olmak için VERITABANı modelini SQL projesiyle doğrulayabiliriz. Dosyaları ekledikten sonra VS Code'daki Veritabanı Projeleri görünümünü kullanarak projeyi oluşturun .
  7. Başarılı bir derlemeden sonra, VS Code'da veya tercih ettiğiniz yerel git arabiriminde kaynak denetim görünümüyle dosyaları kaynak denetimine işleyin .
  8. Commit'inizi uzak depoya gönderin/senkronize edin. Yeni dosyalarınızın Azure DevOps veya GitHub göründüğünü denetleyin.
  9. Fabric web arabirimine dönün ve çalışma alanında Kaynak denetimi panelini açın. "Git'ten bekleyen değişiklikleriniz var" uyarınız zaten olabilir. SQL projenizdeki kodu veritabanına uygulamak için Güncelleştir (Tümünü Güncelleştir) düğmesini seçin.
    • Veritabanını güncellemeden hemen sonra "İşlem Yapılmamış" olduğunu belirttiğini görebilirsiniz. Bunun nedeni Git Tümleştirme özelliğinin bir öğe tanımı için oluşturulan tüm dosya içeriğini doğrudan karşılaştırması ve bazı istenmeyen farklılıklar olmasıdır. Sütunlardaki satır içi öznitelikler buna bir örnektir. Bu durumlarda, tanımı bir işleme işleminin parçası olarak oluşturulan tanımla eşitlemek için Fabric web arabirimindeki kaynak denetime geri eklemeniz gerekir.
  10. Güncelleştirme tamamlandıktan sonra, veritabanına bağlanmak için seçtiğiniz bir aracı kullanın. SQL projesine eklediğiniz nesneler veritabanında görünür.

Not

Yerel SQL projesinde değişiklik yaparken, Doku'da bir söz dizimi hatası veya desteklenmeyen özellikler kullanılıyorsa veritabanı güncelleştirmesi başarısız olur. Devam etmeden önce kaynak denetimindeki değişikliği el ile geri döndürmeniz gerekir.

Kaynak denetiminden bir SQL veritabanını Fabric üzerinde güncellemek, bir SQL proje derlemesi ve SqlPackage yayımlama işlemlerini birleştirir. SQL projesi derlemesi, SQL dosyalarının söz dizimini doğrular ve bir .dacpac dosyası oluşturur. SqlPackage yayımlama işlemi, veritabanını .dacpac dosyasıyla eşleşecek şekilde güncelleştirmek için gereken değişiklikleri belirledi. Doku arabiriminin kolaylaştırılmış yapısı nedeniyle, SqlPackage yayımlama işlemine aşağıdaki seçenekler uygulanır:

  • /p:ScriptDatabaseOptions = false
  • /p:DoNotAlterReplicatedObjects = false
  • /p:IncludeTransactionalScripts = true
  • /p:GenerateSmartDefaults = true

Kaynak denetimli SQL projesi, VS Code, Visual Studio veya diğer SQL proje araçlarında düzenlemek üzere yerel makinenize de kopyalanabilir. SQL projesi, değişiklikleri kaynak denetimine işlemeden önce doğrulamak için yerel olarak derlenmelidir.

Dal çalışma alanı oluştur

Bu senaryoda, Doku'nun kaynak denetimi tanımına göre yinelenen bir kaynak kümesi oluşturmasını sağlayarak Doku'da yeni bir geliştirme ortamı ayarlayacaksınız. Yinelenen veritabanı, kaynak denetimine iade ettiğimiz veritabanı nesnelerini içerir. Bu senaryo, Doku'da uygulama geliştirme yaşam döngüsünü sürdüren ve Doku'dan kaynak denetimi tümleştirmesini kullanan geliştiricilere yöneliktir.

  1. Senaryoyu tamamlayın: Fabric SQL veritabanını kaynak denetimindeki koda dönüştürün.
    • Kaynak denetim deposunda hem SQL projesi hem de Doku nesnesi meta verilerini içeren bir dalınız olmalıdır.
  2. Fabric çalışma alanında kaynak denetim panelini açın. Kaynak denetim menüsünün Dallar sekmesindenyeni bir çalışma alanına dallanma seçeneğini seçin.
  3. Oluşturulacak dalın ve çalışma alanının adlarını belirtin. Dal, kaynak denetim deposunda oluşturulur ve dalladığınız çalışma alanıyla ilişkili dalın kaydedilmiş içeriğiyle doldurulur. Çalışma alanı Fabric içinde oluşturulacak.
  4. Yeni oluşturulan çalışma alanına Fabric'te gidin. Veritabanı oluşturma işlemi tamamlandığında, yeni oluşturulan veritabanı artık kod deponuzda belirtilen nesneleri içerir. Doku sorgu düzenleyicisini açar ve Nesne gezgininde gezinirseniz veritabanınızda yeni (boş) tablolar ve başka nesneler vardır.

Değişiklikleri bir daldan diğerine birleştirme

Bu senaryoda, kaynak denetim deposunu kullanarak veritabanı değişikliklerini dağıtıma sunulmadan önce gözden geçireceksiniz. Bu senaryo, ekip ortamında çalışan ve veritabanı değişikliklerini yönetmek için kaynak denetimi kullanan geliştiricilere yöneliktir.

Önceki senaryoda açıklandığı gibi, aynı depoda ilişkili dallarla iki çalışma alanı oluşturun.

  1. veritabanı ikincil dalda olduğu için veritabanı nesnelerinde değişiklik yapın.
    • Örneğin, mevcut bir saklı yordamı değiştirin veya yeni bir tablo oluşturun.
  2. Doku'daki kaynak denetim masasındaki yürüt düğmesiyle kaynak denetiminde yapılan bu değişiklikleri denetleyin.
  3. Azure DevOps veya GitHub'ta, ikincil daldan birincil dala bir pull isteği oluşturun.
    • Çekme isteğinde, veritabanı kodunda birincil çalışma alanı ile ikincil çalışma alanı arasındaki değişiklikleri görebilirsiniz.
  4. Çekme isteğini tamamladıktan sonra kaynak denetimi güncelleştirilir, ancak birincil çalışma alanındaki Fabric veritabanı değiştirilmez. Birincil veritabanını değiştirmek için, Doku'daki kaynak denetim masasındaki Güncelleştir düğmesini kullanarak kaynak denetiminden birincil çalışma alanını güncelleştirin.

İlgili içerik

  • Last updated on