Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Microsoft Fabric'teki öğeler bir klasörde depolanır. Öğeyi içeren klasör kök dizinde veya bir alt dizinde olabilir. Çalışma alanınızı git'e bağladığınızda, öğeleri içeren klasöre bağlanın. Klasördeki her öğe kendi alt dizininde temsil edilir.
Dizin adı
Git'e yeni bir öğe kaydettiğinizde Git tümleştirmesi bu öğe için otomatik olarak bir dizin oluşturur.
Öğe dizini adı aşağıdaki kuralları temel alır:
- Adın deseni şeklindedir
{display name}.{public facing type}. - Gerekirse, görünen adda aşağıdaki değişiklikler yapılır:
- Geçersiz karakterler HTML numarasıyla değiştirilir.
- Baştaki boşluk, HTML numarası ile değiştirilir.
- Sondaki boşluk veya nokta, HTML numarasıyla değiştirilir.
- Bu klasör adı kullanılamıyorsa, görünen ad yerine öğenin mantıksal kimliğinin (GUID) adı kullanılır.
Örneğin, bir çalışma alanında aşağıdaki öğeler varsa (birinci ve üçüncü öğelerin sırasıyla görünmez bir baştaki ve sondaki alana sahip olduğunu unutmayın):
Aşağıdaki dizinler Git deposunda oluşturulur:
- Oluşturulduktan sonra Git tümleştirmesi hiçbir zaman bir dizinin adını değiştirmez. Öğenin adını değiştirseniz bile dizin adı aynı kalır.
- Öğe dizininin adını el ile değiştirirseniz, öğenin bağımlılıklarını hesaba katmaya dikkat edin. Örneğin, bir semantik modelin dizinini değiştirirseniz, raporun bağımlılık dosyasındaki semantik modelin yolunu güncelleştirdiğinizden emin olmanız gerekir. Bağımlılık konumlarının farklı Doku deneyimleri arasında farklılık gösterdiğini unutmayın. Dizin adının değiştirilmesi, çalışma alanında gelen bir değişikliğe neden olmaz .
Dizin içeriği
Her öğe dizini, öğe tanım dosyalarını ve otomatik olarak oluşturulan sistem dosyalarını içerir.
Öğe tanım dosyaları
Her öğenin dizini, bu öğeyi tanımlayan belirli, gerekli dosyalara sahiptir.
Şu anda Microsoft Fabric'te aşağıdaki öğeler desteklenmektedir:
Yansıtılmış veritabanları
Yansıtılmış veritabanı klasörleri, yansıtılmış veritabanını tanımlayan bir .json dosyası içerir.
Yansıtılmış veritabanlarıyla Git tümleştirmesi kullanım yönergeleri için bkz. Yansıtılmış Veritabanları için CI/CD.
Not defteri dosyaları
Not defteri klasörleri bir .py dosyası içerir:
Not defterleriyle Git tümleştirmesi kullanma yönergeleri için bkz . Not defteri kaynak denetimi ve dağıtımı.
Sayfalandırılmış rapor dosyaları
Sayfalandırılmış rapor klasörleri, sayfalandırılmış raporu tanımlayan bir .rdl dosyası içerir. RDL (Rapor Tanımı Dili), sayfalandırılmış rapor tanımının XML gösterimidir.
RDL hakkında daha fazla bilgi için bkz. Rapor Tanımı Dili (RDL). Sayfalandırılmış raporlarla Git tümleştirmesini kullanma yönergeleri için, Sayfalandırılmış raporlarla Git tümleştirmesi başlıklı kılavuza bakın.
Rapor dosyaları
Rapor klasörleri aşağıdaki dosyaları içerir:
- definition.pbir
- report.json
Rapor klasörleri ve içeriklerinin tam listesi hakkında daha fazla bilgi için bkz . Power BI Desktop proje raporu klasörü.
Anlamsal model dosyaları
Anlam modeli klasörleri aşağıdaki dosyaları içerir:
- tanım.pbism
- TMDL dosyalarıyla \definition klasörü
Anlam modeli klasörleri ve bunların içeriğinin tam listesi hakkında daha fazla bilgi için bkz . Power BI Desktop proje anlam modeli klasörü.
Otomatik olarak oluşturulan sistem dosyaları
Öğe tanımı dosyalarına ek olarak, kullandığınız sürüme bağlı olarak her öğe dizini otomatik olarak oluşturulan bir veya iki sistem dosyası içerir:
- Sürüm 1 dizini item.metadata.json ve item.config.json içerir. V1 ile her iki dosya da dizinde olmalıdır.
- Sürüm 2 dizini .platform içerir. Bu dosya hem item.metadata.json hem de item.config.json dosyalarının içeriğini içerir. Bu dosyaya sahipseniz diğer iki dosyaya sahip olamazsınız. Sürüm 1'i kullanıyorsanız ve değişiklikleri işliyorsanız sistem dosyalarınız otomatik olarak bu sürüme güncelleştirilir.
Note
Dizininiz, ya item.metadata.json ve item.config.json dosyalarını ya da dosyasını içermelidir. Üç dosyaya da sahip olamazsınız.
Platform dosyası
Sürüm 2'de, her öğe dizininde iki kaynak dosya olması yerine .platform dosyası tüm bilgileri bir $schema özelliğiyle birlikte tek bir dosyada birleştirir. Bu dosyaya sahipseniz diğer iki dosyaya sahip olamazsınız.
{
"version": "2.0",
"$schema": https://developer.microsoft.com/json-schemas/fabric/platform/platformProperties.json,
"config": {
"logicalId": "e553e3b0-0260-4141-a42a-70a24872f88d"
},
"metadata": {
"type": "Report",
"displayName": "All visual types",
"description": "This is a report"
}
}
Dosya .platform aşağıdaki öznitelikleri içerir:
-
version: Sistem dosyalarının sürüm numarası. Bu sayı geriye dönük uyumluluğu etkinleştirmek için kullanılır. Öğenin sürüm numarası farklı olabilir. -
logicalId: (dize) Bir öğeyi ve kaynak denetimi gösterimini temsil eden otomatik olarak oluşturulan çalışma alanları arası tanımlayıcı. -
type: (dize) Öğenin türü (anlamsal model, rapor vb.) -
displayName: (dize) Öğenin adı. -
description: (isteğe bağlı dize) Öğenin açıklaması.
Eğer çalışma alanında yapıtı yeniden adlandırırsanız ve Git'teki yapıt klasörünün adı '.' ile bitiyorsa, işlemeyi tamamladıktan sonra, Git'teki displayName ve dizin adı birbirleriyle eşleşecektir.
logicalId, çalışma alanında bulunan bir öğeyi Git dalındaki ilgili öğesiyle bağlar. Aynı mantıksal kimliği olan öğelerin aynı olduğu varsayılır. Ad veya dizin değişse bile logicalId bağlantıyı korur. Bir dal birden çok çalışma alanıyla eşitlenebildiğinden, farklı çalışma alanlarında aynı logicalId'ye sahip öğeler olabilir, ancak tek bir çalışma alanında aynı logicalId'ye sahip iki öğe olamaz. Mantıksal Id, çalışma alanı bir Git dalına bağlandığında veya yeni bir unsur eşitlendiğinde oluşturulur. Git tümleştirmesinin düzgün çalışması için logicalId gereklidir. Bu nedenle, herhangi bir şekilde değiştirmemek önemlidir.
Note
Sürüm 1'de Değişiklikleri Git'e kaydettiğinizde, sistem dosyaları değişikliklerle birlikte otomatik olarak sürüm 2'ye güncelleştirilir. Ayrıca, Power BI Desktop geliştirici modundan dışarı aktarılan tüm yeni dosyalar sürüm 2 dosya biçiminde kaydedilir.
Note
- Tür alanı büyük/küçük harfe duyarlıdır. Otomatik olarak oluşturulma şeklini değiştirmeyin veya başarısız olabilir.
- Bir öğenin mantıksal kimliğini veya görünen adını genel olarak değiştirmemelisiniz, ancak var olan bir öğe dizinini kopyalayarak yeni bir öğe oluşturuyorsanız bir özel durum olabilir. Bu durumda, mantıksal kimliği ve görünen adı depoda benzersiz bir adla değiştirmeniz gerekir.