Fabric veri aracısı için Kaynak Denetimi, CI/CD ve ALM

Bu makalede, Microsoft Fabric Uygulama Yaşam Döngüsü Yönetimi (ALM) özelliklerinin bir parçası olarak Git tümleştirme ve dağıtım işlem hatlarını kullanarak Fabric veri aracılarının nasıl yönetileceğini açıklar. Çalışma alanını Git deposuna bağlamayı öğrenirsiniz. Ayrıca veri aracısı yapılandırmalarını izleme ve sürüm oluşturma hakkında da bilgi edineceksiniz. Son olarak geliştirme, test ve üretim ortamlarında güncelleştirmeleri yükseltmeyi öğreneceksiniz. Git tümleştirme ve dağıtım işlem hatları, veri aracısı değişikliklerinin sürekli tümleştirilmesine ve sürekli dağıtımına (CI/CD) olanak tanıyarak güncelleştirmelerin ALM iş akışınızın bir parçası olarak otomatik olarak test edilmesine ve yükseltilmesine olanak tanır. Fabric veri aracıları için kaynak denetimi şu anda önizleme aşamasındadır.

Fabric veri aracıları için ALM'yi desteklemek için iki tamamlayıcı yaklaşım kullanabilirsiniz:

Git tümleştirmesi: Fabric veri aracıları dahil olmak üzere tek tek öğeler için sürüm denetimi, dallar aracılığıyla işbirliği ve geçmiş izleme özelliklerini etkinleştirmek için çalışma alanının tamamını bir Git deposuyla (git sağlayıcısı olarak Azure DevOps veya GitHub) eşitleyin.
Dağıtım işlem hatları: Yerleşik işlem hatlarını kullanarak geliştirme, test ve üretim aşamalarını temsil eden ayrı çalışma alanları arasında içerik yükseltin.

Bu özellikler birlikte Fabric veri aracıları için uçtan uca ALM desteği sağlar.

Önkoşullar

F2 veya üstü ücretli bir Fabric kapasitesi veya Microsoft Fabric etkin kapasiteye sahip bir Power BI Premium kapasitesi (P1 veya üzeri).
Doku veri aracısı kiracı ayarlarında açıklanan gereksinimlere göre yapay zeka için coğrafi bölgeler arası işlemeyi ve coğrafi bölgeler arası depolamayı etkinleştirin.
Veri içeren bu veri kaynaklarından en az biri: Ambar, göl evi, Power BI anlam modeli, KQL veritabanı, yansıtılmış veritabanı veya ontoloji. Veri kaynağına okuma erişiminiz olmalıdır.

Git tümleştirmesi

Microsoft Fabric Git tümleştirmesi, Fabric çalışma alanını git deposuyla eşitleyerek mevcut geliştirme süreçlerinizi, araçlarınızı ve en iyi yöntemlerinizi doğrudan Fabric platformunda kullanmanıza olanak sağlar. Azure DevOps ve GitHub destekler ve çalışma alanı düzeyinde kullanılabilir. Veri aracısı yapılandırması güncelleştirmeleri de dahil olmak üzere Fabric değişiklikleri işlediğinizde, bu değişiklikler bağlı Git deposuna dosya olarak kaydedilir. Başlıca özellikleri şunlardır:

Çalışma alanı öğelerinin tam yedekleme ve sürüm denetimi
Git'teki klasör yapısı çalışma alanı yapısını yansıtır
Veri aracısı yapılandırmaları (şema seçimi, yapay zeka yönergeleri, veri kaynağı yönergeleri, örnek sorgular) ayrılmış klasörlerdeki yapılandırılmış dosyalarda depolanır
Veri aracıları da dahil olmak üzere farklı çalışma alanı öğeleri için geçmiş aracılığıyla farkları görüntüleme, geçmişi gözden geçirme ve önceki durumlara geri dönme olanağı
Dal tabanlı işbirliği (özellik dalları, ana dal)

En son Git tümleştirme geliştirmeleri

