Bagikan melalui

Tutorial: Menggunakan pustaka variabel untuk menyesuaikan dan berbagi konfigurasi item

Tutorial ini menunjukkan kepada Anda cara menggunakan konten dinamis dalam alur Microsoft Fabric. Saat Anda membuat item pustaka variabel dan menambahkan variabel ke dalamnya, Anda dapat mengotomatiskan nilai untuk berbagai tahap alur penyebaran Anda. Dalam tutorial ini, Anda menyalin data dari satu lakehouse ke lakehouse lainnya. Kemudian Anda menggunakan pustaka variabel untuk mengatur nilai sumber dan tujuan untuk aktivitas salin.

Di tutorial ini, Anda akan:

  • Buat pustaka variabel.
  • Tambahkan variabel ke pustaka.
  • Tentukan set nilai tambahan untuk variabel.
  • Gunakan variabel dalam item lain di ruang kerja (alur).
  • Edit variabel dalam repositori Git.
  • Buat alur penyebaran dan sebarkan pustaka variabel.
  • Ubah nilai aktif yang ditetapkan dalam tahap target alur penyebaran.
  • Menunjukkan bahwa nilai variabel sesuai dengan nilai aktif yang ditetapkan di setiap tahap.

Diagram berikut menunjukkan tata letak ruang kerja untuk tutorial ini.

Diagram tata letak ruang kerja.

Prasyarat

Membuat ruang kerja Stage LHs, SourceLH_Stage lakehouse dengan data sampel, dan alur Pipeline_Stage

Pertama, buat ruang kerja dan lakehouse untuk digunakan sebagai data penahapan awal Anda:

  1. Buka Power BI.

  2. Di bar samping, pilih Ruang Kerja.

  3. Membuat ruang kerja. Sebut saja Stage LHs.

    Cuplikan layar tombol untuk membuat ruang kerja baru.

  4. Buat lakehouse:

    1. Di bagian atas ruang kerja, pilih Item baru.

    2. Di bawah Simpan data, pilih Lakehouse.

      Cuplikan layar petak peta untuk memilih lakehouse sebagai item baru.

    3. Masukkan nama SourceLH_Stage, lalu pilih Buat.

  5. Buat alur:

    1. Di lakehouse, pilih Alur baru.

      Cuplikan layar petak peta untuk membuat alur baru.

    2. Masukkan nama Pipeline_Stage, lalu pilih Buat.

    3. Di wizard Salin data ke Lakehouse , pada halaman Pilih sumber data , pilih Contoh data.

      Cuplikan layar halaman untuk memilih sumber data untuk menyalin data ke lakehouse.

    4. Pilih Hari Libur Nasional.

      Cuplikan layar memilih data sampel Hari Libur Umum.

    5. Setelah data sampel selesai dimuat, pilih Berikutnya.

    6. Pada halaman Sambungkan ke tujuan data , pilih Berikutnya.

      Cuplikan layar detail untuk tujuan alur.

    7. Pada halaman Tinjau + simpan , pilih Simpan + Jalankan.

      Cuplikan layar halaman untuk menyimpan dan menjalankan alur.

Membuat LH Sumber dengan ruang kerja Variabel

Sekarang, buat ruang kerja yang akan Anda kerjakan dan gunakan dengan pustaka variabel Anda:

  1. Buka Power BI.

  2. Di bar samping, pilih Ruang Kerja.

  3. Membuat ruang kerja. Sebut saja LH Sumber dengan Variabel.

Buat lakehouse SourceLH_Dev, SourceLH_Test, dan SourceLH_Prod

Selanjutnya, buat tiga lakehouse untuk digunakan dengan pustaka variabel:

  1. Buat lakehouse pertama:

    1. Di bar samping, pilih LH Sumber dengan ruang kerja Variabel.

    2. Pilih Item baru.

    3. Di bawah Simpan data, pilih Lakehouse.

    4. Masukkan nama SourceLH_Dev, lalu pilih Buat.

  2. Buat lakehouse kedua dengan mengikuti langkah-langkah sebelumnya. Beri nama SourceLH_Test.

  3. Buat lakehouse ketiga dengan mengikuti langkah-langkah sebelumnya. Beri nama SourceLH_Prod.

  4. Di bar samping, pilih LH Sumber dengan ruang kerja Variabel dan pastikan bahwa ruang kerja berisi semua lakehouse yang baru dibuat.

