All Products
Search
Document Center

:CreateUdfFile

Last Updated:Jun 11, 2026

Membuat file untuk fungsi di DataStudio.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

FileFolderPath

string

No

Path folder tempat file untuk fungsi disimpan.

Business_process/First_Business_Process/function/string_processing

ProjectId

integer

No

ID dari workspace DataWorks. Anda dapat mengklik ikon Workspace Manage di pojok kanan atas halaman DataStudio untuk membuka halaman Workspace Management dan melihat ID workspace.

10000

FileName

string

Yes

Nama file untuk fungsi.

StringConcat

FunctionType

string

Yes

Jenis fungsi. Nilai yang valid: MATH, AGGREGATE, STRING, DATE, ANALYTIC, dan OTHER. Parameter ini sesuai dengan parameter Function Type pada bagian Register Function di tab konfigurasi fungsi pada halaman DataStudio.

STRING

ClassName

string

Yes

Nama kelas tempat fungsi didefinisikan. Parameter ini sesuai dengan parameter Class Name pada bagian Register Function di tab konfigurasi fungsi pada konsol DataWorks.

com.alibaba.DataWorks.api.udf.StringConcat

Resources

string

Yes

Nama-nama resource yang direferensikan oleh fungsi. Parameter ini sesuai dengan parameter Resources pada bagian Register Function di tab konfigurasi fungsi pada konsol DataWorks. Beberapa nama resource dipisahkan dengan koma (,).

string-concat-1.0.0.jar,commons-lang-2.6.jar

UdfDescription

string

No

Deskripsi fungsi. Parameter ini sesuai dengan parameter Description pada bagian Register Function di tab konfigurasi fungsi pada halaman DataStudio.

Concatenate several strings to generate a new string

CmdDescription

string

No

Sintaks yang digunakan untuk memanggil fungsi. Parameter ini sesuai dengan parameter Expression Syntax pada bagian Register Function di tab konfigurasi fungsi pada konsol DataWorks.

StringConcat(String... substrs)

ParameterDescription

string

No

Deskripsi parameter input dari fungsi. Parameter ini sesuai dengan parameter Parameter Description pada bagian Register Function di tab konfigurasi fungsi pada halaman DataStudio.

List of strings to be connected

ReturnValue

string

No

Deskripsi nilai kembalian dari fungsi. Parameter ini sesuai dengan parameter Return Value pada bagian Register Function di tab konfigurasi fungsi pada halaman DataStudio.

New strings generated by concatenating all strings before and after the input order

Example

string

No

Contoh untuk memanggil fungsi. Parameter ini sesuai dengan parameter Example pada bagian Register Function di tab konfigurasi fungsi pada konsol DataWorks.

StringConcat('a', 'b', 'c')

ProjectIdentifier

string

No

Pengenal unik dari workspace DataWorks. Anda dapat mengklik pengenal di pojok kiri atas halaman DataStudio untuk beralih ke workspace lain.

Anda harus menentukan parameter ini atau parameter projectId untuk menentukan workspace DataWorks yang menjadi tujuan operasi.

dw_project

CreateFolderIfNotExists

boolean

No

Menentukan apakah secara otomatis membuat direktori yang ditentukan oleh parameter FileFolderPath jika direktori tidak ada. Nilai yang valid:

  • true: Sistem secara otomatis membuat direktori jika direktori tidak ada.

  • false: Sistem tidak secara otomatis membuat direktori jika direktori tidak ada. Dalam kasus ini, panggilan gagal.

false

Elemen respons

Element

Type

Description

Example

object

HttpStatusCode

integer

Kode status HTTP yang dikembalikan.

200

Data

integer

ID dari file yang telah dibuat.

100000002

RequestId

string

ID dari permintaan. Anda dapat memecahkan masalah berdasarkan ID tersebut.

0000-ABCD-EFG****

ErrorMessage

string

Pesan error yang dikembalikan.

The connection does not exist.

Success

boolean

Menunjukkan apakah permintaan berhasil.

true

ErrorCode

string

Kode error yang dikembalikan.

Invalid.Tenant.ConnectionNotExists

Contoh

Respons sukses

JSONformat

{
  "HttpStatusCode": 200,
  "Data": 100000002,
  "RequestId": "0000-ABCD-EFG****",
  "ErrorMessage": "The connection does not exist.",
  "Success": true,
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

500 InternalError.System An internal system error occurred. Try again later.
500 InternalError.UserId.Missing An internal system error occurred. Try again later.
403 Forbidden.Access Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition.
429 Throttling.Api The request for this resource has exceeded your available limit.
429 Throttling.System The DataWorks system is busy. Try again later.
429 Throttling.User Your request is too frequent. Try again later.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.