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.
-
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 di panel navigasi kiri. Pilih ruang kerja dari daftar drop-down dan klik Go to DataService Studio.
Buat fungsi
-
Di panel Service Development, arahkan kursor ke ikon
dan klik .Atau, temukan proses bisnis target, klik kanan Function, lalu pilih .
-
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.
-
Klik Confirm.
-
Konfigurasikan fungsi di halaman editnya.
-
Di bagian Edit Code, masukkan kode fungsi.
-
Di bagian Environment Configuration, atur Memory dan Timeout.
-
-
Klik ikon Save
di bilah alat.
Langkah berikutnya
-
Setelah membuat fungsi, Anda dapat mengujinya dan menerapkannya. Untuk informasi selengkapnya, lihat Uji, terapkan, dan gunakan fungsi dan Terapkan fungsi.
-
Setelah menerapkan fungsi, Anda dapat mengaitkannya dengan API dan menggunakannya sebagai pre-filter atau post-filter untuk memproses parameter permintaan dan data respons. Untuk informasi selengkapnya, lihat Gunakan fungsi sebagai filter API.