Functions - Bahasa kueri di Cosmos DB (di Azure dan Fabric)

Bahasa kueri mencakup serangkaian fungsi sistem yang dibangun dalam bahasa kueri dan dirancang untuk menangani berbagai tugas umum.

Functions

Berikut adalah daftar fungsi yang saat ini didukung bahasa kueri:

Fungsi Matematika

	Description
ABS	Fungsi menghitung ABS nilai absolut (positif) dari ekspresi numerik yang ditentukan.
ACOS	Fungsi menghitung ACOS arkakosin trigonomik dari nilai numerik yang ditentukan. Arkakosin adalah sudut, dalam radian, yang kosinusnya adalah ekspresi numerik yang ditentukan.
ASIN	Fungsi ini ASIN menghitung arka sinus trigonomik dari nilai numerik yang ditentukan. Arka sinus adalah sudut, dalam radian, yang sinusnya adalah ekspresi numerik yang ditentukan.
ATAN	Fungsi menghitung ATAN arka kotangen trigonometri dari nilai numerik yang ditentukan. Arka tangen adalah sudut, dalam radian, yang tangennya adalah ekspresi numerik yang ditentukan.
ATN2	Fungsi menghitung ATN2 nilai utama arka tangen y/x, yang dinyatakan dalam radian.
CEILING	Fungsi menghitung CEILING nilai bilangan bulat terkecil yang lebih besar dari atau sama dengan ekspresi numerik yang ditentukan.
COS	Fungsi ini COS menghitung kosinus trigonomik dari sudut yang ditentukan dalam radian.
COT	Fungsi menghitung COT kotangen trigonometri dari sudut yang ditentukan dalam radian.
DEGREES	Fungsi menghitung DEGREES sudut yang sesuai dalam derajat untuk sudut yang ditentukan dalam radian.
EXP	Fungsi menghitung EXP nilai eksponensial dari ekspresi numerik yang ditentukan.
FLOOR	Fungsi menghitung FLOOR bilangan bulat terbesar kurang dari atau sama dengan ekspresi numerik yang ditentukan.
INTADD	Fungsi INTADD mengembalikan jumlah dua nilai bilangan bulat.
INTBITAND	Fungsi mengembalikan INTBITAND perbandingan bit dari setiap operand menggunakan operator AND inklusif.
INTBITLEFTSHIFT	Fungsi mengembalikan INTBITLEFTSHIFT hasil operasi shift kiri bitwise pada nilai bilangan bulat.
INTBITNOT	Fungsi mengembalikan INTBITNOT hasil operasi BITWISE NOT pada nilai bilangan bulat.
INTBITOR	Fungsi mengembalikan INTBITOR hasil operasi OR inklusif bitwise pada dua nilai bilangan bulat.
INTBITRIGHTSHIFT	Fungsi mengembalikan INTBITRIGHTSHIFT hasil operasi shift kanan bitwise pada nilai bilangan bulat.
INTBITXOR	Fungsi mengembalikan INTBITXOR hasil operasi OR eksklusif bitwise pada dua nilai bilangan bulat.
INTDIV	Fungsi INTDIV mengembalikan hasil pembagian nilai bilangan bulat pertama dengan yang kedua.
INTMOD	Fungsi INTMOD mengembalikan sisa pembagian nilai bilangan bulat pertama dengan yang kedua.
INTMUL	Fungsi mengembalikan INTMUL produk dari dua nilai bilangan bulat.
INTSUB	Fungsi mengembalikan INTSUB hasil pengurangan nilai bilangan bulat kedua dari yang pertama.
LOG	Fungsi mengembalikan LOG logaritma alami dari ekspresi numerik yang ditentukan.
LOG10	Fungsi mengembalikan LOG10 logaritma base-10 dari ekspresi numerik yang ditentukan.
NUMBERBIN	Fungsi menghitung NUMBERBIN nilai input yang dibulatkan ke kelipatan ukuran yang ditentukan.
PI	Fungsi mengembalikan PI nilai konstanta Pi.
POWER	Fungsi mengembalikan POWER nilai ekspresi yang ditentukan yang dikalikan dengan sendirinya jumlah waktu yang diberikan.
RADIANS	Fungsi mengembalikan RADIANS sudut yang sesuai dalam radian untuk sudut yang ditentukan dalam derajat.
RAND	Fungsi mengembalikan RAND nilai numerik yang dihasilkan secara acak dari nol hingga satu.
ROUND	Fungsi ROUND mengembalikan nilai numerik yang dibulatkan ke nilai bilangan bulat terdekat.
SIGN	Fungsi mengembalikan SIGN tanda positif (+1), nol (0), atau negatif (-1) dari ekspresi numerik yang ditentukan.
SIN	Fungsi mengembalikan SIN sinus trigonomik dari sudut yang ditentukan dalam radian.
SQRT	Fungsi SQRT mengembalikan akar kuadrat dari nilai numerik yang ditentukan.
SQUARE	Fungsi SQUARE mengembalikan kuadrat dari nilai numerik yang ditentukan.
TAN	Fungsi mengembalikan TAN tangen trigonometri dari sudut yang ditentukan dalam radian.
TRUNC	Fungsi mengembalikan TRUNC nilai numerik yang dipotong ke nilai bilangan bulat terdekat.

