İşlevler - Cosmos DB'de sorgu dili (Azure ve Doku'da)

Sorgu dili, sorgu dilinde yerleşik olarak bulunan ve çok çeşitli ortak görevleri işlemek için tasarlanmış bir dizi sistem işlevi içerir.

Functions

Sorgu dilinin şu anda desteklediği işlevlerin listesi aşağıdadır:

Matematiksel işlevler

	Description
ABS	işlevi, ABS belirtilen sayısal ifadenin mutlak (pozitif) değerini hesaplar.
ACOS	işlevi, ACOS belirtilen sayısal değerin trigonometrik arkkosinüsünü hesaplar. Arkkosinüs, kosinüsü belirtilen sayısal ifade olan radyan cinsinden açıdır.
ASIN	işlevi, ASIN belirtilen sayısal değerin trigonometrik arksinüsünü hesaplar. Arksinüs, sinüsü belirtilen sayısal ifade olan radyan cinsinden açıdır.
ATAN	işlevi, ATAN belirtilen sayısal değerin trigonometrik arktanjantını hesaplar. Arktanjant, tanjant değeri belirtilen sayısal ifade olan radyan cinsinden açıdır.
ATN2	ATN2 işlevi, radyan cinsinden ifade edilen arktanjantının y/xasıl değerini hesaplar.
CEILING	işlevi, CEILING belirtilen sayısal ifadeden büyük veya buna eşit en küçük tamsayı değerini hesaplar.
COS	işlevi radyan COS cinsinden belirtilen açının trigonometrik kosinüsünü hesaplar.
COT	işlevi radyan COT cinsinden belirtilen açının trigonometrik kotanjantını hesaplar.
DEGREES	İşlev, DEGREES radyan cinsinden belirtilen bir açı için karşılık gelen açıyı derece cinsinden hesaplar.
EXP	işlevi, EXP belirtilen sayısal ifadenin üstel değerini hesaplar.
FLOOR	İşlev, FLOOR belirtilen sayısal ifadeden küçük veya buna eşit en büyük tamsayıyı hesaplar.
INTADD	İşlev, INTADD iki tamsayı değerinin toplamını döndürür.
INTBITAND	İşlev, INTBITAND kapsayıcı and işlecini kullanarak her işlenenin bitlerinin karşılaştırmasını döndürür.
INTBITLEFTSHIFT	İşlev, INTBITLEFTSHIFT bir tamsayı değerinde bit düzeyinde sola kaydırma işleminin sonucunu döndürür.
INTBITNOT	İşlev, INTBITNOT tamsayı değerinde bit düzeyinde DEĞİl işleminin sonucunu döndürür.
INTBITOR	İşlev, INTBITOR iki tamsayı değeri üzerinde bit düzeyinde kapsayıcı OR işleminin sonucunu döndürür.
INTBITRIGHTSHIFT	İşlev, INTBITRIGHTSHIFT bir tamsayı değerinde bit düzeyinde sağ kaydırma işleminin sonucunu döndürür.
INTBITXOR	İşlev, INTBITXOR iki tamsayı değeri üzerinde bit düzeyinde özel OR işleminin sonucunu döndürür.
INTDIV	İşlev, INTDIV ilk tamsayı değerini saniyeye bölmenin sonucunu döndürür.
INTMOD	işlevi, INTMOD ilk tamsayı değerini saniyeye bölmenin kalan kısmını döndürür.
INTMUL	İşlev, INTMUL iki tamsayı değerinin çarpımını döndürür.
INTSUB	işlevi, INTSUB ikinci tamsayı değerini birinciden çıkarmanın sonucunu döndürür.
LOG	işlevi, LOG belirtilen sayısal ifadenin doğal logaritması döndürür.
LOG10	işlevi, LOG10 belirtilen sayısal ifadenin 10 tabanında logaritması döndürür.
NUMBERBIN	işlevi, NUMBERBIN belirtilen boyutun katlarına yuvarlanmış giriş değerini hesaplar.
PI	işlevi Pi PI sabit değerini döndürür.
POWER	İşlev, POWER belirtilen ifadenin değerini verilen sayıda kendi başına birden çok kez döndürür.
RADIANS	işlevi, RADIANS derece cinsinden belirtilen bir açı için radyan cinsinden karşılık gelen açıyı döndürür.
RAND	İşlev, RAND sıfırdan bire rastgele oluşturulmuş bir sayısal değer döndürür.
ROUND	İşlev, ROUND en yakın tamsayı değerine yuvarlanmış bir sayısal değer döndürür.
SIGN	İşlev, SIGN belirtilen sayısal ifadenin pozitif (+1), sıfır (0) veya negatif (-1) işaretini döndürür.
SIN	İşlev, SIN radyan cinsinden belirtilen açının trigonometrik sinüsünü döndürür.
SQRT	İşlev, SQRT belirtilen sayısal değerin karekökünü döndürür.
SQUARE	İşlev, SQUARE belirtilen sayısal değerin karesini döndürür.
TAN	işlevi radyan TAN cinsinden belirtilen açının trigonometrik tanjantını döndürür.
TRUNC	İşlev, TRUNC en yakın tamsayı değerine kesilmiş bir sayısal değer döndürür.