Fabric Git tümleştirmesi artık seçmeli dallanmayı destekleyerek çalışma alanı düzeyindeki bağlı dalı özellik dalı iş akışlarıyla uyumlu olacak şekilde değiştirmenizi sağlar. Kaynak denetimi bölmesi, öğe değişiklikleri için yerleşik bir fark deneyimi de sağlar, böylece güncelleştirmeleri işlemeden veya çekmeden önce tam olarak nelerin değiştiğini gözden geçirebilirsiniz. Dallandırılmış çalışma alanları, Fabric kullanıcı arabiriminde daha net bir şekilde gösterilir ve bu da her çalışma alanının hangi dala bağlı olduğunu belirlemeyi kolaylaştırır.

Git tümleştirme işlemi hakkında daha fazla bilgi için aşağıdaki kaynaklara başvurabilirsiniz.

Kaynak denetimine bağlantı ayarlama

Fabric çalışma alanınızı Workspace settings sayfasından bir Git deposuna bağlayabilirsiniz. Bu bağlantı, değişiklikleri doğrudan Fabric üzerinden commit etmenize ve eşitlemenize olanak tanır.

Azure DevOps veya GitHub git deposuna bağlanmaya yönelik ayrıntılı adımlar için bkz. Git tümleştirmesi ile çalışmaya başlama.
Git deposuna bağlandıktan sonra, Fabric veri aracıları dahil olmak üzere çalışma alanı öğeleriniz Kaynak denetim masasında görünür. Sol alttaki durum çubuğunda, bağlı dalın adını, son eşitleme zamanını ve Git işleme kimliğini görebilirsiniz.

Bağlı Git deposu, Fabric veri aracıları ve yapılandırma dosyaları dahil olmak üzere çalışma alanı öğelerinizi temsil eden bir klasör yapısı görüntüler. Her veri aracısı kendi klasöründe depolanır ve bu sayede değişiklikleri gözden geçirebilir, sürüm geçmişini izleyebilir ve güncelleştirmeleri ana dalınızla birleştirmek için çekme istekleri oluşturma gibi Git iş akışlarını kullanabilirsiniz.

Git bağlantılı bir çalışma alanında Fabric veri aracısında değişiklikler yaptığınızda, değişiklikler algılanır ve Veri aracısının Kaynak denetim bölmesindeki durumu Kaydedilmemiş değişiklikler olarak değişir. Bu değişiklikler şunları içerebilir:
- Şema seçimini değiştirme.
- Yapay zeka yönergelerini veya veri kaynağı yönergelerini güncelleştirme.
- Örnek sorguları düzenleme.
- Veri aracısını yayımlama veya yayımlama açıklamasını güncelleştirme.

İster işlevsel ister açıklayıcı olsun herhangi bir değişiklik, veri aracısının bağlı Git deposuyla eşitlenmemiş olmasına neden olur. Değişiklikleri olan çalışma alanı öğeleri, Kaynak denetim bölmesindeki Değişiklikler sekmesinin altında görünür. Bu değişiklikleri gözden geçirebilir, kaydedilmiş sürümle karşılaştırabilir ve eşitlemek için Git deposuna geri işleyebilirsiniz.

Güncelleştirmeler doğrudan bağlı Git deposunda (Azure DevOps veya GitHub) yapıldığında, yapay zeka yönergelerini değiştirme, örnek sorguları değiştirme veya yayımlama açıklamalarını düzenleme gibi eylemler içerebilir. Ardından bu değişiklikleri işleyebilir ve depoya gönderebilirsiniz. Güncelleştirmeler depoya gönderilip kullanıma sunulduktan sonra, Fabric çalışma alanınız bunları algılar ve Kaynak denetim bölmesinde kullanılabilir güncelleştirmeler bildirimi görüntüler. Veri aracısı gibi güncelleştirilmiş öğeler, gözden geçirebileceğiniz ve kabul ettiğiniz Güncelleştirmeler sekmesinin altında görünür. Bu güncelleştirmelerin kabul edilmesi, çalışma alanı öğelerinize yapılan depo değişikliklerini uygular ve çalışma alanının Git'te işlenen en son sürümü yansıtmasını sağlar.