Fungsi Array

	Description
ARRAY_CONCAT	Fungsi ARRAY_CONCAT mengembalikan array yang merupakan hasil dari menggabungkan dua atau beberapa nilai array.
ARRAY_CONTAINS_ALL	Fungsi ARRAY_CONTAINS_ALL mengembalikan boolean yang menunjukkan apakah array berisi semua nilai yang ditentukan.
ARRAY_CONTAINS_ANY	Fungsi ARRAY_CONTAINS_ANY mengembalikan boolean yang menunjukkan apakah array berisi salah satu nilai yang ditentukan.
ARRAY_CONTAINS	Fungsi ARRAY_CONTAINS mengembalikan boolean yang menunjukkan apakah array berisi nilai yang ditentukan. Anda dapat memeriksa kecocokan sebagian atau penuh objek dengan menggunakan ekspresi boolean dalam fungsi.
ARRAY_LENGTH	Fungsi mengembalikan ARRAY_LENGTH jumlah elemen dalam ekspresi array yang ditentukan.
ARRAY_SLICE	Fungsi mengembalikan ARRAY_SLICE subset ekspresi array menggunakan indeks dan panjang yang ditentukan.
CHOOSE	Fungsi CHOOSE mengembalikan ekspresi pada indeks daftar yang ditentukan, atau Tidak ditentukan jika indeks melebihi batas daftar.
OBJECTTOARRAY	Fungsi ini OBJECTTOARRAY mengonversi pasangan bidang/nilai dalam objek JSON ke array JSON.
SETINTERSECT	Fungsi mengembalikan SETINTERSECT kumpulan ekspresi yang terkandung dalam kedua array input tanpa duplikat.
SETUNION	Fungsi mengembalikan SETUNION sekumpulan ekspresi yang berisi semua ekspresi dari dua set yang dikumpulkan tanpa duplikat.

Fungsi agregasi

	Description
AVG	Fungsi menghitung AVG rata-rata nilai dalam ekspresi.
COUNT	Fungsi COUNT mengembalikan jumlah nilai dalam ekspresi.
MAX	Fungsi MAX mengembalikan nilai maksimum ekspresi yang ditentukan.
MIN	Fungsi mengembalikan MIN nilai minimum ekspresi yang ditentukan.
SUM	Fungsi SUM menghitung jumlah nilai dalam ekspresi.

Fungsi String

	Description