Dizi işlevleri

	Description
ARRAY_CONCAT	İşlev, ARRAY_CONCAT iki veya daha fazla dizi değerini birleştirmenin sonucu olan bir dizi döndürür.
ARRAY_CONTAINS_ALL	işlevi, ARRAY_CONTAINS_ALL dizinin belirtilen değerlerin tümünü içerip içermediğini gösteren bir boole döndürür.
ARRAY_CONTAINS_ANY	işlevi, ARRAY_CONTAINS_ANY dizinin belirtilen değerlerden herhangi birini içerip içermediğini gösteren bir boole döndürür.
ARRAY_CONTAINS	işlevi, ARRAY_CONTAINS dizinin belirtilen değeri içerip içermediğini gösteren bir boole döndürür. İşlev içinde boole ifadesi kullanarak nesnenin kısmi veya tam eşleşmesini de kontrol edebilirsiniz.
ARRAY_LENGTH	İşlev, ARRAY_LENGTH belirtilen dizi ifadesindeki öğelerin sayısını döndürür.
ARRAY_SLICE	işlevi, ARRAY_SLICE belirtilen dizini ve uzunluğu kullanarak bir dizi ifadesinin alt kümesini döndürür.
CHOOSE	İşlev, CHOOSE bir listenin belirtilen dizinindeki ifadeyi veya dizin listenin sınırlarını aşarsa Undefined değerini döndürür.
OBJECTTOARRAY	İşlev, OBJECTTOARRAY bir JSON nesnesindeki alan/değer çiftlerini JSON dizisine dönüştürür.
SETINTERSECT	işlevi, SETINTERSECT yinelenenleri olmayan her iki giriş dizisinde de bulunan ifade kümesini döndürür.
SETUNION	işlevi, SETUNION yinelenenleri olmayan iki toplanan kümedeki tüm ifadeleri içeren bir ifade kümesi döndürür.

Toplama işlevleri

	Description
AVG	işlevi, AVG ifadedeki değerlerin ortalamasını hesaplar.
COUNT	İşlev, COUNT ifadedeki değerlerin sayısını döndürür.
MAX	İşlev, MAX belirtilen ifadenin en büyük değerini döndürür.
MIN	İşlev, MIN belirtilen ifadenin en düşük değerini döndürür.
SUM	İşlev, SUM ifadedeki değerlerin toplamını hesaplar.

Dize işlevleri

	Description