Git deposundaki klasör ve dosya yapısı

Aşağıda, bir veri aracısının yapılandırmasının Git deposunda nasıl depolandığının yapısını gözden geçireceksiniz. Bu yapıyı anlamak, değişiklikleri yönetmek ve en iyi yöntemleri takip etme açısından önemlidir. Özellik dallarını kullanırken, çalışma alanına bağlı dalda değişiklikler yapın, Kaynak denetimi bölmesinde farkları gözden geçirin ve denetimli yükseltme için çekme istekleri aracılığıyla birleştirin. Veri aracıları için dosyalar ve yapılandırma yapısı dallar arasında aynı kalır.

Kök yapı

Kökte, veri aracısı içeriği dosyalar klasörünün altında depolanır. Dosyaların içinde, data_agent.json, publish_info.json, taslak klasörü ve yayımlanmış klasörü içeren bir yapılandırma klasörü bulursunuz.

Yapılandırma klasörünün içinde ,publish_info.json veri aracısı için yayımlama açıklamasını içerir. Bu dosya, veri aracısı yayımlandığında görüntülenen açıklamayı değiştirmek için güncelleştirilebilir.

Taslak klasör, veri aracısının taslak sürümüne karşılık gelen yapılandırma dosyalarını, yayımlanan klasör ise veri aracısının yayımlanan sürümü için yapılandırma dosyalarını içerir. Taslak klasör aşağıdakileri içerir:

Veri aracısı tarafından kullanılan her veri kaynağı için bir klasör bulunan veri kaynağı klasörleri. Her klasör adı, veri kaynağı türünün adını belirleyen bir önek ile başlar, ardından veri kaynağının adı gelir. Örneğin:
- Lakehouse veya ambar veri kaynakları: Klasör adları lakehouse-tables- veya warehouse-tables- ile başlar ve ardından lakehouse veya ambar adı gelir.
- Anlam modeli veri kaynakları: Klasör adları ile semantic-model-başlar ve ardından anlamsal modelin adı gösterilir.
- KQL veritabanı veri kaynakları: Klasör adları ile kusto-başlar ve ardından KQL veritabanının adı eklenir.
- Ontoloji veri kaynakları: Klasör adları ile ontology-başlar ve ardından ontolojinin adı kullanılır.
Fabric'teki SQL veritabanı, aynalı veritabanları, grafik modelleri ve Azure Yapay Zeka Arama gibi desteklenen diğer veri kaynakları da aynı adlandırma düzenini takip eder. Desteklenen veri kaynaklarının tam listesi için bkz. Fabric veri ajanında veri kaynaklarını ekle ve yapılandırmak.

stage_config.json dosyasında, ajan talimatlarına başvuran öğeyi içeren aiInstructions.

Her veri kaynağı klasörü datasource.json ve fewshots.jsoniçerir. Ancak, veri kaynağı anlamsal bir modelse örnek sorguları desteklemez, bu nedenle klasöründe yalnızca datasource.jsonbulunur.

datasource.json, bu veri kaynağının yapılandırmasını tanımlar, örneğin:

dataSourceInstructions, bu veri kaynağı için sağlanan yönergeleri temsil eder.
displayName, veri kaynağının adını gösterir.
elements, şema eşlemesine başvurur ve veri kaynağındaki tabloların ve sütunların tam listesini içerir.
- Her tablonun bir is_selected özelliği vardır. ise true, tablo dahil edilir ve ise false, tablo seçilmez ve veri aracısı tarafından kullanılmaz.
- Sütun girdileri is_selected öğesini de gösterir, ancak şu anda sütun düzeyinde seçim desteklenmemektedir. Tablo seçilirse, sütun is_selected değerinden bağımsız olarak tüm sütunları eklenir. Tablo seçili değilse (is_selected: false tablo düzeyinde), sütun düzeyinde is_selected olarak ayarlanmış olmasına rağmen sütunların hiçbiri true dikkate alınmaz.
Tür kuralları:
- Tür bir veri kaynağıysa, yalnızca veri kaynağı türüdür (örneğin: "type": "lakehouse_tables").
- Tür bir tabloysa, ile .table biter (örneğin: "type": "lakehouse_tables.table").
- Tür sütun ise, .column ile biter (örneğin: "type": "lakehouse_tables.column").