Mendapatkan ID ruang kerja dan ID objek untuk lakehouse

Dalam langkah-langkah ini, Anda mendapatkan pengidentifikasi unik untuk digunakan di pustaka variabel Anda:

  1. Di Power BI, pada bar samping, pilih ruang kerja Stage LHs .

  2. Di ruang kerja, pilih SourceLH_Stage lakehouse.

  3. Salin ID ruang kerja dan ID objek lakehouse di URL.

    Cuplikan layar yang memperlihatkan cara mendapatkan pengidentifikasi ruang kerja dan pengidentifikasi objek lakehouse.

  4. Ulangi langkah-langkah sebelumnya untuk SourceLH_Dev dan SourceLH_Test lakehouse di LH Sumber dengan ruang kerja Variabel.

Membuat pustaka variabel dengan variabel

Sekarang, buat pustaka variabel:

  1. Di LH Sumber dengan ruang kerja Variabel, pilih Item baru.

  2. Di bawah Kembangkan data, pilih **Pustaka variabel **.

    Cuplikan layar yang memperlihatkan petak peta untuk membuat pustaka variabel.

  3. Beri nama pustaka variabel WS, lalu pilih Buat.

  4. Pilih Variabel baru.

    Cuplikan layar yang memperlihatkan tombol untuk memilih variabel baru.

  5. Buat variabel berikut:

    Nama Tipe Nilai default diatur
    Source_LH string <GUID dari SourceLH_Stage lakehouse>
    Source_WSID string <GUID ruang kerja SourceLH_Stage>
    Destination_LH string <GUID dari SourceLH_Dev lakehouse>
    Destination_WSID string <GUID ruang kerja SourceLH_Dev>
    SourceTable_Name string Processed
    DestinationTable_Name string DevCopiedData

    Cuplikan layar set default yang sudah selesai untuk pustaka variabel.

  6. Pilih Simpan.

Membuat set nilai alternatif

Dalam langkah-langkah ini, Anda menambahkan set nilai alternatif ke pustaka variabel Anda:

  1. Buat set nilai pertama:

    1. Di pustaka variabel Variabel WS , pilih Tambahkan kumpulan nilai.

    2. Masukkan Uji VS untuk nama tersebut, lalu pilih Buat.

    3. Buat variabel berikut:

      Nama Tipe Nilai default diatur
      Source_LH string <GUID dari SourceLH_Dev lakehouse>
      Source_WSID string <GUID ruang kerja SourceLH_Dev>
      Destination_LH string <GUID dari SourceLH_Test lakehouse>
      Destination_WSID string <GUID ruang kerja SourceLH_Test>
      SourceTable_Name string DevCopiedData
      DestinationTable_Name string TestCopiedData

    4. Pilih Simpan>Setuju.

  2. Buat set nilai kedua:

    1. Pilih Tambahkan kumpulan nilai.

    2. Masukkan Prod VS untuk nama tersebut, lalu pilih Buat.

    3. Buat variabel berikut:

      Nama Tipe Nilai default diatur
      Source_LH string <GUID dari SourceLH_Test lakehouse>
      Source_WSID string <GUID ruang kerja SourceLH_Test>
      Destination_LH string <GUID dari SourceLH_Prod lakehouse>
      Destination_WSID string <GUID ruang kerja SourceLH_Prod>
      SourceTable_Name string TestCopiedData
      DestinationTable_Name string ProdCopiedData

      Cuplikan layar nilai alternatif yang sudah selesai dalam pustaka variabel.

    4. Pilih Simpan>Setuju.

Membuat alur Pipeline_Deploy dan mendeklarasikan variabel