CONCAT	Fungsi mengembalikan CONCAT string yang merupakan hasil dari menggabungkan beberapa bidang dari dokumen.
CONTAINS	Fungsi CONTAINS mengembalikan boolean yang menunjukkan apakah ekspresi string pertama berisi ekspresi string kedua.
ENDSWITH	Fungsi ENDSWITH mengembalikan boolean yang menunjukkan apakah string diakhiri dengan akhiran yang ditentukan. Secara opsional, perbandingannya bisa tidak peka huruf besar/kecil.
INDEX-OF	Fungsi mengembalikan INDEX_OF indeks kemunculan pertama string.
LEFT	Fungsi mengembalikan LEFT bagian kiri string hingga jumlah karakter yang ditentukan.
LENGTH	Fungsi mengembalikan LENGTH jumlah karakter dalam ekspresi string yang ditentukan.
LOWER	Fungsi mengembalikan LOWER ekspresi string setelah mengonversi data karakter huruf besar menjadi huruf kecil.
LTRIM	Fungsi LTRIM mengembalikan ekspresi string setelah menghapus spasi kosong atau karakter tertentu di depannya.
REGEXMATCH	Fungsi REGEXMATCH mengembalikan boolean yang menunjukkan apakah string yang disediakan cocok dengan ekspresi reguler yang ditentukan. Ekspresi reguler adalah notasi ringkas dan fleksibel untuk menemukan pola teks.
REPLACE	Fungsi REPLACE mengembalikan string dengan semua kemunculan string tertentu yang diganti.
REPLICATE	Fungsi mengembalikan REPLICATE nilai string yang mengulangi jumlah waktu tertentu.
REVERSE	Fungsi mengembalikan REVERSE urutan terbalik dari nilai string.
RIGHT	Fungsi mengembalikan RIGHT bagian kanan string hingga jumlah karakter yang ditentukan.
RTRIM	Fungsi mengembalikan RTRIM ekspresi string setelah menghapus spasi kosong berikutnya atau karakter yang ditentukan.
STARTSWITH	Fungsi STARTSWITH mengembalikan nilai boolean yang menunjukkan apakah ekspresi string pertama dimulai dengan yang kedua.
STRINGEQUALS	Fungsi STRINGEQUALS mengembalikan boolean yang menunjukkan apakah ekspresi string pertama cocok dengan yang kedua.
STRINGJOIN	Fungsi mengembalikan STRINGJOIN string, yang menggabungkan elemen array tertentu, menggunakan pemisah yang ditentukan di antara setiap elemen.
STRINGSPLIT	Fungsi mengembalikan STRINGSPLIT array substring yang diperoleh dari memisahkan string sumber dengan pemisah yang ditentukan.
STRINGTOARRAY	Fungsi mengonversi STRINGTOARRAY ekspresi string menjadi array.
STRINGTOBOOLEAN	Fungsi ini STRINGTOBOOLEAN mengonversi ekspresi string menjadi boolean.
SUBSTRING	Fungsi mengembalikan SUBSTRING bagian dari ekspresi string yang dimulai pada posisi yang ditentukan dan panjang yang ditentukan, atau ke akhir string.
TOSTRING	Fungsi mengembalikan TOSTRING representasi string dari nilai.
TRIM	Fungsi mengembalikan TRIM ekspresi string setelah menghapus spasi kosong atau karakter kustom di awal dan akhir.
UPPER	Fungsi mengembalikan UPPER ekspresi string setelah mengonversi data karakter huruf kecil menjadi huruf besar.

Fungsi tanggal dan waktu

	Description
