Bagikan melalui

Membuat item fungsi data pengguna Fabric

Dalam panduan ini, kita akan membuat item Fungsi Data Pengguna baru dan menulis fungsi baru di dalamnya. Setiap item Fungsi Data Pengguna berisi kode yang menentukan satu atau banyak fungsi yang dapat Anda jalankan satu per satu.

Secara khusus, Anda mempelajari cara:

  • Buat item untuk fungsi data pengguna.
  • Tulis fungsi baru.
  • Mengelola fungsi.
  • Jalankan fungsi Anda.

Prasyarat

Membuat item Fabric User Data Functions baru

  1. Pilih ruang kerja Anda, dan pilih + Item baru.
  2. Pilih jenis item sebagai Semua item. Cari dan pilih Fungsi untuk data pengguna.

Membuat item fungsi data pengguna baru

  1. Di ruang kerja Anda, pilih + Item Baru.

  2. Di panel yang terbuka, cari user data functions, lalu pilih petak peta.

    Cuplikan layar memperlihatkan petak fungsi data pengguna di panel item baru.

  3. Berikan Nama untuk item fungsi data pengguna.

  4. Pilih Fungsi baru untuk membuat template fungsi Python hello_fabric. Penjelajah Functions memperlihatkan semua fungsi yang diterbitkan dan siap untuk dipanggil.

    Cuplikan layar memperlihatkan cara membuat fungsi baru menggunakan templat.

  5. Setelah fungsi hello_fabric diterbitkan, Anda dapat menjalankannya dari daftar fungsi di penjelajah Fungsi.

    Cuplikan layar memperlihatkan kode untuk fungsi hello-fabric.

Menambahkan fungsi baru dari sampel

Berikut adalah contoh cara menambahkan fungsi baru dari menu Insert sample. Dalam hal ini, kita akan menambahkan fungsi yang disebut Memanipulasi data dengan pustaka pandas yang menggunakan pustaka pandas sebagai persyaratan. Ikuti langkah-langkah untuk menambahkan fungsi sampel ini:

  1. Pastikan Anda berada dalam mode Kembangkan. Pilih manajemen pustaka untuk menambahkan pustaka yang diperlukan oleh fungsi Anda.

    Cuplikan layar memperlihatkan cara mengelola pustaka.

    Nota

    fabric_user_data_functions pustaka ditambahkan secara otomatis dan tidak dapat dihapus. Pustaka ini diperlukan untuk fungsionalitas fungsi data Pengguna. Anda perlu memperbarui versi pustaka ini untuk setiap rilis SDK ini di masa mendatang.

  2. Pilih pustaka pandas dan pilih versinya. Setelah pustaka ditambahkan, pustaka secara otomatis disimpan di item Fungsi Data Pengguna Anda.

    Cuplikan layar memperlihatkan cara menambahkan pustaka panda.

  3. Pilih Sisipkan sampel dan pilih Manipulasi data dengan pustaka pandas. Tindakan ini akan menyisipkan kode sampel di bagian bawah kode Anda, setelah fungsi lainnya.

    Cuplikan layar memperlihatkan cara menyisipkan sampel yang menggunakan pustaka panda.

  4. Setelah sampel disisipkan ke editor, Anda mengujinya dengan menggunakan kemampuan Uji dalam mode Kembangkan.

  5. Setelah siap, Anda dapat memilih Terbitkan untuk menyimpan perubahan dan memperbarui fungsi Anda. Penerbitan mungkin memakan waktu beberapa menit.

    Cuplikan layar memperlihatkan cuplikan kode sampel di editor.

  6. Setelah penerbitan selesai, Anda akan melihat fungsi baru di daftar penjelajah Functions. Fungsi ini sekarang siap dijalankan dari portal, atau dipanggil dari aplikasi lain atau item Fabric, seperti alur.

    Cuplikan layar memperlihatkan cuplikan kode sampel di editor.