CONCAT	İşlev, CONCAT bir belgeden birden çok alanı birleştirmenin sonucu olan bir dize döndürür.
CONTAINS	İşlev, CONTAINS ilk dize ifadesinin ikinci dize ifadesini içerip içermediğini belirten bir boole döndürür.
ENDSWITH	işlevi, ENDSWITH bir dizenin belirtilen sonekle bitip bitmediğini belirten bir boole döndürür. İsteğe bağlı olarak, karşılaştırma büyük/küçük harfe duyarlı olmayabilir.
INDEX-OF	işlevi, INDEX_OF bir dizenin ilk oluşumunun dizinini döndürür.
LEFT	İşlev, LEFT dizenin sol kısmını belirtilen karakter sayısına kadar döndürür.
LENGTH	İşlev, LENGTH belirtilen dize ifadesindeki karakter sayısını döndürür.
LOWER	işlevi, LOWER büyük harf karakter verilerini küçük harfe dönüştürdükten sonra bir dize ifadesi döndürür.
LTRIM	İşlev, LTRIM baştaki boşlukları veya belirtilen karakterleri kaldırdıktan sonra bir dize ifadesi döndürür.
REGEXMATCH	işlevi, REGEXMATCH sağlanan dizenin belirtilen normal ifadeyle eşleşip eşleşmediğini belirten bir boole döndürür. Normal ifadeler, metin desenlerini bulmaya yönelik kısa ve esnek bir gösterimidir.
REPLACE	işlevi, REPLACE belirtilen dizenin tüm oluşumlarının değiştirilip değiştirilmedi olduğu bir dize döndürür.
REPLICATE	İşlev, REPLICATE belirli bir sayıda tekrarlanan bir dize değeri döndürür.
REVERSE	işlevi bir REVERSE dize değerinin ters sırasını döndürür.
RIGHT	İşlev, RIGHT belirtilen karakter sayısına kadar bir dizenin sağ bölümünü döndürür.
RTRIM	İşlev, RTRIM sondaki boşlukları veya belirtilen karakterleri kaldırdıktan sonra bir dize ifadesi döndürür.
STARTSWITH	işlevi, STARTSWITH ilk dize ifadesinin ikincisiyle başlayıp başlamadığını belirten bir boole değeri döndürür.
STRINGEQUALS	İşlev, STRINGEQUALS ilk dize ifadesinin ikinciyle eşleşip eşleşmediğini gösteren bir boole döndürür.
STRINGJOIN	STRINGJOIN işlevi, her öğe arasında belirtilen ayırıcıyı kullanarak belirtilen dizinin öğelerini birleştirir bir dize döndürür.
STRINGSPLIT	işlevi, STRINGSPLIT kaynak dizeyi belirtilen sınırlayıcıya göre ayırmaktan elde edilen bir alt dize dizisi döndürür.
STRINGTOARRAY	işlevi bir STRINGTOARRAY dize ifadesini diziye dönüştürür.
STRINGTOBOOLEAN	işlevi bir STRINGTOBOOLEAN dize ifadesini boole değerine dönüştürür.
SUBSTRING	İşlev, SUBSTRING belirtilen konumdan ve belirtilen uzunluktan başlayarak dize ifadesinin bir bölümünü veya dizenin sonuna döndürür.
TOSTRING	işlevi bir TOSTRING değerin dize gösterimini döndürür.
TRIM	İşlev, TRIM baştaki ve sondaki boşluk veya özel karakterleri kaldırdıktan sonra bir dize ifadesi döndürür.
UPPER	işlevi, UPPER küçük harf karakter verilerini büyük harfe dönüştürdükten sonra bir dize ifadesi döndürür.

Tarih ve saat işlevleri

	Description
