Fungsi yang Ditentukan Pengguna

  • Artikel

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.

Lihat juga