Ambar ile kaynak denetimi (önizleme)

Makale
11/24/2024

Bu makalede, Microsoft Fabric'teki ambarlar için Git tümleştirme ve dağıtım işlem hatlarının nasıl çalıştığı açıklanmaktadır. Deponuza bağlantı ayarlamayı, ambarlarınızı yönetmeyi ve bunları farklı ortamlara dağıtmayı öğrenin. Doku Ambarı için kaynak denetimi şu anda bir önizleme özelliğidir.

Farklı senaryolar için hem Git tümleştirmesi hem de Dağıtım işlem hatlarını kullanabilirsiniz:

Git ve SQL veritabanı projelerini kullanarak tek tek veritabanı nesnelerinde artımlı değişikliği, ekip işbirliğini ve işleme geçmişini yönetin.
Kod değişikliklerini farklı üretim öncesi ve üretim ortamlarına yükseltmek için dağıtım işlem hatlarını kullanın.

Git ile tümleştirme

Microsoft Fabric'teki Git tümleştirmesi, geliştiricilerin geliştirme süreçlerini, araçlarını ve en iyi uygulamalarını doğrudan Doku platformuyla tümleştirmesine olanak tanır. Fabric'te geliştirme yapan geliştiricilerin şunları yapmasına olanak tanır:

Çalışmalarını yedekleme ve sürüm oluşturma
Gerektiğinde önceki aşamalara geri dön
Git dallarını kullanarak başkalarıyla işbirliği yapma veya tek başına çalışma
Doku öğelerini yönetmek için tanıdık kaynak denetim araçlarının özelliklerini uygulama

Git tümleştirme işlemi hakkında daha fazla bilgi için bkz:

Kaynak denetimine bağlantı ayarlama

Çalışma alanı ayarları sayfasında, değişiklikleri işlemek ve eşitlemek için deponuza kolayca bağlantı kurabilirsiniz.

Bağlantıyı ayarlamak için bkz . Git tümleştirmesini kullanmaya başlama. Git sağlayıcısı olarak Azure DevOps veya GitHub'a Git deposuna bağlanma yönergelerini izleyin.
Bağlandıktan sonra, ambarlar da dahil olmak üzere öğeleriniz Kaynak denetim masasında görünür.
Ambar örneklerini Git deposuna başarıyla bağladıktan sonra depoda ambar klasör yapısını görürsünüz. Artık çekme isteği oluşturma gibi gelecekteki işlemleri yürütebilirsiniz.

Git'te bir ambar için veritabanı projeleri

Aşağıdaki görüntü, depodaki her ambar öğesinin dosya yapısının bir örneğidir:

Ambar öğesini Git deposuna kaydettiğinizde, ambar sql veritabanı projesi olarak bir kaynak kod biçimine dönüştürülür. SQL projesi, tablolar, saklı yordamlar veya işlevler gibi tek bir veritabanının şemasını oluşturan SQL nesnelerinin yerel bir gösterimidir. Veritabanı nesnelerinin klasör yapısı Şema/Nesne Türüne göre düzenlenir. Ambardaki her nesne, veri tanımı dili (DDL) tanımını içeren bir .sql dosyasıyla temsil edilir. Ambar tablosu verileri ve SQL güvenlik özellikleri SQL veritabanı projesine dahil değildir.

Paylaşılan sorgular da depoya işlenir ve kaydedildikleri adı devralır.

Fabric'te bir ambarın SQL veritabanı projesini indirme

Azure Data Studio ve Visual Studio Code'un içinde bulunan SQL Veritabanı Projeleri uzantısıyla, bir ambar şemasını yönetebilir ve diğer SQL veritabanı projeleri gibi Ambar nesnesi değişikliklerini işleyebilirsiniz.

Ambarınızın şemasının yerel bir kopyasını indirmek için şeritte SQL veritabanı projesini indir'i seçin.

Ambar şemasının tanımını içeren veritabanı projesinin yerel kopyası. Veritabanı projesi aşağıdakileri yapmak için kullanılabilir:

Ambar şemasını başka bir ambarda yeniden oluşturun.
Azure Data Studio veya Visual Studio Code gibi istemci araçlarında ambar şemasını daha da geliştirin.

