Kaynak denetimi (önizleme)

Şunun için geçerlidir:✅ Microsoft Fabric'teki Ambar

Bu makalede Git tümleştirme ve dağıtım işlem hatlarının Microsoft Fabric'daki ambarlar için nasıl çalıştığı açıklanmaktadır. Deponuza bağlantı ayarlamayı, ambarlarınızı yönetmeyi ve bunları farklı ortamlara dağıtmayı öğrenin. Fabric 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'deki Git tümleştirmesi, geliştiricilerin geliştirme süreçlerini, araçlarını ve en iyi uygulamalarını doğrudan Fabric platformuyla tümleştirmesine olanak tanır. Fabric geliştiren geliştiricilerin şunları yapmasına olanak tanır:

Çalışmalarını yedekleyip sürümlendirme
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
Fabric öğ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 için 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 ilerideki operasyonları 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.

Dağıtım süreçleri

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 Dağıtım işlem hatlarını kullanmaya başlama bölümüne bakın.
Ç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ında ambarlar dahil olmak üzere öğeleri seçin, görüntüleyin ve karşılaştırın. Geliştirme, Test ve Üretim aşamalarının Fabric portalından ekran görüntüsü.
Dağıtım'ı seçerek ambarlarınızı Geliştirme, Test ve Üretim aşamalarına dağıtın.

Fabric dağıtım işlem hatları süreci hakkında daha fazla bilgi için bkz. Dağıtım işlem hatlarına giriş.

Kaynak denetimindeki sınırlamalar

Betik tabanlı bir yaklaşım kullanarak SQL güvenlik özelliklerini dışarı aktarmanız veya geçirmeniz gerekir. SQL veritabanı projesinde dağıtım sonrası çalıştırılacak betiği kullanmayı göz önünde bulundurun. Projeyi SQL Veritabanı Projeleri uzantısıyla açarak Visual Studio Code içinde kullanılabilir şekilde yapılandırabilirsiniz.

Git tümleştirmesindeki sınırlamalar

Şu anda ALTER TABLE kullanarak veritabanı projesine bir kısıtlama veya sütun eklediğinizde, dağıtım işlemi tabloyu bırakarak yeniden oluşturur, bu da veri kaybına yol açar. Tablo tanımını ve verilerini korumak için aşağıdaki geçici çözümü göz önünde bulundurun:
- CREATE TABLE, INSERT, CREATE TABLE AS SELECT, veya Tabloyu kopyala seçeneğini kullanarak ambarda tablonun yeni bir kopyasını oluşturun.
- kullanarak ALTER TABLEyeni tablo tanımını istediğiniz gibi 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 SQL veritabanı projesi ile canlı ambarın projesi artık eşleşiyor olmalıdır.
Şu anda ambar için çıkış hedefi belirlenmiş bir Dataflow Gen2 oluşturmayın. Adlı DataflowsStagingWarehouse yeni bir öğe depoda görünür ve Git'ten işlemeyi ve güncelleştirmeyi engeller.
Fabric Git tümleştirmesi SQL analytics uç noktası öğesini desteklemez.
SQL analiz uç noktası ile ambar arasındaki öğe bağımlılıkları, öğe sıralaması ve eşitleme boşlukları, geliştirme ve sürekli tümleştirme sırasında "yeni veya mevcut bir çalışma alanına dallanma" ve "farklı bir dala geçiş" iş akışlarını etkiler.

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

Şu anda ALTER TABLE kullanarak veritabanı projesine bir kısıtlama veya sütun eklediğinizde, dağıtım işlemi tabloyu bırakarak yeniden oluşturur, bu da veri kaybına yol açar.
Şu anda ambar için çıkış hedefi belirlenmiş bir Dataflow Gen2 oluşturmayın. adlı DataflowsStagingWarehouse yeni bir öğe dağıtım işlem hattında görünür ve dağıtımı engeller.
Fabric Dağıtım işlem hatları SQL analiz uç noktası öğesini desteklemez.
Öğeler arası bağımlılıklar, öğe sıralaması ve SQL analizi uç noktası ile ambar arasındaki eşzamanlama boşlukları, Fabric Dağıtım İşlem Hatları iş akışlarını etkiler.

Desteklenmeyen senaryolar

Aşağıdaki CI/CD iş akışları, farklı çalışma alanlarındaki depolarda farklı sıralama kuralları kullanıldığında resmi olarak desteklenmez. Bu işlemler hata olmadan başarılı olsa da meta veri hatalarına neden olabilir.

Bu senaryoların tamamında harmanlama uyuşmazlığı oluşursa, veri kümesi (TMSL) harmanlamasını ambar harmanlaması ile eşleşecek şekilde güncelleştirmek için Fabric araç kutusundaki Python betiğini scripts/dw-collation-error-update-tmsl/pbi_interactive.py kullanın GitHub deposunu kullanın.

Scenario	Açıklama	Risk
Dağıtım boru hatları	Hedef ambarın kaynaktan farklı bir harmanlamayla oluşturulduğu işlem hattı aşamaları (örneğin, Geliştirme → Test → Prod) aracılığıyla ambar içeriğini yükseltme desteklenmez.	Dağıtım başarılı olabilir, ancak veri kümesi harmanlaması hedef ambar harmanlaması ile eşleşecek şekilde güncelleştirilmez.
Yeni veya mevcut bir çalışma alanına uzantı oluşturma	Mevcut bir çalışma alanından, ambarın farklı sıralama özelliğine sahip olduğu yeni veya mevcut bir çalışma alanına dal oluşturmak için Git entegrasyonu kullanılması desteklenmez.	Ambar içeriği eşitleniyor, ancak düzenleme meta verileri uzlaştırılmadı.
Çalışma alanında dalları değiştirme	Git bağlantılı çalışma alanında farklı bir harmanlama ambarıyla ilişkilendirilmiş bir dala geçiş desteklenmez.	Senkronize edilen içerik, geçerli ambarla eşleşmeyen harmanlama varsayımlarını taşıyabilir.
Çalışma alanları arasındaki değişiklikleri dallar aracılığıyla birleştirme	Git dallarının, ambarların farklı harmanlamalara sahip olduğu çalışma alanları arasında birleştirilmesi desteklenmez.	Birleştirme Git düzeyinde başarılı olabilir, ancak sonuçta elde edilen veri kümesi harmanlaması hedef ambarın harmanlamasını yansıtmaz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-04-17