DATETIMEADD	Fungsi mengembalikan DATETIMEADD nilai string tanggal dan waktu yang merupakan hasil dari penambahan nilai angka tertentu ke string tanggal dan waktu yang disediakan.
DATETIMEBIN	Fungsi mengembalikan DATETIMEBIN nilai string tanggal dan waktu yang merupakan hasil pengikatan (atau pembulatan) bagian dari string tanggal dan waktu yang disediakan.
DATETIMEDIFF	Fungsi mengembalikan DATETIMEDIFF perbedaan, sebagai bilangan bulat yang ditandatangani, dari bagian tanggal dan waktu yang ditentukan antara dua nilai tanggal dan waktu.
DATETIMEFROMPARTS	Fungsi mengembalikan DATETIMEFROMPARTS nilai string tanggal dan waktu yang dibangun dari nilai numerik input untuk berbagai bagian tanggal dan waktu.
DATETIMEPART	Fungsi mengembalikan DATETIMEPART nilai bagian tanggal dan waktu yang ditentukan untuk tanggal dan waktu yang disediakan.
DATETIMETOTICKS	Fungsi mengonversi DATETIMETOTICKS DateTime yang ditentukan menjadi tanda centang. Satu tanda centang mewakili 100 nanodetik atau 0,0000001 detik.
DATETIMETOTIMESTAMP	Fungsi mengonversi DATETIMETOTIMESTAMP tanggal dan waktu yang ditentukan menjadi tanda waktu numerik. Tanda waktu adalah bilangan bulat numerik yang ditandatangani yang mengukur milidetik sejak zaman Unix.
GETCURRENTDATETIME	Fungsi mengembalikan GETCURRENTDATETIME tanggal dan waktu UTC (Waktu Universal Terkoordinasi) saat ini sebagai string ISO 8601 .
GETCURRENTDATETIMESTATIC	Fungsi mengembalikan GETCURRENTDATETIMESTATIC nilai tanggal dan waktu UTC yang sama untuk semua item dalam kueri, sebagai string ISO 8601. Ini berguna untuk tanda waktu yang konsisten di seluruh hasil kueri.
GETCURRENTTICKS	Fungsi mengembalikan GETCURRENTTICKS waktu UTC saat ini sebagai jumlah interval 100-nanodetik (tick) yang telah berlalu sejak 0001-01-01T00:00:00.000000Z.
GETCURRENTTICKSSTATIC	Fungsi mengembalikan GETCURRENTTICKSSTATIC nilai ticks nanodetik statis (interval 100 nanodetik sejak epoch Unix) untuk semua item dalam partisi yang sama.
GETCURRENTTIMESTAMP	Fungsi mengembalikan GETCURRENTTIMESTAMP tanda waktu saat ini dalam milidetik sejak zaman Unix.
GETCURRENTTIMESTAMPSTATIC	Fungsi mengembalikan GETCURRENTTIMESTAMPSTATIC nilai tanda waktu statis (milidetik sejak epoch Unix) untuk semua item dalam partisi yang sama.
TICKSTODATETIME	Fungsi mengonversi TICKSTODATETIME jumlah tanda centang yang ditentukan menjadi nilai tanggal dan waktu.
TIMESTAMPTODATETIME	Fungsi mengonversi TIMESTAMPTODATETIME tanda waktu yang ditentukan menjadi nilai tanggal dan waktu.

Fungsi-fungsi dari item

	Description
DOCUMENTID	Fungsi mengembalikan DOCUMENTID ID dokumen unik untuk item tertentu dalam kontainer.

Fungsi pencarian teks lengkap

	Description
FULLTEXTCONTAINS	Fungsi FULLTEXTCONTAINS mengembalikan boolean yang menunjukkan apakah ekspresi string kata kunci terkandung dalam jalur properti tertentu.
FULLTEXTCONTAINSALL	Fungsi FULLTEXTCONTAINSALL mengembalikan boolean yang menunjukkan apakah semua ekspresi string yang disediakan terkandung dalam jalur properti tertentu.
FULLTEXTCONTAINSANY	Fungsi mengembalikan FULLTEXTCONTAINSANY boolean yang menunjukkan apakah salah satu ekspresi string yang disediakan terkandung dalam jalur properti tertentu.
FULLTEXTSCORE	Fungsi mengembalikan FULLTEXTSCORE nilai skor BM25 yang hanya dapat digunakan dalam ORDER BY RANK klausul untuk mengurutkan hasil dari relevansi tertinggi ke relevansi terendah dari istilah yang ditentukan.
RRF	Fungsi mengembalikan RRF skor menyatu dengan menggabungkan dua skor atau lebih yang disediakan oleh fungsi lain.