SQL veritabanı projesini yeni bir ambara yayımlama

Ambar şemasını yeni bir ambarda yayımlamak için:

Doku çalışma alanınızda yeni bir ambar oluşturun.
Yeni ambar başlatma sayfasındaki Ambar oluştur'un altında SQL veritabanı projesi'ni seçin.
Mevcut ambardan indirilen .zip dosyasını seçin.
Ambar şeması yeni ambarda yayımlanır.

Dağıtım işlem hatları

Ayrıca, dağıtım işlem hatlarını kullanarak ambar kodunuzu geliştirme, test ve üretim gibi farklı ortamlara dağıtabilirsiniz. Dağıtım işlem hatları veritabanı projelerini kullanıma sunmaz.

Dağıtım işlem hattını kullanarak ambar dağıtımınızı tamamlamak için aşağıdaki adımları kullanın.

Yeni bir dağıtım işlem hattı oluşturun veya mevcut bir dağıtım işlem hattını açın. Daha fazla bilgi için bkz . Dağıtım işlem hatlarını kullanmaya başlama.
Çalışma alanlarını dağıtım hedeflerinize göre farklı aşamalara atayın.
Aşağıdaki örnekte gösterildiği gibi, farklı aşamalar arasındaki ambarlar dahil olmak üzere öğeleri seçin, görüntüleyin ve karşılaştırın.
Dağıtım'ı seçerek ambarlarınızı Geliştirme, Test ve Üretim aşamalarına dağıtın.

Doku dağıtım işlem hatları işlemi hakkında daha fazla bilgi için bkz . Doku dağıtım işlem hatlarına genel bakış.

Kaynak denetimindeki sınırlamalar

SQL güvenlik özellikleri betik tabanlı bir yaklaşım kullanılarak dışarı aktarılmalı/geçirilmelidir. Bir SQL veritabanı projesinde dağıtım sonrası betiği kullanmayı göz önünde bulundurun. Bu betiği Azure Data Studio'nun içinde bulunan SQL Veritabanı Projeleri uzantısıyla açarak yapılandırabilirsiniz.

Git tümleştirmesindeki sınırlamalar

Şu anda veritabanı projesine kısıtlama veya sütun eklemek için kullanırsanız ALTER TABLE , tablo dağıtılırken bırakılır ve yeniden oluşturulur ve veri kaybına neden olur. Tablo tanımını ve verilerini korumak için aşağıdaki geçici çözümü göz önünde bulundurun:
- ve , veya Clone tablosunu kullanarak CREATE TABLE ambarda tablonun yeni bir kopyasını CREATE TABLE AS SELECToluşturun.INSERT
- kullanarak yeni tablo tanımını istediğiniz ALTER TABLEgibi yeni kısıtlamalar veya sütunlarla değiştirin.
- Eski tabloyu silin.
- sp_rename kullanarak yeni tabloyu eski tablonun adıyla yeniden adlandırın.
- SQL veritabanı projesindeki eski tablonun tanımını tam olarak aynı şekilde değiştirin. Kaynak denetimindeki ve canlı ambardaki ambarın SQL veritabanı projesi artık eşleşmelidir.
Şu anda, ambara çıkış hedefi olan bir Veri Akışı 2. Nesil oluşturmayın. Git'ten işleme ve güncelleştirme işlemi, depoda görünen adlı DataflowsStagingWarehouse yeni bir öğe tarafından engellenir.
SQL analiz uç noktası Git tümleştirmesi ile desteklenmez.

Dağıtım işlem hatları için sınırlamalar

Şu anda veritabanı projesine kısıtlama veya sütun eklemek için kullanırsanız ALTER TABLE , tablo dağıtılırken bırakılır ve yeniden oluşturulur ve veri kaybına neden olur.
Şu anda, ambara çıkış hedefi olan bir Veri Akışı 2. Nesil oluşturmayın. Dağıtım, dağıtım işlem hattında görünen adlı DataflowsStagingWarehouse yeni bir öğe tarafından engellenir.
SQL analiz uç noktası dağıtım işlem hatlarında desteklenmez.

Aracılığıyla paylaş

Ambar ile kaynak denetimi (önizleme)