All Products
Search
Document Center

:Buat Fungsi Python

Last Updated:Jun 22, 2026

Topik ini menjelaskan cara membuat fungsi Python.

Prasyarat

Anda telah membuat proses bisnis. Untuk informasi selengkapnya, lihat Buat dan kelola proses bisnis.

Informasi latar belakang

Di DataService Studio, Anda dapat membuat, menguji, dan menerbitkan fungsi. Setelah diterbitkan, fungsi tersebut dapat dikaitkan dengan API dan berperan sebagai filter untuk memproses parameter permintaan atau data respons API, sehingga mendukung kueri kompleks dan berbagai skenario bisnis.

Batasan

  • Anda harus berlangganan DataWorks Professional Edition atau edisi yang lebih tinggi untuk menggunakan fungsi Python dan fitur filter.

  • Fungsi Python harus dijalankan di resource group bersama untuk DataService Studio.

  • Fungsi Python sedang dalam proses refaktor. Anda tidak dapat membuat, mengkloning, atau menerbitkan fungsi Python baru. Jika memerlukan fitur fungsi, kami menyarankan menggunakan fungsi Aviator. Untuk informasi selengkapnya, lihat Buat fungsi Aviator.

  • Saat menggunakan fungsi sebagai filter API, baik filter pra-pemrosesan maupun post-processing harus berupa fungsi Python.

  • Batasan berikut berlaku saat Anda menggunakan fungsi Python sebagai filter:

    • Filter hanya mendukung sintaksis Python 3.0.

    • Filter hanya mendukung modul-modul berikut: import json,time,random,pickle,re,math.

    • Filter memerlukan signature fungsi def handler(event,context):.

Struktur fungsi

# -*- coding: utf-8 -*-
# event (str): Hasil API jika digunakan sebagai filter, atau parameter Anda dalam kasus lain.
# context: Berisi informasi lingkungan. Parameter ini saat ini tidak digunakan.
# Modul impor yang didukung: json, time, random, pickle, re, math.
# Jangan ubah nama fungsi.
import json
def handler(event,context):
    # Muat string ke dalam objek JSON.
    obj = json.loads(event)
    # Tambahkan kode Anda di sini.
    # Akhir dari kode kustom.
    return obj

Anda dapat memodifikasi templat fungsi ini dan mengubah nama parameter input sesuai kebutuhan Anda.

Parameter 1 [context]: Berisi konteks eksekusi API. Parameter ini saat ini tidak digunakan.  
Parameter 2 [event]: Berisi parameter permintaan API atau hasil dari filter sebelumnya.
Catatan
  • Sistem mengonversi parameter permintaan API atau output dari filter sebelumnya menjadi string JSON dan meneruskannya ke parameter event. Setiap value dalam objek JSON harus berupa string.

  • Filter pra-pemrosesan menghasilkan peta key-value yang digunakan oleh pernyataan SQL berikutnya sebagai parameter input. Oleh karena itu, peta tersebut harus memiliki kedalaman 1 (peta datar).

Buka DataService Studio

Masuk ke Konsol DataWorks. Di wilayah target, klik Data Analysis and Service > DataService Studio di panel navigasi kiri. Pilih ruang kerja dari daftar drop-down dan klik Go to DataService Studio.

Buat fungsi

  1. Di panel Service Development, arahkan kursor ke ikon image.png dan klik Create Function > Create Python Function.

    Atau, temukan proses bisnis target, klik kanan Function, lalu pilih Create > Create Python Function.

  2. Di kotak dialog Create Python Function, konfigurasikan parameter.

    Parameter

    Deskripsi

    Function Name

    Nama fungsi. Nama harus terdiri dari 256 karakter atau kurang.

    Function Template

    Hanya templat Python3 Standard v1 yang didukung.

    Runtime Environment

    Hanya Python 3.0 yang didukung.

    Function Description

    Deskripsi fungsi. Deskripsi harus terdiri dari 512 karakter atau kurang.

    Location

    Folder tempat fungsi akan disimpan.

  3. Klik Confirm.

  4. Konfigurasikan fungsi di halaman editnya.

    1. Di bagian Edit Code, masukkan kode fungsi.

    2. Di bagian Environment Configuration, atur Memory dan Timeout.

  5. Klik ikon Save 保存 di bilah alat.

Langkah berikutnya