fewshots.json, veri kaynağı için örnek sorguları depolar. Her girdi şunları içerir:

id örnek sorgunun benzersiz tanımlayıcısı olarak.
question, bu da doğal dil sorusuna atıfta bulunur.
query veri kaynağı türüne bağlı olarak SQL veya KQL olabilecek sorgu metnini gösterir.

Yayımlanan klasör taslak klasörün yapısını yansıtır, ancak veri aracısının yayımlanmış sürümünü temsil eder. Yayımlanan klasördeki dosyaları doğrudan değiştirmemek en iyi yöntemdir. Taslak klasörde değişiklikler yapılmalıdır. Veri aracısı yayımlandıktan sonra, bu değişiklikler yayımlanan klasöre yansıtılır. Bu, yayımlanan sürümün her zaman denetimli taslak durumundan oluşturulmasını sağlar.

Veri aracıları için dağıtım işlem hatları

Dağıtım işlem hatları, veri aracılarını farklı yaşam döngüsü aşamalarına eşlenmiş çalışma alanları arasında taşımak için denetimli bir yol sağlar. Örneğin:

Geliştirme çalışma alanında yeni bir veri aracısı geliştirin veya mevcut bir aracıyı güncelleştirin.
Değişiklikleri doğrulama için test çalışma alanına aktarın.
Test edilen değişiklikleri son kullanıcıların kullanımına sunulduğu üretim çalışma alanında yükseltin.

Dağıtmadan önce dağıtım işlem hattındaki her aşamaya bir çalışma alanı atamanız gerekir: geliştirme, test ve üretim. Bir çalışma alanını test veya üretim aşamasına atamazsanız, çalışma alanları otomatik olarak oluşturulur. Oluşturulan çalışma alanları, geliştirme çalışma alanının adına [test] veya [prod] eklenmek suretiyle otomatik olarak adlandırılır.

Değişiklikleri uygulamak için

İşlem hattında, dağıtım yapmak istediğiniz aşamaya gidin (örneğin, geliştirme).
Çalışma alanında dağıtmak istediğiniz öğeleri seçin.
Bir sonraki aşamaya yükseltmek için Dağıt'ı seçin.

Değişiklikleri uygulamadan önce dağıtım planını gözden geçirerek yalnızca hedeflenen güncelleştirmelerin yükseltildiğinden emin olabilirsiniz. Daha fazla bilgi için Dağıtım işlem hatlarını kullanmaya başlama bölümüne bakın.

Azure DevOps İşlem Hatları ile CI/CD'yi otomatikleştirme

Fabric için Azure DevOps Pipelines uzantısı, Azure DevOps işlem hattı işlerinde Fabric CLI komutlarını çalıştıran yerel görevler sağlar. Takımlar, Azure DevOps (CLI ile) kullanarak veya Fabric dağıtım işlem hatları yerine veri aracısı güncellemeleri için CI/CD süreçlerini düzenleyebilirler. Başlamak için uzantıyı Visual Studio Market'ten yükleyin, Azure DevOps projenizde bir hizmet bağlantısı kurun ve işlem hattı tanımınıza Fabric CLI görevleri ekleyin.

Toplu api'ler aracılığıyla toplu eşitleme (önizleme)

