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.
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.
- 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.
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ı
Fabric'teki Değişken Kitaplığı, çalışma alanları ve dağıtım aşamalarında yapılandırma parametrelerini yönetmek amacıyla tasarlanmış yapılandırılmış bir sistemdir. Çekirdeğinde, temel türler (dize, tamsayı, boole gibi) veya öğe başvuruları gibi karmaşık türler olabilecek kullanıcı tanımlı değişkenler bulunur. Bu değişkenler bir Değişken Kitaplığı öğesi içinde gruplandırılır ve aynı çalışma alanı içindeki tüketici öğeleri tarafından başvurulabilir.
Dinamik yapılandırmayı desteklemek için her değişkende farklı ortamlar (geliştirme, test, üretim gibi) için uyarlanmış birden çok değer kümesi veya alternatif değer kümesi olabilir. Çalışma zamanı sırasında hangi değerlerin kullanıldığını belirlemek için çalışma alanı başına bir değer kümesi "etkin" olarak belirlenir.
Kullanıcılar yerleşik doğrulama ve izin denetimleriyle Doku kullanıcı arabirimi veya API'leri aracılığıyla değişkenleri ve değer kümelerini oluşturabilir, düzenleyebilir ve yönetebilir. Sistem CI/CD iş akışlarını destekler ve değişkenlerin kod olarak yönetilmesine, Git ile tümleştirilmesine ve işlem hatları aracılığıyla dağıtılmasına olanak tanır. Bu yapı, karmaşık veri sistemlerinde ölçeklenebilir, otomatik ve yönetilen yapılandırma yönetimi sağlar.
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
Adlandırma kuralları
Değişken kitaplık öğesinin adı şu kurallara uygun olmalıdır:
- Boş değil
- Başta veya sonda boşluk yok
- Bir harfle başlar
- Harf, sayı, alt çizgi, kısa çizgi ve boşluk içerebilir
- Uzunluğu 256 karakteri aşmaz
Değişken kitaplığı adı büyük/küçük harfe duyarlı değildir .
Dikkat edilmesi gerekenler ve sınırlamalar
Değişkenler için 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.