Öğretici: Öğe yapılandırmalarını özelleştirmek ve paylaşmak için değişken kitaplıkları kullanma

Bu öğreticide, Microsoft Fabric işlem hatlarında dinamik içeriğin nasıl kullanılacağı gösterilmektedir. Bir değişken kitaplık öğesi oluşturduğunuzda ve buna değişkenler eklediğinizde, dağıtım işlem hattınızın çeşitli aşamaları için değerleri otomatikleştirebilirsiniz. Bu öğreticide, verileri bir göl evinden diğerine kopyalarsınız. Ardından, kopyalama etkinliğinin kaynak ve hedef değerlerini ayarlamak için değişken kitaplığını kullanırsınız.

Bu öğreticide şunları yapacaksınız:

  • Değişken kitaplığı oluşturun.
  • Kitaplığa değişkenler ekleyin.
  • Değişkenler için ek değer kümeleri tanımlayın.
  • Çalışma alanındaki başka bir öğede (işlem hattı) değişkenleri kullanın.
  • Git deposundaki değişkenleri düzenleyin.
  • Bir dağıtım işlem hattı oluşturun ve değişken kitaplığını dağıtın.
  • Dağıtım işlem hattının hedef aşamasında ayarlanan etkin değeri değiştirin.
  • değişkeninin değerinin her aşamada ayarlanan etkin değerle uyumlu olduğunu gösterin.

Aşağıdaki diyagramda bu öğreticinin çalışma alanı düzeni gösterilmektedir.

Çalışma alanı düzeninin diyagramı.

Önkoşullar

Stage LHs çalışma alanını, örnek verilerle SourceLH_Stage lakehouse'u ve Pipeline_Stage işlem hattını oluşturma

İlk olarak, ilk hazırlama verileriniz olarak kullanmak üzere bir çalışma alanı ve lakehouse oluşturun:

  1. Power BI'a gidin.

  2. Kenar çubuğunda Çalışma Alanı'nı seçin.

  3. Çalışma alanı oluşturun. Buna Aşama LH'leri deyin.

    Yeni çalışma alanı oluşturmaya yönelik düğmenin ekran görüntüsü.

  4. Göl evi oluşturma:

    1. Çalışma alanının üst kısmında Yeni öğe'yi seçin.

    2. Verileri depola'nın altında Lakehouse'ı seçin.

      Yeni bir öğe olarak göl evi seçme kutucuğunun ekran görüntüsü.

    3. SourceLH_Stage adını girin ve Oluştur'u seçin.

  5. İşlem hattı oluşturma:

    1. Lakehouse'ta Yeni pipeline'ı seçin.

      Yeni işlem hattı oluşturmaya yönelik kutucuğun ekran görüntüsü.

    2. Pipeline_Stage adını girin ve Oluştur'u seçin.

    3. Lakehouse'a veri kopyalama sihirbazının Veri kaynağı seçin sayfasında Örnek veriler'i seçin.

      Lakehouse'a veri kopyalamak için veri kaynağı seçme sayfasının ekran görüntüsü.

    4. Resmi Tatiller'i seçin.

      Resmi Tatiller örnek verilerini seçme işleminin ekran görüntüsü.

    5. Örnek verilerin yüklenmesi tamamlandıktan sonra İleri'yi seçin.

    6. Veri hedefine bağlan sayfasında İleri'yi seçin.

      İşlem hattı hedefinin ayrıntılarının ekran görüntüsü.

    7. Gözden Geçir + kaydet sayfasında Kaydet + Çalıştır'ı seçin.

      İşlem hattını kaydetme ve çalıştırma sayfasının ekran görüntüsü.

Değişkenler çalışma alanıyla Kaynak LH'ler oluşturma

Şimdi, çalışacağınız çalışma alanını oluşturun ve değişken kitaplığınızla birlikte kullanın:

  1. Power BI'a gidin.

  2. Kenar çubuğunda Çalışma Alanı'nı seçin.

  3. Çalışma alanı oluşturun. Değişkenli Kaynak LH'ler olarak adlandır.

SourceLH_Dev, SourceLH_Test ve SourceLH_Prod göl evleri oluşturma

