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 değişken kitaplığı, çalışma alanı içindeki diğer öğelerin uygulama yaşam döngüsü yönetimi (ALM) kapsamında kullanabileceği bir değişken demetidir. Çalışma alanında, yayın işlem hattının her aşaması için ilgili değerleriyle birlikte değişkenlerin listesini içeren bir öğe olarak çalışır. Yaşam döngüsü aşamaları arasında ölçeklenebilirlik ve tutarlılık sağlamaya yardımcı olmak için çalışma alanı içindeki öğe yapılandırmalarının verimli bir şekilde yönetilmesine yönelik birleşik bir yaklaşım sunar.
Örneğin, değişken kitaplığı şu değerlere sahip değişkenler içerebilir:
- İşlem hattındaki bekleme etkinliğinde kullanılacak tamsayı.
- Veri kopyalama etkinliğinde kaynak olarak bir veri gölü evi referansı. Her değer, işlem hattının yayın aşamasına göre farklı bir işlem hattında kullanılır.
- Bir defteri varsayılan lakehouse olarak yapılandırmak için bir lakehouse referansı. Her değer, not defterinin yayın aşamasına göre farklı bir işlem hattında kullanılır.
Tüketici öğesindeki değer çözümlemesinin dağıtımına bağlı olması şart değildir. Bunun yerine, her tüketici öğesi değeri kendi bağlamını temel alarak çözümler.
Değişken kitaplığının deneyimi değişken türüne göre farklılık gösterir, ancak tüm değişken kitaplıkları diğer öğelerin kullanabileceği değişkenleri tanımlamanıza ve yönetmenize olanak sağlar.
Bir Fabric değişkenler kütüphanesi:
- Sürekli tümleştirme ve sürekli teslim (CI/CD) işlemleriyle uyumludur. Bu uyumluluk Git ile tümleştirmeye ve dağıtım işlem hatları aracılığıyla dağıtıma olanak tanır.
- Fabric genel API'leri aracılığıyla otomasyonu destekler.
Fayda -ları
Değişken kitaplıkları müşterilerin yapılandırmaları özelleştirmesine ve paylaşmasına olanak tanır.
Yapılandırmaları özelleştirme
Yayın işlem hattı aşamasına göre bir değişken değeri yapılandırabilirsiniz. Değişken kitaplığını değer kümeleriyle yapılandırabilirsiniz: yayın işlem hattının her aşaması için bir değer. Ardından, her aşama için etkin değer kümesinin bir kerelik ayarlarından sonra, işlem hattı aşamasında doğru değer otomatik olarak kullanılır. Örnekler şunları içerir:
- Bir öğenin bağlantısını aşamaya göre değiştirme.
- Aşamaya göre farklı bir bulut veri kaynağına geçiş yapma.
- Sorgudaki veri miktarını aşamaya göre ayarlama.
Paylaşım yapılandırmaları
Değişken kitaplıklar, çalışma alanı öğeleri genelinde yapılandırmaları yönetmek için merkezi bir yol sağlar. Örneğin, çalışma alanında birkaç göl evi varsa ve her birinin aynı veri kaynağını kullanan bir kısayolu varsa, değişkenlerden biri olarak bu veri kaynağıyla bir değişken kitaplığı oluşturabilirsiniz. Bu şekilde, veri kaynağını değiştirmek istiyorsanız değişken kitaplığında yalnızca bir kez değiştirmeniz gerekir. Her göl evinde ayrı ayrı değiştirmeniz gerekmez.
Değişken kitaplık yapısı
Değişken kütüphaneleri bir veya daha fazla değişken içerir. Her değişkenin bir adı, türü ve varsayılan değeri vardır. Ayrıca, amacını veya nasıl kullanılacağını açıklamak için her değişkene bir not ekleyebilirsiniz.
Varsayılan değer
Varsayılan değer, özel olarak farklı bir değer tanımlamadığınız sürece kullanılan değerdir.
Tüm değişkenlerin varsayılan değeri olmalıdır. Değişken türü dizeyse, varsayılan değer olabilir null.
Alternatif değer kümeleri
Değer kümeleri, değişken kitaplığındaki her değişkenin değerlerini tanımlar. Değişken kitaplığı genellikle birden çok değer kümesi içerir. Etkin (veya etkili) değer kümesi, tüketici öğesinin bu çalışma alanı için aldığı değeri içerir.
Her çalışma alanında etkin olacak bir değer kümesi seçersiniz. Çalışma alanının etkin değer kümesi, Git'ten bir dağıtım veya güncelleştirme sırasında değişmez.
Alternatif bir değer kümesi oluşturduğunuzda, her değişken için varsayılan değer işaretçileriyle yeni değer kümesi oluşturulur. Ardından, yeni değer kümesindeki her değişkenin değerini değiştirebilirsiniz.
Desteklenen öğeler
Aşağıdaki öğeler değişken kitaplığını destekler:
- Pipeline
- Göl evi kısayolu
- Notebook, NotebookUtils ve
%%configurearacılığıyla - Veri Akışı 2. Nesil
- İşi kopyalama
- Kullanıcı verileri işlevleri
Dikkat edilmesi gerekenler ve sınırlamalar
Boyut sınırlamaları
Bu gereksinimlerin ikisini de karşıladığınız sürece en fazla1.000 değişken ve 1.000'e kadar değer kümesi olabilir:
- Alternatif değer kümelerindeki toplam hücre sayısı 10.000'den azdır.
- Öğenin boyutu 1 MB'ı aşmaz.
Değişiklikleri kaydettiğinizde bu gereksinimler doğrulanır.
Not alanında en çok 2.048 karakter olabilir.
Değer kümesi açıklama alanında en çok 2.048 karakter olabilir.
Alternatif değer kümeleri için sınırlamalar
- Değişken kitaplığındaki alternatif değer kümeleri, bunları eklediğiniz sırada görünür. Şu anda kullanıcı arabiriminde bunları yeniden sıralayamazsınız. Sırayı değiştirmek için JSON dosyasını doğrudan düzenleyin.
- Her değer kümesinin adı bir değişken kitaplığı içinde benzersiz olmalıdır.
- Değişken adları bir değişken kitaplığı içinde benzersiz olmalıdır. Çalışma alanı içinde farklı öğelerdeyse aynı ada sahip iki değişkeniniz olabilir.
- Değişken kitaplığında bir kerede her zaman bir (ve yalnızca bir) etkin değer ayarlanır. Etkinken bir değer kümesini silemezsiniz. Silmek için önce başka bir değer kümesini etkin olacak şekilde yapılandırın. Dağıtım işlem hattının her aşaması için farklı bir etkin değer ayarlayabilirsiniz.