Dalam langkah-langkah ini, Anda membuat alur dan mendeklarasikan variabel Anda:

  1. Di LH Sumber dengan ruang kerja Variabel, pilih Item baru.

  2. Di bawah Dapatkan data, pilih Alur.

    Cuplikan layar petak peta untuk alur.

  3. Masukkan nama Pipeline_Deploy, lalu pilih Buat.

  4. Pilih Salin data>Tambahkan ke kanvas.

    Cuplikan layar pilihan menu untuk menambahkan salin data ke kanvas.

  5. Pilih kanvas sehingga fokus tidak aktif Salin data.

  6. Pilih **Variabel pustaka **.

    Cuplikan layar tab untuk variabel pustaka.

  7. Pilih Baru, lalu tambahkan variabel berikut:

    Nama Perpustakaan Nama variabel Tipe
    SourceLH Variabel WS Source_LH string
    SourceWSID Variabel WS Source_WSID string
    DestinationLH Variabel WS Destination_LH string
    DestinationWSID Variabel WS Destination_WSID string
    SourceTableName Variabel WS SourceTable_Name string
    DestinationTableName Variabel WS DestinationTable_Name string

    Cuplikan layar menambahkan variabel ke alur.

  8. Pilih Simpan.

Mengonfigurasi koneksi sumber untuk alur Pipeline_Deploy

Dalam langkah-langkah ini, Anda mengonfigurasi koneksi sumber untuk alur Anda:

  1. Di LH Sumber dengan ruang kerja Variabel, buka Pipeline_Deploy.

  2. Pada kanvas, pilih Salin data sehingga fokusnya adalah pada Salin data.

  3. Pilih Sumber.

  4. Konfigurasikan SourceLH:

    1. Di bawahKoneksi>, pilih Tambahkan konten dinamis.

    2. Pilih elipsis (...), lalu pilih **Variabel pustaka **.

    3. Pilih SourceLH. Ini mengisi kotak dengan @pipeline().libraryVariables.SourceLH. Pilih OK.

      Cuplikan layar panel untuk menambahkan konten dinamis untuk sumber koneksi.

  5. Mengonfigurasi SourceWSID:

    1. Di bawahID Ruang Kerja>, pilih Tambahkan konten dinamis.

    2. Pilih elipsis (...), lalu pilih **Variabel pustaka **.

    3. Pilih SourceWSID. Ini mengisi kotak dengan @pipeline().libraryVariables.SourceWSID. Pilih OK.

      Cuplikan layar panel untuk menambahkan konten dinamis untuk sumber ruang kerja.

  6. Konfigurasikan SourceTableName:

    1. Di bawahTabel>, pilih Masukkan secara manual, pilih Nama tabel, lalu pilih Tambahkan konten dinamis.

    2. Pilih elipsis (...), lalu pilih **Variabel pustaka **.

    3. Pilih SourceTableName. Ini mengisi kotak dengan @pipeline().libraryVariables.SourceTableName. Pilih OK.

      Cuplikan layar panel untuk menambahkan konten dinamis untuk nama tabel.

  7. Setelah koneksi sumber disiapkan, Anda dapat mengujinya. Pilih Pratinjau data, lalu pilih OK pada flyout. Setelah data diisi, Anda dapat menutup pratinjau data.

    Cuplikan layar pratinjau data untuk koneksi sumber.

Mengonfigurasi koneksi tujuan untuk alur Pipeline_Deploy