Ardından, değişken kitaplığıyla kullanmak üzere üç lakehouse oluşturun:

  1. İlk lakehouse'u oluşturun:

    1. Kenar çubuğunda Değişkenli Kaynak LH'ler çalışma alanını seçin.

    2. Yeni öğe seçin.

    3. Verileri depola'nın altında Lakehouse'ı seçin.

    4. SourceLH_Dev adını girin ve Oluştur'u seçin.

  2. Önceki adımları izleyerek ikinci lakehouse'u oluşturun. SourceLH_Test olarak adlandır.

  3. Yukarıdaki adımları izleyerek üçüncü lakehouse'u oluşturun. SourceLH_Prod olarak adlandır.

  4. Kenar çubuğunda Değişkenler içeren Kaynak LH'ler çalışma alanını seçin ve yeni oluşturulan tüm göl evlerini içerdiğinden emin olun.

Göl evleri için çalışma alanı kimliklerini ve nesne kimliklerini alma

Bu adımlarda, değişken kitaplığınızda kullanılacak benzersiz tanımlayıcıları alırsınız:

  1. Power BI'da kenar çubuğunda, Aşama LH'leri çalışma alanını seçin.

  2. Çalışma alanında SourceLH_Stage göl evi'ni seçin.

  3. URL'deki çalışma alanı kimliğini ve lakehouse nesne kimliğini kopyalayın.

    Çalışma alanı tanımlayıcısının ve lakehouse nesne tanımlayıcısının nasıl alındığını gösteren ekran görüntüsü.

  4. SourceLH_Dev veSourceLH_Test Lakehouse'lar için önceki adımları Değişkenli Kaynak LH'ler çalışma alanında yineleyin.

Değişkenlerle değişken kitaplığı oluşturma

Şimdi değişken kitaplığını oluşturun:

  1. Değişkenli Kaynak LH'ler çalışma alanında Yeni öğe'yi seçin.

  2. Veri geliştir'in altında **Değişken kitaplığı **'ı seçin.

    Değişken kitaplığı oluşturmaya yönelik kutucuğu gösteren ekran görüntüsü.

  3. Kitaplığa WS değişkenlerini adlandırın ve Oluştur'u seçin.

  4. Yeni değişken'i seçin.

    Yeni bir değişken seçme düğmesini gösteren ekran görüntüsü.

  5. Aşağıdaki değişkenleri oluşturun:

    İsim Türü Varsayılan değer kümesi
    Source_LH String <SourceLH_Stage lakehouse GUID'i>
    Source_WSID String <SourceLH_Stage çalışma alanının GUID'i>
    Destination_LH String <SourceLH_Dev lakehouse GUID'i>
    Destination_WSID String <SourceLH_Dev çalışma alanının GUID'i>
    SourceTable_Name String Processed
    DestinationTable_Name String DevCopiedData

    Değişken kitaplığı için tamamlanmış varsayılan kümenin ekran görüntüsü.

  6. Kaydetseçeneğini seçin.

Alternatif değer kümeleri oluşturma

Bu adımlarda, değişken kitaplığınıza alternatif değer kümeleri eklersiniz:

  1. İlk değer kümesini oluşturun:

    1. WS Değişkenleri değişken kitaplığında Değer kümesi ekle'yi seçin.

    2. Ad için Test VS yazın ve Oluştur'u seçin.

    3. Aşağıdaki değişkenleri oluşturun:

      İsim Türü Varsayılan değer kümesi
      Source_LH String <SourceLH_Dev lakehouse GUID'i>
      Source_WSID String <SourceLH_Dev çalışma alanının GUID'i>
      Destination_LH String <SourceLH_Test lakehouse GUID'i>
      Destination_WSID String <SourceLH_Test çalışma alanının GUID'i>
      SourceTable_Name String DevCopiedData
      DestinationTable_Name String TestCopiedData

    4. Kabul Et'i> seçin.

  2. İkinci değer kümesini oluşturun:

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

    2. Ad olarak Prod VS girin ve Oluştur'u seçin.

    3. Aşağıdaki değişkenleri oluşturun:

      İsim Türü Varsayılan değer kümesi
      Source_LH String <SourceLH_Test lakehouse GUID'i>
      Source_WSID String <SourceLH_Test çalışma alanının GUID'i>
      Destination_LH String <SourceLH_Prod lakehouse GUID'i>
      Destination_WSID String <SourceLH_Prod çalışma alanının GUID'i>
      SourceTable_Name String TestCopiedData
      DestinationTable_Name String ProdCopiedData

      Değişken kitaplığındaki tamamlanmış alternatif değerlerin ekran görüntüsü.

    4. Kabul Et'i> seçin.

Pipeline_Deploy işlem hattını oluşturma ve değişkenleri bildirme

