Değişken kitaplıkları oluşturma ve yönetme

Microsoft Fabric değişken kitaplıkları, geliştiricilerin içerik yaşam döngüsü yönetimini kolaylaştırma amacıyla çalışma alanı içindeki öğe yapılandırmalarını özelleştirmesine ve paylaşmasına olanak tanır. Bu makalede değişken kitaplıkları oluşturma, yönetme ve kullanma açıklanmaktadır.

İşlemin daha ayrıntılı bir kılavuzu için değişken kitaplıklarını kullanma öğreticisine bakın.

Prerequisites

Doku'da değişken kitaplık öğeleri oluşturmak için şunları yapmanız gerekir:

• Fabric adlı hizmetin etkin bir aboneliğine sahip kiracı hesabı. Ücretsiz bir hesap oluşturun.

• kapasitesine sahip Microsoft Fabric özellikli bir çalışma alanı.

• Yönetici portalından etkinleştirilen aşağıdaki kiracı anahtarları :

  • Kullanıcılar Fabric nesneleri oluşturabilir

  Kiracı yöneticisi, kapasite yöneticisi veya çalışma alanı yöneticisi, kuruluşunuzun ayarlarına bağlı olarak bu anahtarları etkinleştirebilir.

Doku değişken kitaplıkları için güvenlik konuları ve izin yönetimi

Doku değişken kitaplıkları, birden çok Doku öğesinde değişkenlerin merkezi olarak yönetilmesini sağlayan güçlü yapılardır. Ancak bu esneklik, güvenlikle ilgili önemli noktalara neden olabilir.

Değişken kitaplıklarının kendileri Doku öğeleri olduğundan, kendi izin kümeleri tarafından yönetilirler. Bu izin kümeleri, değişkenlerini kullanan öğelerden farklı olabilir. Bu tutarsızlık, kullanıcının değişken kitaplığına yazma erişimine sahip olduğu ancak tüketen öğeye erişimi olmayan senaryolara yol açabilir.

Bu gibi durumlarda, yetkisiz kullanıcılar değişken değerlerini bağımlı Doku öğelerinin davranışını kasıtlı veya kasıtsız olarak değiştirecek şekilde değiştirebilir. Bu özellik, paylaşılan değişkenlere yönelik kötü amaçlı güncelleştirmelerin bu öğelerin bütünlüğünü, güvenliğini veya işlevselliğini tehlikeye atabileceği olası bir saldırı vektöru oluşturur.

Bu riskleri azaltmak için şu temel uygulamaları izleyin:

• Katı izin denetimlerini benimseme: Yalnızca güvenilen kullanıcıların veya hizmetlerin bunları değiştirebilmesi için yöneticilerin değişken kitaplıklarında yazma izinlerini dikkatle yönetmesi gerekir. Bu uygulama, fazla izinli erişimi önlemeyi ve izin atamalarını düzenli olarak denetlemeyi içerir.
• Güvenilen kitaplık başvurularını kullan: Öğeler yalnızca açıkça güvenilen olarak belirlenmiş kitaplıklardan gelen değişkenlere başvurmalıdır. Bu güven modeli, geliştirme ve dağıtım sırasında değişken başvurularının kaynağını doğrulayan idare ilkeleri aracılığıyla uygulanmalıdır.

Daha fazla bilgi için bkz . Değişken kitaplığı izinleri.

Değişken kitaplık öğesi oluşturma

Doku giriş sayfasından veya çalışma alanınızın içinden bir değişken kitaplık öğesi oluşturabilirsiniz:

Giriş sayfası

1. Kenar çubuğunda Oluştur'u seçin. (Orada değilse, üç noktayı seçin ve ardından Oluştur'u seçin.)

2. Data Factory bölümünde Değişken kitaplığı'nı seçin.

   

3. Yeni değişken kitaplığını adlandırın ve Oluştur'u seçin. Adın gerekli adlandırma kurallarına uygun olduğundan emin olun.

Workspace

1. + Yeni öğe'yi seçin.

2. Ekranı aşağı kaydırarak Veri geliştir bölümüne gelin ve Değişken kitaplığı'nı seçin.

   

3. Yeni değişken kitaplığını adlandırın ve Oluştur'u seçin. Adın gerekli adlandırma kurallarına uygun olduğundan emin olun.

Boş bir değişken kitaplığı görüntülenir. Artık buna değişkenler ekleyebilirsiniz.

Değişken kitaplıklarını ve değişkenlerini yönetme

Değişken kitaplığındaki değişkenleri üst menü çubuğundan yönetebilirsiniz.

Değişken ekleme

Kitaplığa yeni bir değişken eklemek için:

1. + Yeni değişken'i seçin.
2. Bir ad girin. Adlandırma kurallarına uyduğunu doğrulayın.
3. Açılan listeden bir tür seçin. Desteklenen değişken türlerinin listesine bakın.
4. Varsayılan bir değer girin.
5. Değişkenin ne için olduğunu veya nasıl kullanılacağını açıklayan bir not ekleyin (isteğe bağlı).
6. Kaydetseçeneğini seçin.

Değişkeni silme veya düzenleme

• Bir değişkeni silmek için bir veya daha fazla değişken seçin ve ardından Değişkeni> silKaydet'i seçin.
• Değişkenin adını, türünü veya değer kümesini düzenlemek için değeri değiştirin ve kaydet'i seçin.
• Başka bir alternatif değer kümesi eklemek için Değer kümesi ekle'yi seçin.

Note

Değişken kitaplığındaki herhangi bir değişkeni düzenledikten sonra Kaydet'in seçilmesi, tüm değişken adlarının ve değerlerinin geçerli olduğundan emin olmak için bir hata doğrulama denetimi tetikler. Değişiklikleri kaydetmeden önce hataları düzeltmeniz gerekir.

Değer kümesi ekleme

Farklı bir aşamada kullanabileceğiniz başka bir değer kümesi eklemek için:

1. Değer kümesi ekle'yi seçin.

2. Değer kümesini adlandırın. Adlandırma kurallarına uyduğunu doğrulayın. 2.048 karaktere kadar açıklama (isteğe bağlı) verin.

3. Bu değeri bu çalışma alanında ayarlanmış olan etkin değer olarak kullanmak istiyorsanız Etkin olarak ayarla'yı seçin.

4. Değişken kitaplığındaki tüm değişkenler için değerleri girin.

5. Kaydetseçeneğini seçin.

Değer kümesini düzenleme

Değer kümesini düzenlemek için:

1. Değer kümesinin adının yanındaki üç noktayı seçin.

2. Etkin olarak ayarla (bu çalışma alanı için), Yeniden Adlandır'ı veya Sil'i seçin.

   

3. Kaydetseçeneğini seçin. Değişiklikler yalnızca siz kaydettikten sonra geçerlilik kazanır.

Her değişkenin değerini varsayılan değere sıfırlamak için sıfırla düğmesini seçin.

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ında 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.