Dalam langkah-langkah ini, Anda mengonfigurasi koneksi tujuan untuk alur Anda:

  1. Di LH Sumber dengan ruang kerja Variabel, buka Pipeline_Deploy.

  2. Pada kanvas, pilih Salin data sehingga fokusnya adalah pada Salin data.

  3. Pilih Tujuan.

  4. Konfigurasikan SourceLH:

    1. Di bawahKoneksi>, pilih Tambahkan konten dinamis.

    2. Pilih elipsis (...), lalu pilih **Variabel pustaka **.

    3. Pilih SourceLH. Ini mengisi kotak dengan @pipeline().libraryVariables.DestinationLH. Pilih OK.

      Cuplikan layar panel untuk menambahkan konten dinamis untuk tujuan koneksi.

  5. Konfigurasikan DestinationWSID:

    1. Di bawahID Ruang Kerja>, pilih Tambahkan konten dinamis.

    2. Pilih elipsis (...), lalu pilih **Variabel pustaka **.

    3. Pilih DestinationWSID. Ini mengisi kotak dengan @pipeline().libraryVariables.DestinationWSID. Pilih OK.

      Cuplikan layar panel untuk menambahkan konten dinamis untuk tujuan ruang kerja.

  6. Mengonfigurasi DestinationTableName:

    1. Di bawahTabel>, pilih Masukkan secara manual, pilih Nama tabel, lalu pilih Tambahkan konten dinamis.

    2. Pilih elipsis (...), lalu pilih **Variabel pustaka **.

    3. Pilih DestinationTableName. Ini mengisi kotak dengan @pipeline().libraryVariables.DestinationTableName. Pilih OK.

      Cuplikan layar panel untuk menambahkan konten dinamis untuk nama tabel tujuan.

  7. Sekarang setelah koneksi tujuan disiapkan, simpan alur dan pilih Jalankan. Konfirmasikan bahwa berhasil dijalankan.

    Cuplikan layar eksekusi alur.

Membuat alur penyebaran

Sekarang, buat alur penyebaran Anda:

  1. Di LH Sumber dengan ruang kerja Variabel, pilih Buat alur penyebaran.

  2. Beri nama alur Deployment_Pipeline_Var, lalu pilih Berikutnya.

    Cuplikan layar panel untuk penamaan alur penyebaran baru.

  3. Di alur penyebaran, pilih Buat dan lanjutkan.

    Cuplikan layar yang memperlihatkan tombol untuk membuat alur penyebaran.

  4. Untuk tahap Pengembangan :

    1. Di daftar dropdown, pilih LH Sumber dengan Variabel untuk ruang kerja. Lalu pilih tanda centang Tetapkan .

      Cuplikan layar memilih ruang kerja untuk alur penyebaran baru.

    2. Pilih Lanjutkan. Tahap sekarang harus diisi dengan item dari ruang kerja.

      Cuplikan layar bagian pengembangan dari alur penyebaran.

  5. Untuk tahap Uji :

    1. Pilih kotak centang di bagian atas untuk memilih semua item. Kemudian kosongkan kotak centang untuk SourceLH_Dev lakehouse.

    2. Pilih tombol Sebarkan . Pilih Sebarkan lagi. Tahap Uji sekarang harus diisi.

      Cuplikan layar bagian pengujian dari alur penyebaran baru.

  6. Untuk tahap Produksi :

    1. Pilih kotak centang di bagian atas untuk memilih semua item. Kemudian kosongkan kotak centang untuk lakehouse SourceLH_Test .

    2. Pilih tombol Sebarkan . Pilih Sebarkan lagi. Tahap Produksi sekarang harus diisi.

      Cuplikan layar bagian produksi dari alur penyebaran baru.

Atur kumpulan aktif pustaka variabel untuk setiap tahap

Dalam langkah-langkah ini, Anda mengonfigurasi set aktif untuk setiap tahap dalam alur penyebaran Anda:

  1. Konfigurasikan set aktif untuk tahap Uji :

    1. Di bar samping, pilih alur Deployment_Pipeline_Var .

    2. Pilih tahap Uji .

      Cuplikan layar tahap pengujian.

    3. Pilih Variabel WS.

    4. Pilih elipsis (...), lalu pilih Atur sebagai aktif. Pilih tombol Atur sebagai Aktif .

      Cuplikan layar pustaka variabel, dengan pilihan untuk mengatur tahap pengujian sebagai aktif.

      Set aktif sekarang dikonfigurasi.

      Cuplikan layar kumpulan aktif yang dikonfigurasi dalam alur penyebaran.

    5. Pilih Simpan>Setuju.

  2. Konfigurasikan set aktif untuk tahap Prod :

    1. Di bar samping, pilih alur Deployment_Pipeline_Var .

    2. Pilih tahap Prod .

    3. Pilih Variabel WS.

    4. Pilih elipsis (...), lalu pilih Atur sebagai aktif. Pilih tombol Atur sebagai Aktif .

    5. Pilih Simpan>Setuju.

