Aracılığıyla paylaş


Değişken kitaplığı nedir?

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:

  • 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.

Çeşitli değişkenleri ve bunların temel bileşenlerini içeren bir değişken kitaplığının ekran görüntüsü.

Desteklenen öğeler

Aşağıdaki öğeler değişken kitaplığını destekler:

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.