Fungsi kondisional

	Description
IIF	Fungsi mengembalikan IIF salah satu dari dua nilai, tergantung pada apakah ekspresi Boolean mengevaluasi ke true atau false.

Fungsi pemeriksaan tipe

	Description
IS_ARRAY	Fungsi IS_ARRAY mengembalikan nilai boolean yang menunjukkan apakah jenis ekspresi yang ditentukan adalah array.
IS_BOOL	Fungsi IS_BOOL mengembalikan nilai boolean yang menunjukkan apakah jenis ekspresi yang ditentukan adalah boolean.
IS_DEFINED	Fungsi IS_DEFINED mengembalikan boolean yang menunjukkan apakah properti telah diberi nilai.
IS_FINITE_NUMBER	Fungsi IS_FINITE_NUMBER mengembalikan boolean yang menunjukkan apakah angka adalah angka terbatas (bukan tak terbatas).
IS_INTEGER	Fungsi IS_INTEGER mengembalikan boolean yang menunjukkan apakah angka adalah bilangan bulat bertanda tangan 64-bit. Bilangan bulat bertanda tangan 64-bit berkisar dari -9,223,372,036,854,775,808 hingga 9,223,372,036,854,775,807. Untuk informasi selengkapnya, lihat __int64.
IS_NULL	Fungsi IS_NULL mengembalikan nilai boolean yang menunjukkan apakah jenis ekspresi yang ditentukan adalah null.
IS_NUMBER	Fungsi IS_NUMBER mengembalikan nilai boolean yang menunjukkan apakah jenis ekspresi yang ditentukan adalah angka.
IS_OBJECT	Fungsi IS_OBJECT mengembalikan nilai boolean yang menunjukkan apakah jenis ekspresi yang ditentukan adalah objek JSON.
IS_PRIMITIVE	Fungsi IS_PRIMITIVE mengembalikan nilai boolean yang menunjukkan apakah jenis ekspresi yang ditentukan adalah primitif (string, boolean, numerik, atau null).
IS_STRING	Fungsi IS_STRING mengembalikan nilai boolean yang menunjukkan apakah jenis ekspresi yang ditentukan adalah string.
STRINGTONULL	Fungsi mengonversi STRINGTONULL ekspresi string menjadi null.
STRINGTONUMBER	Fungsi mengonversi STRINGTONUMBER ekspresi string menjadi angka.
STRINGTOOBJECT	Fungsi mengonversi STRINGTOOBJECT ekspresi string menjadi objek.

Fungsi spasial

	Description
ST_AREA	Fungsi mengembalikan ST_AREA area total ekspresi GeoJSON Polygon atau MultiPolygon.
ST_DISTANCE	Fungsi mengembalikan ST_DISTANCE jarak antara dua ekspresi GeoJSON Point, Polygon, MultiPolygon, atau LineString.
ST_INTERSECTS	Fungsi ST_INTERSECTS mengembalikan boolean yang menunjukkan apakah objek GeoJSON yang ditentukan dalam argumen pertama berpotongan objek GeoJSON dalam argumen kedua.
ST_ISVALID	Fungsi mengembalikan ST_ISVALID nilai boolean yang menunjukkan apakah ekspresi GeoJSON Point, Polygon, MultiPolygon, atau LineString yang ditentukan valid.
ST_ISVALIDDETAILED	Fungsi mengembalikan ST_ISVALIDDETAILED nilai JSON yang berisi nilai Boolean jika ekspresi GeoJSON Point, Polygon, atau LineString yang ditentukan valid, dan jika tidak valid, alasannya.
ST_WITHIN	Fungsi ST_WITHIN mengembalikan ekspresi boolean yang menunjukkan apakah objek GeoJSON yang ditentukan dalam argumen pertama berada dalam objek GeoJSON dalam argumen kedua.
VECTORDISTANCE	Fungsi mengembalikan VECTORDISTANCE skor kesamaan antara dua vektor yang ditentukan.