Bu adımlarda işlem hattınızı oluşturur ve değişkenlerinizi bildirirsiniz:

  1. Değişkenli Kaynak LH'ler çalışma alanında Yeni öğe'yi seçin.

  2. Veri al altında Pipeline'ı seçin.

    Bir işlem hattı karosunun ekran görüntüsü.

  3. Pipeline_Deploy adını girin ve Oluştur'u seçin.

  4. Verileri>kopyala Tuvale ekle'yi seçin.

    Tuvale veri kopyalama eklemeye yönelik menü seçimlerinin ekran görüntüsü.

  5. Odağın Verileri kopyala seçeneğinin dışında olması için tuvali seçin.

  6. **Kütüphane değişkenleri**'ni seçin.

    Kitaplık değişkenleri sekmesinin ekran görüntüsü.

  7. Yeni'yi seçin ve aşağıdaki değişkenleri ekleyin:

    İsim Kütüphane Değişken adı Türü
    SourceLH WS Değişkenleri Source_LH String
    SourceWSID WS Değişkenleri Source_WSID String
    DestinationLH WS Değişkenleri Destination_LH String
    DestinationWSID WS Değişkenleri Destination_WSID String
    SourceTableName WS Değişkenleri SourceTable_Name String
    DestinationTableName WS Değişkenleri DestinationTable_Name String

    İşlem hattına değişken ekleme ekran görüntüsü.

  8. Kaydetseçeneğini seçin.

Pipeline_Deploy işlem hattı için kaynak bağlantıyı yapılandırma

Bu adımlarda işlem hattınızın kaynak bağlantısını yapılandıracaksınız:

  1. Değişkenli Kaynak LH'ler çalışma alanında Pipeline_Deploy gidin.

  2. Tuvalde Verileri kopyala'yı seçerek odağın Verileri kopyalama'ya odaklanmasını sağlayın.

  3. Kaynak'ı seçin.

  4. SourceLH'yi yapılandırma:

    1. Kaynak Bağlantı'nın> altında Dinamik içerik ekle'yi seçin.

    2. Üç noktayı (...) seçin ve ardından **Kitaplık değişkenleri**'ni seçin.

    3. SourceLH'yi seçin. Kutusunu ile @pipeline().libraryVariables.SourceLHdoldurur. Tamam'ı seçin.

      Bağlantı kaynağı için dinamik içerik ekleme bölmesinin ekran görüntüsü.

  5. SourceWSID'yi yapılandırma:

    1. Kaynak>Çalışma Alanı Kimliği'nin altında Dinamik içerik ekle'yi seçin.

    2. Üç noktayı (...) seçin ve ardından **Kitaplık değişkenleri**'ni seçin.

    3. SourceWSID'yi seçin. Kutusunu ile @pipeline().libraryVariables.SourceWSIDdoldurur. Tamam'ı seçin.

      Çalışma alanı kaynağı için dinamik içerik ekleme bölmesinin ekran görüntüsü.

  6. SourceTableName'i yapılandırma:

    1. Kaynak>Tablo altında El ile gir'i seçin, Tablo adı'nı ve ardından Dinamik içerik ekle'yi seçin.

    2. Üç noktayı (...) seçin ve ardından **Kitaplık değişkenleri**'ni seçin.

    3. SourceTableName öğesini seçin. Kutusunu ile @pipeline().libraryVariables.SourceTableNamedoldurur. Tamam'ı seçin.

      Tablo adı için dinamik içerik ekleme bölmesinin ekran görüntüsü.

  7. Artık kaynak bağlantı ayarlandıysa, bunu test edebilirsiniz. Verileri önizleme'yi ve ardından açılır öğede Tamam'ı seçin. Veriler dolduruldıktan sonra veri önizlemesini kapatabilirsiniz.

    Kaynak bağlantı için veri önizlemesinin ekran görüntüsü.

Pipeline_Deploy işlem hattı için hedef bağlantıyı yapılandırma

