Bagikan melalui

Buat item fungsi data pengguna Fabric di Visual Studio Code

Fungsi data Fabric User adalah solusi tanpa server yang memungkinkan Anda mengembangkan aplikasi dengan cepat dan mudah di atas sumber data fabric-native. Keuntungannya adalah peningkatan fleksibilitas dan efektivitas biaya komputasi tanpa server di Fabric. Fungsi data pengguna dipanggil sebagai permintaan HTTP ke titik akhir yang disediakan layanan dan mereka beroperasi pada sumber data fabric-native Anda.

Dalam panduan cepat ini, Anda mempelajari cara membuat item fungsi data pengguna di Visual Studio (VS) Code.

Prasyarat

Pilih ruang kerja Anda

  1. Buka VS Code dan masuk ke Fabric.

  2. Di Fabric, buka ruang kerja Fabric Anda atau buat ruang kerja baru.

  3. Pilih + Item Baru untuk membuka panel Item Baru.

  4. Di panel Item baru, di bawah Kembangkan data, pilih jenis item Fungsi data pengguna.

  5. Berikan nama untuk item fungsi data pengguna baru dan pilih Buat. Elemen fungsi data pengguna yang baru telah dibuat.

  6. Pada pita, pilih Python sebagai bahasa runtime.

  7. Buat lingkungan virtual untuk item fungsi data pengguna ini.

  8. Pilih versi runtime Python. Fungsi data pengguna memerlukan Python Versi 3.11.

  9. Atur lingkungan virtual untuk folder dengan memilih Ya.

  10. Buka function_app.py untuk menambahkan lebih dari satu fungsi.

    Cuplikan layar memperlihatkan item fungsi data pengguna yang dibuka di VS Code.

Menulis fungsi pertama Anda

Tulis item fungsi data pengguna dengan dekorator @udf.function() untuk menentukan awal fungsi. Anda dapat meneruskan input untuk fungsi seperti jenis data primitif seperti str, int, float, dll. Dalam fungsi , Anda dapat menulis logika bisnis kustom Anda.

Berikut adalah contoh hello_fabric fungsi.

@udf.function()
def hello_fabric(name: str) -> str:
    # Use logging to write custom logs to help trace and debug issues 
    logging.info('Python UDF trigger function processed a request.')
    logging.info('Executing hello fabric function.')
    
    return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"

Mengelola fungsi data pengguna di Visual Studio Code

Anda dapat melihat item fungsi data pengguna di penjelajah Fabric di Visual Studio Code pada ruang kerja yang dibuka saat ini.

Cuplikan layar memperlihatkan tampilan penjelajah fabric dan tampilan folder lokal.

Semua fungsi di ruang kerja Fabric dapat dibuka di Explorer pada VS Code untuk mulai mengedit. Pilih fungsi yang ingin Anda buka, lalu pilih Buka di Explorer. Anda dapat melihat koneksi, pustaka, dan semua fungsi yang ditulis dalam item fungsi data pengguna.

Mengelola koneksi dan pustaka

  • Koneksi: Semua koneksi data yang ditambahkan untuk fungsi data pengguna Anda dapat dilihat dari Fabric Explorer. Klik kanan dan pilih Kelola koneksi di Fabric untuk item-item fungsi data pengguna.

  • Pustaka: Semua pustaka yang ditambahkan untuk item fungsi data pengguna Anda dapat dilihat dari Penjelajah Fabric. Klik kanan dan pilih Kelola pustaka di Fabric untuk menambahkan pustaka baru pada item fungsi data pengguna.

  • Fungsi: Anda dapat melihat semua fungsi yang diterbitkan di sini. Pilih fungsi dan lakukan tindakan ini:

    • Jalankan dan uji untuk menguji fungsi di VS Code tanpa perlu menggunakan alat pengujian API.
    • Salin URL Publik jika fungsi ini dapat diakses publik untuk dijalankan dari aplikasi eksternal.

Folder lokal untuk mengelola fungsi data pengguna Anda

Item fungsi data pengguna yang dibuka di penjelajah Visual Studio Code terlihat dalam tampilan Folder lokal. Folder lokal memungkinkan Anda menguji dan melihat perubahan lokal yang dilakukan pada item fungsi data pengguna.

  • Functions: Anda dapat melihat semua fungsi yang ada dalam file lokal function_app.py Anda. Untuk memulai dengan contoh, klik kanan pada Fungsi dan pilih Tambahkan fungsi untuk menambahkan fungsi contoh.

    Cuplikan layar yang memperlihatkan cara menambahkan fungsi baru ke dalam item fungsi dari data pengguna untuk pengembangan lokal.

    Untuk menguji fungsi Anda secara lokal, tekan F5 untuk memulai debugging. Anda juga dapat memilih item fungsi tertentu dan memilih Jalankan dan debug.

  • Menampilkan koneksi dan pustaka untuk fungsi lokal: Anda dapat melihat semua koneksi yang ada di local.settings.json dan pustaka dalam requirements.txt file di lingkungan lokal Anda.

    • Sinkronkan koneksi dari *local.settings* untuk menunjukkan daftar koneksi di lingkungan lokal Anda.
    • Sinkronkan requirements.txt untuk menampilkan daftar pustaka saat ini di lingkungan lokal Anda.

Menerbitkan Fungsi Data Pengguna

Setelah Anda menguji perubahan, terbitkan fungsi data pengguna ke Fabric. Dibutuhkan beberapa menit untuk menerbitkan perubahan apa pun.

Cuplikan layar yang memperlihatkan cara menerbitkan perubahan atau fungsi yang baru ditambahkan untuk item fungsi data user dalam pengembangan lokal.

Debugging lokal dengan titik henti

Pilih F5 untuk melakukan debug fungsi Fabric Anda. Anda dapat menambahkan titik henti di mana saja dalam kode Anda. Dalam mode debug, titik henti Anda terpicu sesuai harapan dan Anda dapat menguji kode seperti saat Anda menguji fungsi yang sudah diterapkan.

Cuplikan layar menunjukkan cara memecahkan masalah secara lokal dengan titik henti.

Langkah berikutnya

  • Last updated on