Memverifikasi dan menguji pustaka variabel

Sekarang setelah Anda menyiapkan pustaka variabel dan mengonfigurasi semua set aktif untuk setiap tahap alur penyebaran, Anda dapat memverifikasinya:

  1. Periksa lakehouse SourceLHs_Dev :

    1. Di LH Sumber dengan ruang kerja Variabel, pilih lakehouse SourceLHs_Dev .

    2. Ubah koneksi dari Lakehouse ke titik akhir analitik SQL.

    3. Di penjelajah, perluasTabel>>.

    4. Konfirmasikan bahwa tabel DevCopiedData muncul.

      Cuplikan layar area untuk tabel di penjelajah.

  2. Beralih ke lakehouse SourceLHs_Test dan ulangi langkah-langkah sebelumnya.

    Tabel TestCopiedData seharusnya tidak muncul karena Anda belum menjalankan alur dengan set aktif Test VS .

  3. Beralih ke lakehouse SourceLHs_Prod dan ulangi langkah-langkah sebelumnya.

    Tabel ProdCopiedData seharusnya tidak muncul karena Anda belum menjalankan alur dengan set aktif Prod VS .

  4. Periksa tahap Uji alur Deployment_Pipeline_Var :

    1. Beralih ke alur Deployment_Pipeline_Var dan pilih tahap Uji .

    2. Pilih alur Pipeline_Deploy .

    3. Pilih Jalankan. Proses ini harus berhasil diselesaikan.

  5. Periksa lakehouse SourceLHs_Test lagi:

    1. Beralih ke lakehouse SourceLHs_Test .

    2. Ubah koneksi dari Lakehouse ke titik akhir analitik SQL.

    3. Di penjelajah, perluasTabel>>.

    4. Konfirmasikan bahwa tabel TestCopiedData muncul.

      Cuplikan layar area untuk tabel dan pratinjau data di penjelajah.

  6. Periksa tahap Produksi alur Deployment_Pipeline_Var :

    1. Beralih ke alur Deployment_Pipeline_Var dan pilih tahap Produksi .

    2. Pilih alur Pipeline_Deploy .

    3. Pilih Jalankan. Proses ini harus berhasil diselesaikan.

  7. Periksa lakehouse SourceLHs_Prod lagi:

    1. Beralih ke lakehouse SourceLHs_Prod .

    2. Ubah koneksi dari Lakehouse ke titik akhir analitik SQL.

    3. Di penjelajah, perluasTabel>>.

    4. Konfirmasikan bahwa tabel ProdCopiedData muncul.

Mengkustomisasi nilai variabel di Git (opsional)

Untuk melihat bagaimana pustaka variabel diwakili di Git, atau untuk mengedit variabel dari repositori Git:

  1. Di ruang kerja, pilih Kontrol sumber dan sambungkan ruang kerja ke repositori Git.

  2. Pada panel Kontrol sumber , pilih Terapkan untuk mendorong konten ruang kerja ke repositori Git.

    Repositori Git memiliki folder untuk setiap item di ruang kerja. Folder yang disebut variabel WS. VariableLibrary mewakili item pustaka variabel. Untuk informasi selengkapnya tentang konten folder ini, lihat Pustaka variabel CI/CD.

  3. Bandingkan file ProdVS.json dan TestVS.json di folder valueSets . Konfirmasikan bahwa overrides variabel diatur ke nilai yang berbeda. Anda dapat mengedit nilai-nilai ini langsung di UI atau dengan mengedit file ini di Git dan memperbaruinya ke ruang kerja.

    {
 "$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"
  }
 ]
}

Konten terkait

  • Last updated on