Öğe Tanımlarını İçeri/Dışarı Aktarma Batch API'leri (önizleme), veri aracısı yapılandırmaları dahil olmak üzere öğe tanımlarının büyük ölçekli eşitlemesi için bir seçenek sağlar. Ortamlar arasında yükseltmeyi kolaylaştırmak için veri aracısı tanımlarını toplu olarak dışarı ve içeri aktarabilirsiniz. Daha fazla bilgi için Fabric REST API belgelerine bakın.

Uyarı

Hizmet sorumluları, ALM senaryolarının bir parçası olarak Fabric veri aracısında sadece desteklenir. Bu destek, ALM işlemlerinin (Git tümleştirmesi ve dağıtım işlem hatları gibi) etkinleştirilmesi ile sınırlıdır ve diğer Fabric veri aracısı özelliklerine genişletilmez. ALM iş akışlarının dışında bir veri aracısı ile etkileşim kurmanız gerekiyorsa hizmet sorumlusu desteklenmez.

Dağıtım işlem hatları için Fabric veri aracısı yayımlama

Fabric veri aracısını yayımlamak, Power BI, Microsoft Copilot Studio ve Döküm Araçları için Copilot dahil olmak üzere tüm farklı tüketim kanallarında kullanılmasını sağlar. Veri aracısını bu kanallarda değerlendirmek ve kullanmak için veri aracısının yayımlanması gerekir; yayımlanmamış veri aracılarına üretim çalışma alanında olsalar bile tüketim için erişilemez. Dağıtım işlem hattına uygun olarak en iyi yöntemleri izlemek için şunları unutmayın:

Bir geliştirme çalışma alanından yayımlama yalnızca veri aracısı geliştirme üzerinde çalışan ve farklı tüketim kanallarındaki performansını değerlendirmek isteyen yetkili kullanıcılarla sınırlı olmalıdır. Tamamlanmamış veya deneysel veri aracılarının daha geniş kitlelere sunulmaması için bu çalışma alanına erişim kısıtlanmalıdır.
Son kullanıcılar yalnızca üretim çalışma alanından yayımlanan veri aracılarına erişerek veri aracısının kararlı, onaylı sürümleriyle etkileşime geçmelidir.

Bu yaklaşım hem tüketim hem de performans değerlendirmesinin işlevsel gereksinimini destekler ve geliştirme ve üretim ortamlarını ayrı tutarak uygun erişim denetimini sağlar.

En iyi yöntemler

Veri aracıları üzerinde geliştirme çalışmaları için ayrılmış bir dal kullanın ve kod gözden geçirme işleminden sonra main ile birleştirin.
Daha kolay yükseltme için ilgili kaynakları (veri kaynakları, veri aracıları, not defterleri, işlem hatları) aynı çalışma alanında tutun.
Üretime almadan önce test çalışma alanında test veri aracı değişikliklerini yapın.
Geçmişin anlaşılmasını kolaylaştırmak için açıklayıcı işleme iletilerini kullanın.
Git deposundaki yayımlanmış klasörde doğrudan değişiklik yapmayın.
Veri aracısı veri kaynağı yapılandırmalarında ortama özgü değerleri sabit kodlamaktan kaçınmak için, desteklenen Değişken Kitaplığı üzerinden bağlantı referansları gibi ortamdan bağımsız yapılandırma desenlerini kullanın. Bu uygulama geliştirme, test ve üretim genelinde daha sorunsuz dal birleştirmeleri ve dağıtımları kolaylaştırır.

Sınırlamalar ve Dikkat Edilecek Hususlar

Yalnızca git deposuna bağlı çalışma alanları Git tabanlı ALM özelliklerini kullanabilir.
Hizmet sorumluları Fabric veri aracısında yalnızca ALM senaryolarının bir parçası olarak desteklenir. ALM iş akışlarının dışında bir veri aracısı ile etkileşim kurmanız gerekiyorsa hizmet sorumlusu desteklenmez.
Dağıtım işlem hatları, kaynak ve hedef çalışma alanlarının aynı kiracıda olmasını gerektirir.
Çok sayıda sık işleme, depo boyutunu ve performansını etkileyebilir.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-08-27