Membuat dan mengelola fungsi tersimpan

Fungsi adalah kueri atau bagian dari kueri yang dapat digunakan kembali. Real-Time Intelligence mendukung dua jenis fungsi:

  • Fungsi bawaan, yang merupakan fungsi berkode keras yang tidak dapat Anda ubah.

  • Fungsi yang ditentukan pengguna, yang dibagi menjadi dua jenis:

    • Fungsi tersimpan: fungsi yang ditentukan pengguna yang Anda simpan dan kelola sebagai entitas skema database, seperti tabel. Untuk informasi selengkapnya tentang cara membuat dan mengelola fungsi tersimpan, lihat Ringkasan manajemen fungsi tersimpan.
    • Fungsi yang ditentukan kueri: fungsi yang ditentukan pengguna yang Anda tentukan dan gunakan dalam cakupan kueri tunggal. Anda menentukan fungsi-fungsi ini melalui let pernyataan. Untuk informasi selengkapnya tentang cara membuat fungsi yang ditentukan kueri, lihat Membuat fungsi yang ditentukan pengguna.

Dalam artikel ini, Anda mempelajari cara membuat atau mengubah fungsi tersimpan yang ada dengan menggunakan .create-or-alterfunction.

Untuk informasi selengkapnya tentang .create-or-alterfunction perintah, lihat .create-or-alter function.

Prasyarat

  • ruang kerja dengan kapasitas yang menggunakan Microsoft Fabric
  • Database KQL dengan izin pengeditan

Membuat fungsi

Fitur ini memungkinkan Anda membuat atau mengubah fungsi yang ada dengan menggunakan .create-or-alterfunction perintah . Perintah menyimpan fungsi dalam metadata database. Jika fungsi dengan functionName yang disediakan tidak ada di metadata database, perintah akan membuat fungsi baru. Jika tidak, perintah mengubah fungsi yang disebutkan.

  1. Telusuri ke database KQL Anda, dan pilihFungsi>. Perintah .create-or-alter secara otomatis muncul di jendela Jelajahi data Anda .

    Cuplikan layar halaman arahan database KQL memperlihatkan menu dropdown Opsi baru. Opsi berjudul Fungsi disorot.

  2. Masukkan nama fungsi dan parameter kueri untuk fungsi Anda alih-alih teks tempat penampung, lalu pilih Jalankan.

    Cuplikan layar jendela Jelajahi data Anda memperlihatkan fungsi yang baru dibuat di Real-Time Intelligence.

    Fungsi tersimpan muncul di bawah Fungsi di panel Penjelajah .

    Cuplikan layar panel Explorer memperlihatkan daftar fungsi yang ditentukan pengguna yang disimpan.

  3. Di jendela Jelajahi data Anda , jalankan kueri untuk memeriksa apakah Anda berhasil membuat atau mengubah fungsi Anda.

    Cuplikan layar jendela Jelajahi data Anda memperlihatkan hasil kueri fungsi tersimpan di Real-Time Intelligence.

Daftar fungsi tersimpan

Anda bisa menampilkan daftar semua fungsi tersimpan dalam database. Dengan mengklik kiri pada opsi Functions atau dengan memilih Tampilkan fungsi di menu dropdown, Anda dapat membuka daftar fungsi.
Cuplikan layar pohon fungsi di panel Explorer.

Daftar ini meliputi:

  • Folder fungsi dan deskripsinya.
  • Kemampuan pengurutan dan pencarian opsional untuk membantu Anda menemukan fungsi tertentu.

Cuplikan layar daftar fungsi tersimpan.

Mengklik kiri di fungsi dalam daftar akan membuka versi pratinjau dari fungsi yang hanya baca. Di menu dropdown, Anda juga dapat memilih Tampilkan fungsi untuk membuka versi pratinjau fungsi, edit, atau hapus fungsi.

Menata fungsi dengan folder

Untuk membuat subfolder atau berpindah ke folder yang sudah ada:

  1. Di panel Explorer, lakukan salah satu hal berikut:
    • Klik kanan pada fungsi dan pilih Pindahkan ke folder>+ Folder baru.
      Cuplikan layar menu pop-up memperlihatkan opsi untuk membuat folder baru untuk fungsi tersebut.
    • Atau, pilih elipsis (...) di samping fungsi tertentu dan pilih Pindahkan ke folder>+ Folder baru atau pilih folder yang sudah ada.
      Cuplikan layar menu pop-up memperlihatkan opsi untuk memindahkan fungsi ke folder yang sudah ada atau membuat yang baru.
  2. Untuk membuat folder, masukkan nama untuk folder dan pilih Buat. Fungsi dipindahkan ke folder baru.
    Cuplikan layar folder baru yang sedang dibuat.
  3. Untuk memindahkan lebih dari satu fungsi, masukkan nama folder lain atau pilih menu dropdown dan centang kotak di samping fungsi yang ingin Anda pindahkan ke folder yang sama.
    Cuplikan layar menu pop-up memperlihatkan opsi untuk memindahkan beberapa fungsi ke folder yang sama.
  4. Anda juga dapat memindahkan fungsi ke folder yang sudah ada. Untuk melakukannya, pilih Pindahkan ke folder lalu pilih folder yang ingin Anda pindahkan fungsinya, atau seret dan letakkan fungsi ke folder.

Note

  • Jika Anda menghapus subfolder, fungsi dalam folder tidak dihapus tetapi dipindahkan kembali ke folder induk.
  • Subfolder dihapus secara otomatis ketika tidak ada fungsi dalam folder.
  • Folder dapat dibuat per jenis aset dan nama harus unik per jenis aset. Misalnya, Anda dapat memiliki folder tabel dan folder fungsi dengan nama yang sama, tetapi Anda tidak dapat memiliki dua folder fungsi dengan nama yang sama.

Menampilkan dan mempratinjau fungsi tersimpan

Untuk melihat atau mempratinjau fungsi tersimpan yang sudah ada, ikuti langkah-langkah berikut:

  1. Di panel Explorer , perluas bagian Fungsi . Klik kiri pada fungsi yang diinginkan untuk membuka pratinjau atau pilih tiga titik dan tampilkan fungsi.

  2. Versi baca-saja dari skrip fungsi terbuka di jendela Jelajahi data Anda .

    • Anda dapat memilih Pratinjau hasil untuk mempratinjau hasil fungsi.
    • Jika fungsi menyertakan parameter, Anda dapat memasukkan nilai untuk parameter tersebut. Kemudian, pilih Pratinjau hasil untuk melihat output berdasarkan nilai parameter yang Anda berikan.
    • Hasil pratinjau menampilkan hingga 100 catatan berdasarkan kueri fungsi.

    Cuplikan layar jendela Jelajahi data Anda memperlihatkan skrip fungsi tersimpan.

Mengedit atau menghapus fungsi tersimpan

Untuk mengedit atau menghapus fungsi tersimpan yang sudah ada, gunakan langkah-langkah berikut:

  1. Di panel Explorer , perluas bagian Fungsi . Pilih tiga titik di samping fungsi yang diinginkan.

  2. Dari menu dropdown, pilih:

    • Edit dengan kode untuk mengedit skrip fungsi di jendela Jelajahi data Anda .
    • Menghapus

    Cuplikan layar menu dropdown.

  3. Jika Anda mengubah skrip fungsi, pilih Jalankan untuk menyimpan perubahan Anda.

Konten terkait

  • Last updated on