Jalankan fungsi Anda

  1. Untuk menjalankan fungsi Anda, pertama-tama Anda perlu beralih ke mode Jalankan saja dengan mengklik pengalih mode.

    Cuplikan layar animasi memperlihatkan cara beralih ke Mode jalankan saja.

  2. Pilih ikon Jalankan yang muncul saat Anda mengarahkan mouse ke atas fungsi di daftar penjelajah fungsi.

    Cuplikan layar memperlihatkan cara menjalankan fungsi.

  3. Berikan parameter yang diperlukan yang disajikan sebagai formulir di penjelajah Fungsi. Dalam hal ini, kita akan menjalankan fungsi manipulate_data yang memerlukan string JSON sebagai parameter.

    [
 {
  "Name": "John",
  "Age": 22,
  "Gender": "male"
 }
]

  4. Pilih Jalankan untuk menjalankan fungsi.

    Cuplikan layar memperlihatkan output saat fungsi berhasil dijalankan.

  5. Anda dapat melihat log langsung dan output untuk fungsi guna memvalidasi apakah berhasil dijalankan. Atau, Anda akan melihat pesan kesalahan dan log dari pemanggilan fungsi Anda.

Menulis fungsi baru

Setiap fungsi yang dapat dijalankan dimulai dengan dekorator @udf.function() sebelum definisi fungsi. Baca lebih lanjut tentang model Pemrograman Python kami. Untuk menulis fungsi baru, gunakan dekorator @udf.function() di awal untuk mendeklarasikannya sebagai fungsi yang dapat dijalankan. Berikut adalah contoh fungsi:

# This sample allows you to pass a credit card number as an integer and mask it, leaving the last 4 digits. 

@udf.function()
def maskCreditCard(cardNumber: int)-> str:
    # Convert the card number to a string
    cardNumberStr = str(cardNumber)
    
    # Check if the card number is valid
    if not cardNumberStr.isdigit() or not (13 <= len(cardNumberStr) <= 19):
        raise ValueError("Invalid credit card number")
    
    # Mask all but the last four digits
    maskedNumber = '*' * (len(cardNumberStr) - 4) + cardNumberStr[-4:]
    
    return str(maskedNumber)

Setelah fungsi siap, terbitkan fungsi untuk menjalankannya.

Konsep kunci model pemrograman

Fungsi Data Pengguna Anda menggunakan model Pemrograman Python untuk Fungsi Data Pengguna untuk membuat, menjalankan, men-debug, dan memodifikasi fungsi secara individual. Ini adalah pustaka pihak pertama yang menyediakan fungsionalitas yang diperlukan untuk memanggil fungsi Anda di Fabric dan memanfaatkan semua integrasi.

Setelah membuat fungsi pertama Anda, baris pertama kode akan berisi pernyataan impor dengan pustaka yang diperlukan untuk menjalankan templat Anda.

import datetime
import fabric.functions as fn
import logging

udf = fn.UserDataFunctions()

Nota

Pernyataan impor yang berisi pustaka fabric.functions, dan baris yang berisi pernyataan ini udf = fn.UserDataFunctions() diperlukan untuk menjalankan fungsi Anda dengan benar. Fungsi Anda tidak akan berfungsi dengan baik jika baris-baris ini hilang.

  • Untuk membuat, menjalankan, mengelola fungsi, Anda memerlukan fabric.functions SDK dan beberapa pustaka penting lainnya seperti logging memungkinkan Anda menulis log kustom.
  • udf=fn.UserDataFunctions() adalah konstruksi untuk mendefinisikan fungsi di dalam item fungsi data pengguna.

Mengelola fungsi data

Mengganti nama fungsi

  1. Dalam mode Kembangkan, pilih editor kode dan perbarui nama fungsi. Misalnya, ganti nama hello_fabric menjadi hello_fabric1:

    @udf.function()
def hello_fabric1(name: str) -> str:
   logging.info('Python UDF trigger function processed a request.')

   return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"

  2. Setelah mengubah nama, pilih Terbitkan untuk menyimpan perubahan-perubahan ini.

  3. Setelah perubahan diterbitkan, Anda dapat melihat nama baru untuk fungsi di penjelajah Functions.

Menghapus fungsi

Untuk menghapus fungsi, pilih kode fungsi di editor kode dan hapus seluruh bagian kode. Terbitkan perubahan untuk menghapusnya sepenuhnya dari item fungsi data pengguna.

Misalnya, untuk menghapus fungsi hello_fabric, hapus blok kode berikut:

@udf.function()
def hello_fabric(name: str) -> str:
    logging.info('Python UDF trigger function processed a request.')

    return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"

Setelah kode dihapus, Anda dapat memilih Terbitkan untuk menyimpan perubahan Anda. Setelah penerbitan selesai, Anda akan melihat daftar fungsi yang tersedia yang diperbarui di penjelajah Functions.

Langkah berikutnya

  • Last updated on