DATETIMEADD	İşlev, DATETIMEADD belirtilen sayı değerini sağlanan tarih ve saat dizesine eklemenin sonucu olan bir tarih ve saat dizesi değeri döndürür.
DATETIMEBIN	İşlev, DATETIMEBIN sağlanan tarih ve saat dizesinin bir bölümünü gruplandırma (veya yuvarlama) sonucu olan bir tarih ve saat dizesi değeri döndürür.
DATETIMEDIFF	DATETIMEDIFF İşlev, belirtilen tarih ve saat bölümünün iki tarih ve saat değeri arasındaki farkını imzalı bir tamsayı olarak döndürür.
DATETIMEFROMPARTS	İşlev, DATETIMEFROMPARTS çeşitli tarih ve saat bölümleri için giriş sayısal değerlerinden bir tarih ve saat dizesi değeri döndürür.
DATETIMEPART	İşlev, DATETIMEPART sağlanan tarih ve saat için belirtilen tarih ve saat bölümünün değerini döndürür.
DATETIMETOTICKS	İşlev, DATETIMETOTICKS belirtilen DateTime değerini onay işaretine dönüştürür. Tek bir değer çizgisi 100 nanosaniyeyi veya saniyenin 0,0000001'ini temsil eder.
DATETIMETOTIMESTAMP	İşlev, DATETIMETOTIMESTAMP belirtilen tarih ve saati sayısal bir zaman damgasına dönüştürür. Zaman damgası, Unix dönemlerinden bu yana milisaniyeleri ölçen imzalı bir sayısal tamsayıdır.
GETCURRENTDATETIME	İşlev, GETCURRENTDATETIME geçerli UTC (Eşgüdümlü Evrensel Saat) tarih ve saatini ISO 8601 dizesi olarak döndürür.
GETCURRENTDATETIMESTATIC	İşlev, GETCURRENTDATETIMESTATIC sorgudaki tüm öğeler için ISO 8601 dizesiyle aynı UTC tarih ve saat değerini döndürür. Bu, sorgu sonuçları arasında tutarlı zaman damgaları için kullanışlıdır.
GETCURRENTTICKS	İşlev, GETCURRENTTICKS geçerli UTC saatini 0001-01-01T00:00:00.0000000Z'den bu yana geçen 100 nanosaniyelik aralıkların (değer işaretleri) sayısı olarak döndürür.
GETCURRENTTICKSSTATIC	İşlev, GETCURRENTTICKSSTATIC aynı bölümdeki tüm öğeler için statik bir nanosaniyelik değer (Unix dönemi boyunca 100 nanosaniyelik aralıklar) döndürür.
GETCURRENTTIMESTAMP	İşlev, GETCURRENTTIMESTAMP Unix dönemlerinden bu yana milisaniye cinsinden geçerli zaman damgasını döndürür.
GETCURRENTTIMESTAMPSTATIC	İşlev, GETCURRENTTIMESTAMPSTATIC aynı bölümdeki tüm öğeler için statik bir zaman damgası değeri (Unix döneminin ardından milisaniye) döndürür.
TICKSTODATETIME	İşlev, TICKSTODATETIME belirtilen değer sayısını tarih ve saat değerine dönüştürür.
TIMESTAMPTODATETIME	İşlev, TIMESTAMPTODATETIME belirtilen zaman damgasını tarih ve saat değerine dönüştürür.

Öğe işlevleri

	Description
DOCUMENTID	işlevi, DOCUMENTID kapsayıcıdaki belirli bir öğenin benzersiz belge kimliğini döndürür.

Tam metin arama işlevleri

	Description
FULLTEXTCONTAINS	İşlev, FULLTEXTCONTAINS anahtar sözcük dizesi ifadesinin belirtilen özellik yolunda bulunup bulunmadığını belirten bir boole döndürür.
FULLTEXTCONTAINSALL	işlevi, FULLTEXTCONTAINSALL sağlanan tüm dize ifadelerinin belirtilen özellik yolunda bulunup bulunmadığını gösteren bir boole döndürür.
FULLTEXTCONTAINSANY	İşlev, FULLTEXTCONTAINSANY sağlanan dize ifadelerinden herhangi birinin belirtilen özellik yolunda bulunup bulunmadığını belirten bir boole döndürür.
FULLTEXTSCORE	İşlev, FULLTEXTSCORE sonuçları belirtilen terimlerin en yüksek ilgisinden en düşük ilgisine sıralamak için yalnızca yan tümcesinde kullanılabilen bir ORDER BY RANK BM25 puan değeri döndürür.
RRF	İşlev, RRF diğer işlevler tarafından sağlanan iki veya daha fazla puanı birleştirerek birleştirilmiş puan döndürür.