Bu adımlarda, işlem hattınızın hedef bağlantısını yapılandıracaksınız:

  1. Değişkenli Kaynak LH'ler çalışma alanında Pipeline_Deploy gidin.

  2. Tuvalde Verileri kopyala'yı seçerek odağın Verileri kopyalama'ya odaklanmasını sağlayın.

  3. Hedef'i seçin.

  4. SourceLH'yi yapılandırma:

    1. Hedef Bağlantı'nın> altında Dinamik içerik ekle'yi seçin.

    2. Üç noktayı (...) seçin ve ardından **Kitaplık değişkenleri**'ni seçin.

    3. SourceLH'yi seçin. Kutusunu ile @pipeline().libraryVariables.DestinationLHdoldurur. Tamam'ı seçin.

      Bağlantı hedefi için dinamik içerik ekleme bölmesinin ekran görüntüsü.

  5. DestinationWSID'yi yapılandırma:

    1. Hedef> altında Dinamik içerik ekle'yi seçin.

    2. Üç noktayı (...) seçin ve ardından **Kitaplık değişkenleri**'ni seçin.

    3. DestinationWSID'yi seçin. Kutusunu ile @pipeline().libraryVariables.DestinationWSIDdoldurur. Tamam'ı seçin.

      Çalışma alanı hedefi için dinamik içerik ekleme bölmesinin ekran görüntüsü.

  6. DestinationTableName'i yapılandırma:

    1. Hedef>Tablo altında El ile gir'i seçin, Tablo adı'nı ve ardından Dinamik içerik ekle'yi seçin.

    2. Üç noktayı (...) seçin ve ardından **Kitaplık değişkenleri**'ni seçin.

    3. DestinationTableName öğesini seçin. Kutusunu ile @pipeline().libraryVariables.DestinationTableNamedoldurur. Tamam'ı seçin.

      Hedef tablo adı için dinamik içerik ekleme bölmesinin ekran görüntüsü.

  7. Hedef bağlantı ayarlandıysa işlem hattını kaydedin ve Çalıştır'ı seçin. Başarıyla çalıştığını onaylayın.

    İşlem hattı çalıştırmasının ekran görüntüsü.

Dağıtım işlem hattını oluşturma

Şimdi dağıtım işlem hattınızı oluşturun:

  1. Değişkenli Kaynak LH'ler çalışma alanında Dağıtım işlem hattı oluştur'u seçin.

  2. İşlem hattını Deployment_Pipeline_Var adlandırın ve İleri'yi seçin.

    Yeni dağıtım işlem hattını adlandırma bölmesinin ekran görüntüsü.

  3. Dağıtım işlem hattında Oluştur ve devam et'i seçin.

    Dağıtım işlem hattı oluşturma düğmesini gösteren ekran görüntüsü.

  4. Geliştirme aşaması için:

    1. Açılan listede çalışma alanı için Değişkenli Kaynak LH'ler'i seçin. Ardından Ata onay işaretini seçin.

      Yeni dağıtım işlem hattı için çalışma alanını seçme işleminin ekran görüntüsü.

    2. Devamtuşuna basın. Aşama artık çalışma alanından öğelerle doldurulmalıdır.

      Dağıtım işlem hattının geliştirme bölümünün ekran görüntüsü.

  5. Test aşaması için:

    1. Tüm öğeleri seçmek için üstteki onay kutusunu seçin. Ardından SourceLH_Dev lakehouse onay kutusunu temizleyin.

    2. Dağıt düğmesini seçin. Yeniden Dağıt'ı seçin. Test aşaması artık doldurulmalıdır.

      Yeni dağıtım işlem hattının test bölümünün ekran görüntüsü.

  6. Üretim aşaması için:

    1. Tüm öğeleri seçmek için üstteki onay kutusunu seçin. Ardından SourceLH_Test lakehouse onay kutusunu temizleyin.

    2. Dağıt düğmesini seçin. Yeniden Dağıt'ı seçin. Üretim aşaması artık doldurulmalıdır.

      Yeni dağıtım işlem hattının üretim bölümünün ekran görüntüsü.

Her aşama için değişken kitaplığının etkin kümesini ayarlama

Bu adımlarda, dağıtım işlem hattınızdaki her aşama için etkin kümeyi yapılandıracaksınız:

  1. Test aşaması için etkin kümeyi yapılandırın:

    1. Kenar çubuğunda Deployment_Pipeline_Var işlem hattını seçin.

    2. Test aşamasını seçin.

      Test aşamasının ekran görüntüsü.

    3. WS Değişkenleri'ni seçin.

    4. Üç noktayı (...) ve ardından Etkin olarak ayarla'yı seçin. Etkin Olarak Ayarla düğmesini seçin.

      Test aşamasını etkin olarak ayarlama seçimleri içeren değişken kitaplığının ekran görüntüsü.

      Etkin küme artık yapılandırıldı.

      Dağıtım işlem hattında yapılandırılmış bir etkin kümenin ekran görüntüsü.

    5. Kabul Et'i> seçin.

  2. Prod aşaması için etkin kümeyi yapılandırın:

    1. Kenar çubuğunda Deployment_Pipeline_Var işlem hattını seçin.

    2. Üretim aşamasını seçin.

    3. WS Değişkenleri'ni seçin.

    4. Üç noktayı (...) ve ardından Etkin olarak ayarla'yı seçin. Etkin Olarak Ayarla düğmesini seçin.

    5. Kabul Et'i> seçin.

