Aracılığıyla paylaş

Pipeline ile değişken kitaplık entegrasyonu

Değişken kitaplığı, Microsoft Fabric'te yeni bir öğe türüdür. Değişken kitaplığını kullanarak değişkenleri çalışma alanı düzeyinde tanımlayabilir ve yönetebilirsiniz. Bu değişkenleri işlem hatları, not defterleri, lakehouse kısayolu ve daha fazlası gibi çeşitli çalışma alanı öğelerinde kullanabilirsiniz. Yapılandırmaları yönetmek için birleşik ve merkezi bir yol sağlayarak sabit kodlanmış değerlere olan ihtiyacı azaltır ve CI/CD işlemlerinizi basitleştirir. Farklı ortamlarda yapılandırmaları yönetmek daha kolaydır.

İşlem hatları ile Değişken kitaplığını kullanma

  1. Çalışma alanınıza gidin ve yeni bir öğe oluşturun.

    Fabric çalışma alanınızda yeni bir öğe eklemek için yerin vurgulandığı ekran görüntüsü.

  2. Değişken kitaplığını bulmak için filtreyi kullanın veya veri geliştirme bölümüne gidin.

    Yeni değişken kitaplık öğesinin filtresini gösteren ekran görüntüsü.

  3. Yeni bir Değişken kitaplığı oluşturmak için Değişken kitaplığı'na tıklayın. Bir ad girin ve Oluştur'u seçin.

    Ad kümesi ve Oluştur düğmesi vurgulanmış yeni bir Değişken kitaplık öğesini gösteren ekran görüntüsü.

  4. Değişken kitaplığını oluşturduktan sonra giriş sayfasına yönlendirilirsiniz. Yeni değişken eklemek için + Yeni'yi seçin.

    Yeni değişken kitaplık öğesinin başlangıç sayfasını gösteren ekran görüntüsü.

  5. Yeni bir değişken eklediğinizde, değişkeninizi yapılandırabilir ve Ad, Tür ve Varsayılan değerini ayarlayabilirsiniz. Notlar da ekleyebilirsiniz.

    Yeni değişken için ayar yapılacak yapılandırmaları gösteren ekran görüntüsü.

  6. Gerektiğinde Alternatif değer kümeleri ekleyin (örneğin, farklı dağıtım işlem hattı ortamları için farklı değerler). Bir ad belirleyip Oluştur'u seçtikten sonra değişken değerlerini düzenleyebilir ve hangi değerin etkin hale getirileceğini seçebilirsiniz.

    Bir değişken için yeni değer kümelerinin ekleneceği yeri vurgulayan ekran görüntüsü.

    Yeni bir değer kümesi için ad eklemeyi gösteren ekran görüntüsü.

  7. İşiniz bittiğinde değişikliklerinizi kaydedin.

    Sol üst köşede Kaydet düğmesinin vurgulandığı ekran görüntüsü.

İşlem hattınızda Değişken kitaplığı değişkenlerini kullanma

  1. İşlem hattınızda Değişken kitaplığı değişkeni kullanmak için yeni bir işlem hattı oluşturun veya mevcut bir işlem hattına gidin.

    Sol üst köşedeki yeni öğe oluştur düğmesini ve işlem hattı öğesini vurgulayan ekran görüntüsü.

  2. İşlem hattınızda, alt paneldeki değişken kütüphanesi değişkeninize bir referans oluşturun.

    Kitaplık değişkenleri sekmesini ve işlem hattı tuvalinin alt panelindeki +Yeni düğmesini vurgulayan ekran görüntüsü.

  3. + Yeni'yi seçin. Tüm Değişken kitaplıklarınızı gösteren bir açılır pencere açılır. Değişken kitaplığı değişkeninizi seçmek için bu seçiciyi kullanın ve Tamam'ı seçin.

    Kitaplık değişkeni sekmesindeki +Yeni düğmesinin vurgulandığı ekran görüntüsü.

    Değişken seçicide seçilen kitaplık değişkenini gösteren ekran görüntüsü.

    Yeni bir Kitaplık değişkeni başvurusu için yapılandırma kümesini gösteren ekran görüntüsü.

  4. Kütüphane değişken başvurularınızı ekledikten sonra pipeline aktivitelerinizi ekleyin. Etkinlik ayarlarında parametreleştirmek istediğiniz ayar için Dinamik içerik ekle'yi seçin.

    Arama etkinliğinin ayarlarında Dinamik içerik ekle seçeneğinin vurgulandığı ekran görüntüsü.

  5. İfade oluşturucu açılır. Kitaplık değişkenlerini görmüyorsanız İşlevler'in yanındaki üç noktayı seçin ve Kitaplık değişkenleri'ni seçin.

    İfade oluşturucusunda İşlevler'in yanındaki 3 noktayı ve Kitaplık değişkenleri sekmesinin vurgulandığı ekran görüntüsü.

  6. Yeni bir ifade eklemek için ifade yapılandırıcıda Kitaplık değişkeni referansınızı seçin. Ardından, ifadenizi eklemek için Tamam'ı seçin.

    İfade oluşturucuya eklenmek üzere vurgulanan kütüphane değişkeni referansının ekran görüntüsü.

    İfade oluşturucusunda ayarlanan ifadeyi gösteren ekran görüntüsü.

  7. Dinamik içeriğin etkinlik ayarınıza eklendiğini görürsünüz.

    Arama etkinliği ayarlarında dinamik içerik olarak ayarlanan ifadeyi gösteren ekran görüntüsü.

  8. Verileri önizle'yi seçerek verilerinizin önizlemesini görebilirsiniz. Bu eylem, kitaplık değişkeninizin değerini gösteren yeni bir bölme açar. Verilerinizin önizlemesini almak için Tamam'ı seçin.

    Önizleme verileri seçeneğini gösteren ekran görüntüsü.

    Önizleme veri bölmesini gösteren ekran görüntüsü.

  9. normalde yaptığınız şekilde boru hattınızı kaydedin ve çalıştırın. Geçirilen değerin Değişken kitaplığınızda Etkin olarak ayarlanan değer olduğunu görürsünüz.

    İşlem hattı tuvalinde Kaydet ve Çalıştır ayarlarının vurgulandığı ekran görüntüsü.

Bilinen sınırlamalar

Aşağıdaki bilinen sınırlamalar, Microsoft Fabric'teki Data Factory'deki işlem hatlarında Değişken kitaplığının tümleştirilmesi için geçerlidir:

  • Değişken kitaplığı veri türü olarak Boole, Datetime, Guid, Integer, Number ve String'i destekler. İşlem hattınızda Boolean'ı Bool türü, Datetime'i String türü, Guid'i String türü, Integer'i Int türü ve String'i String türü olarak görürsünüz. Sayı türleri işlem hatlarında desteklenmez.
  • Dış bağlantı parametreleştirmesi, boru hatlarıyla tümleştirilmiş değişken kitaplığı kullanılarak desteklenir. Ancak, Ayarlar | Bağlantıları ve ağ geçitlerini yönet bölümünden bağlantınız için GUID'yi aramanız gerekir. Bağlantı adınızın yanındaki Ayarlar'ı seçerek bağlantınızın GUID değerini bulursunuz.

İlgili içerik

  • Last updated on