Koşullu işlevler

	Description
IIF	İşlev, IIF Boole ifadesinin true veya false olarak değerlendirilip değerlendirilmediğine bağlı olarak iki değerden birini döndürür.

Tür denetimi işlevleri

	Description
IS_ARRAY	işlevi, IS_ARRAY belirtilen ifadenin türünün bir dizi olup olmadığını belirten bir boole değeri döndürür.
IS_BOOL	İşlev, IS_BOOL belirtilen ifadenin türünün boole olup olmadığını belirten bir boole değeri döndürür.
IS_DEFINED	İşlev, IS_DEFINED özelliğe bir değer atanıp atanmadığını belirten bir boole döndürür.
IS_FINITE_NUMBER	işlevi, sayının IS_FINITE_NUMBER sonlu bir sayı olup olmadığını (sonsuz değil) belirten bir boole döndürür.
IS_INTEGER	İşlev, sayının IS_INTEGER 64 bit işaretli bir tamsayı olup olmadığını gösteren bir boole döndürür. 64 bit imzalı tamsayılar ile arasında -9,223,372,036,854,775,8089,223,372,036,854,775,807değişir. Daha fazla bilgi için bkz. __int64.
IS_NULL	İşlev, IS_NULL belirtilen ifadenin nulltürünün olup olmadığını belirten bir boole değeri döndürür.
IS_NUMBER	işlevi, IS_NUMBER belirtilen ifadenin türünün bir sayı olup olmadığını belirten bir boole değeri döndürür.
IS_OBJECT	İşlev, IS_OBJECT belirtilen ifadenin türünün bir JSON nesnesi olup olmadığını belirten bir boole değeri döndürür.
IS_PRIMITIVE	İşlev, IS_PRIMITIVE belirtilen ifadenin türünün ilkel (dize, boole, sayısal veya null) olup olmadığını belirten bir boole değeri döndürür.
IS_STRING	işlevi, IS_STRING belirtilen ifadenin türünün bir dize olup olmadığını belirten bir boole değeri döndürür.
STRINGTONULL	STRINGTONULL işlevi bir dize ifadesini öğesine nulldönüştürür.
STRINGTONUMBER	işlevi bir STRINGTONUMBER dize ifadesini sayıya dönüştürür.
STRINGTOOBJECT	işlevi bir STRINGTOOBJECT dize ifadesini nesneye dönüştürür.

Uzamsal işlevler

	Description
ST_AREA	İşlev, ST_AREA GeoJSON Çokgen veya MultiPolygon ifadesinin toplam alanını döndürür.
ST_DISTANCE	İşlev, ST_DISTANCE iki GeoJSON Noktası, ÇokGen, MultiPolygon veya LineString ifadesi arasındaki uzaklığı döndürür.
ST_INTERSECTS	İşlev, ST_INTERSECTS ilk bağımsız değişkende belirtilen GeoJSON nesnesinin ikinci bağımsız değişkendeki GeoJSON nesnesiyle kesişip kesişmediğini gösteren bir boole döndürür.
ST_ISVALID	İşlev, ST_ISVALID belirtilen GeoJSON Noktası, ÇokGen, MultiPolygon veya LineString ifadesinin geçerli olup olmadığını belirten bir boole değeri döndürür.
ST_ISVALIDDETAILED	İşlev, ST_ISVALIDDETAILED belirtilen GeoJSON Noktası, ÇokGen veya LineString ifadesi geçerliyse ve geçersizse nedeni boole değeri içeren bir JSON değeri döndürür.
ST_WITHIN	İşlev, ST_WITHIN ilk bağımsız değişkende belirtilen GeoJSON nesnesinin ikinci bağımsız değişkendeki GeoJSON nesnesi içinde olup olmadığını gösteren bir boole ifadesi döndürür.
VECTORDISTANCE	İşlev, VECTORDISTANCE belirtilen iki vektör arasındaki benzerlik puanını döndürür.