全部产品
Search
文档中心

:Buat Fungsi Python

更新时间:Jul 02, 2025

Topik ini menjelaskan cara membuat fungsi Python.

Prasyarat

Proses bisnis telah dibuat. Untuk informasi lebih lanjut, lihat Buat dan kelola proses bisnis.

Informasi Latar Belakang

Di halaman DataService Studio, Anda dapat membuat, menguji, dan menerbitkan fungsi. Kemudian, Anda dapat mengaitkan fungsi tersebut dengan API dan menggunakannya sebagai filter untuk memproses parameter permintaan atau respons dari API guna melakukan kueri kompleks sesuai kebutuhan bisnis Anda.

Batasan

  • Anda harus mengaktifkan DataWorks Edisi Profesional atau edisi yang lebih canggih sebelum menggunakan fungsi Python.

  • Fungsi Python harus dijalankan pada grup sumber daya bersama untuk DataService Studio.

  • Fitur penggunaan fungsi Python sebagai filter sedang dioptimalkan. Anda tidak dapat membuat, mengkloning, atau menerbitkan fungsi Python baru. Jika Anda perlu menggunakan fitur ini, kami sarankan Anda menggunakan fungsi Aviator. Untuk informasi lebih lanjut, lihat Buat Fungsi Aviator.

  • Jika Anda menggunakan satu atau beberapa fungsi sebagai filter untuk memproses parameter permintaan API dan satu atau beberapa fungsi sebagai filter untuk memproses hasil yang dikembalikan oleh API, Anda harus menggunakan jenis fungsi yang sama sebagai filter. Anda tidak dapat menggunakan jenis fungsi yang berbeda sebagai filter untuk API.

  • Jika Anda ingin menggunakan fungsi Python sebagai filter, perhatikan batasan berikut:

    • Hanya fungsi Python 3.0 yang dapat digunakan sebagai filter.

    • Fungsi Python mendukung impor hanya modul berikut: json, time, random, pickle, re, and math.

    • Nama fungsi yang digunakan sebagai filter harus def handler(event,context):.

Template Fungsi

# -*- coding: utf-8 -*-

# event (str) : dalam filter adalah hasil API, dalam kasus lain, itu adalah parameter Anda
# context : beberapa informasi lingkungan, sementara tidak digunakan
# batas impor modul: json,time,random,pickle,re,math
# jangan ubah nama fungsi
import json
def handler(event,context):
    # muat str ke objek json
    obj = json.loads(event)
    # tambahkan kode Anda di sini
    # akhir tambahan
    return obj

Anda dapat memodifikasi template fungsi untuk menulis fungsi Anda sendiri. Anda dapat mengubah nama parameter input sesuai kebutuhan bisnis Anda.

Parameter 1 [context]: konteks pemanggilan API. Nilainya bertipe STRING. Parameter ini tidak digunakan dan dibiarkan kosong.   
Parameter 2 [event]: parameter permintaan API atau data hasil yang dikembalikan oleh fungsi sebelumnya. Nilainya bertipe STRING.

Catatan
  • Sistem mengonversi parameter permintaan API atau data hasil yang dikembalikan oleh filter sebelumnya dari peta pasangan kunci-nilai menjadi objek JSON, dan melewatkan objek JSON ke parameter event. Nilai dalam objek JSON harus bertipe STRING.

  • Hasil pemrosesan filter yang digunakan untuk memproses parameter permintaan API adalah peta pasangan kunci-nilai. Peta pasangan kunci-nilai digunakan sebagai parameter input dari Pernyataan SQL. Oleh karena itu, peta pasangan kunci-nilai tidak dapat berisi pasangan kunci-nilai bersarang.

Buat Fungsi

  1. Di panel Service Development, gerakkan penunjuk di atas ikon image.png dan pilih Create Function > Create Python Function.

    Sebagai alternatif, Anda dapat menemukan proses bisnis yang diinginkan, klik kanan Function, dan kemudian pilih Create Function > Create Python Function.

  2. Di kotak dialog Create Python Function, konfigurasikan parameter sesuai kebutuhan bisnis Anda.

    PYthon

    Parameter

    Deskripsi

    Function Name

    Nama fungsi. Nama dapat memiliki panjang hingga 256 karakter.

    Function Template

    Template yang digunakan untuk membuat fungsi. Atur nilainya ke Python3 Standar v1.

    Running Environment

    Lingkungan runtime fungsi. Atur nilainya ke Python 3.0.

    Function Description

    Deskripsi fungsi. Deskripsi dapat memiliki panjang hingga 512 karakter.

    Destination Folder

    Folder untuk menyimpan fungsi.

  3. Klik Determine.

  4. Konfigurasikan fungsi pada tab konfigurasinya.

    1. Di bagian Edit Code, masukkan kode fungsi.

    2. Di bagian Environment Configuration, konfigurasikan parameter Memory dan Function Timeout.

  5. Klik ikon 保存 di bilah alat.