Fungsi yang Ditentukan Pengguna
Azure Cosmos DB adalah database multi-model yang didistribusikan secara global yang mendukung model data dokumen, grafik, dan nilai kunci. Konten di bagian ini adalah untuk mengelola sumber daya fungsi yang ditentukan pengguna (udfs) menggunakan SQL API melalui REST.
Fungsi yang ditentukan pengguna (UDF) adalah efek samping dari logika aplikasi yang ditulis dalam JavaScript. Ini memungkinkan pengembang untuk membangun operator kueri, sehingga memperluas inti bahasa kueri Cosmos DB. Seperti prosedur tersimpan, UDF tinggal di batas koleksi, sehingga membatasi logika aplikasi ke koleksi.
Mirip dengan prosedur tersimpan, sumber daya UDF memiliki skema tetap. Properti isi berisi logika aplikasi. Contoh berikut mengilustrasikan konstruksi JSON dari fungsi yang ditentukan pengguna.
{
"id":"simpleTaxUDF",
"body": "
function tax(income) {
if(income == undefined)
throw 'no input';
if (income < 1000)
return income * 0.1;
else if (income < 10000)
return income * 0.2;
else
return income * 0.4;
}
",
"_rid":"hLEEAI1YjgcBAAAAAAAAgA==",
"_ts":1408058682,
"_self":"dbs\/hLEEAA==\/colls\/hLEEAI1Yjgc=\/udfs\/hLEEAI1YjgcBAAAAAAAAgA==\/",
"_etag":"00004100-0000-0000-0000-53ed453a0000"
}
Properti | Deskripsi |
---|---|
id | Wajib diisi. Ini adalah properti yang dapat diatur pengguna. Ini adalah nama unik untuk mengidentifikasi UDF. ID tidak boleh melebihi 255 karakter. |
isi | Wajib diisi. Ini adalah properti yang dapat diatur pengguna. Ini adalah tubuh UDF. |
_rid | Ini adalah properti yang dihasilkan sistem. ID sumber daya (_rid) adalah pengidentifikasi unik yang juga hierarkis per tumpukan sumber daya pada model sumber daya. Ini digunakan secara internal untuk penempatan dan navigasi sumber daya UDF. |
_Ts | Ini adalah properti yang dihasilkan sistem. Ini menentukan tanda waktu terakhir yang diperbarui dari sumber daya. Nilainya adalah tanda waktu. |
_self | Ini adalah properti yang dihasilkan sistem. Ini adalah URI unik yang dapat diatasi untuk sumber daya. |
_etag | Ini adalah properti yang dihasilkan sistem yang menentukan etag sumber daya yang diperlukan untuk kontrol konkurensi optimis. |
Tugas
Anda dapat melakukan hal berikut dengan fungsi yang ditentukan pengguna:
Untuk informasi tentang cara kerja UDF, termasuk menjalankan UDF dalam kueri, lihat Pemrograman Cosmos DB: Prosedur tersimpan, pemicu, dan UDF.