Değişken kitaplığını doğrulama ve test edin

Değişken kitaplığını ayarladığınıza ve dağıtım işlem hattının her aşaması için tüm etkin kümeleri yapılandırdığınıza göre, bunları doğrulayabilirsiniz:

  1. SourceLHs_Dev göle bakın:

    1. Değişkenli Kaynak LH'ler çalışma alanında SourceLHs_Dev lakehouse'unu seçin.

    2. Lakehouse'danSQL analiz uç noktasına bağlantıyı değiştirin.

    3. Gezginde Şemalar>dbo>Tabloları'nı genişletin.

    4. DevCopiedData tablosunun göründüğünü onaylayın.

      Gezgindeki tabloların alanının ekran görüntüsü.

  2. SourceLHs_Test lakehouse'a geçin ve önceki adımları yineleyin.

    İşlem hattını test VS etkin kümesiyle henüz çalıştırmadığınızdan TestCopiedData tablosu görüntülenmemelidir.

  3. SourceLHs_Prod lakehouse'a geçin ve önceki adımları yineleyin.

    ProdCopiedData tablosu, prod VS etkin kümesiyle işlem hattını henüz çalıştırmadığınızdan görüntülenmemelidir.

  4. Deployment_Pipeline_Var işlem hattının Test aşamasını denetleyin:

    1. Deployment_Pipeline_Var işlem hattına geçin ve Test aşamasını seçin.

    2. Pipeline_Deploy işlem hattını seçin.

    3. Çalıştırseçin. Bu işlem başarıyla tamamlanmalıdır.

  5. SourceLHs_Test lakehouse'a yeniden bakın:

    1. SourceLHs_Test lakehouse'a geç.

    2. Lakehouse'danSQL analiz uç noktasına bağlantıyı değiştirin.

    3. Gezginde Şemalar>dbo>Tabloları'nı genişletin.

    4. TestCopiedData tablosunun göründüğünü onaylayın.

      Tablo alanının ve gezgindeki veri önizlemesinin ekran görüntüsü.

  6. Deployment_Pipeline_Var işlem hattının Üretim aşamasını denetleyin:

    1. Deployment_Pipeline_Var işlem hattına geçin ve Üretim aşamasını seçin.

    2. Pipeline_Deploy işlem hattını seçin.

    3. Çalıştırseçin. Bu işlem başarıyla tamamlanmalıdır.

  7. SourceLHs_Prod lakehouse'a yeniden bakın:

    1. SourceLHs_Prod lakehouse'a geç.

    2. Lakehouse'danSQL analiz uç noktasına bağlantıyı değiştirin.

    3. Gezginde Şemalar>dbo>Tabloları'nı genişletin.

    4. ProdCopiedData tablosunun göründüğünü onaylayın.

Git'te değişken değerlerini özelleştirme (isteğe bağlı)

Değişken kitaplığının Git'te nasıl temsil olduğunu görmek veya git deposundaki değişkenleri düzenlemek için:

  1. Çalışma alanında Kaynak denetimi'ni seçin ve çalışma alanını bir Git deposuna bağlayın.

  2. Çalışma alanı içeriğini Git deposuna göndermek için Kaynak denetimi bölmesinde İşle'yi seçin.

    Git deposunda çalışma alanı içindeki her öğe için bir klasör bulunur. WS değişkenleri adlı bir klasör. VariableLibrary, değişken kitaplık öğesini temsil eder. Bu klasörün içeriği hakkında daha fazla bilgi için bkz. Değişken kitaplığı CI/CD.

  3. valueSets klasöründeki ProdVS.json ve TestVS.json dosyalarını karşılaştırın. Değişkenin overrides farklı değerlere ayarlandığını onaylayın. Bu değerleri doğrudan kullanıcı arabiriminde veya Git'te bu dosyayı düzenleyip çalışma alanına güncelleştirerek düzenleyebilirsiniz.

    {
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Test VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "4fe228d3-a363-4b7f-a5d4-fae9d2abca43"
  },
  {
   "name": "DestinationTableName",
   "value": "TestCopiedData"
  }
 ]
}

    {
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Prod VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "c0f13027-9bf4-4e8c-8f57-ec5c18c8656b"
  },
  {
   "name": "DestinationTableName",
   "value": "ProdCopiedData"
  }
 ]
}

İlgili içerik

  • Last updated on