系统函数 (Azure Cosmos DB)

适用于: SQL API

Cosmos DB 提供多个内置 SQL 函数。 内置函数的类别如下所示。

函数组 说明 操作
数组函数 该数组函数对数组输入值执行操作,并返回数值、布尔值或数组值。 ARRAY_CONCATARRAY_CONTAINSARRAY_LENGTHARRAY_SLICE
日期和时间函数 使用日期和时间函数可以获取采用以下两种格式的当前 UTC 日期和时间:一个时间戳,其值为以毫秒为单位的 Unix 纪元;一个符合 ISO 8601 格式的字符串。 GetCurrentDateTimeGetCurrentTimestampGetCurrentTicks
数学函数 每个数学函数均执行一个计算,通常基于作为参数提供的输出值,并返回数值。 ABSACOSASINATANATN2CEILINGCOSCOTDEGREESEXPFLOORLOGLOG10PIPOWERRADIANSRANDROUNDSIGNSINSQRTSQUARETANTRUNC
空间函数 该空间函数对控件对象输入值执行操作,并返回数值或布尔值。 ST_DISTANCEST_INTERSECTSST_ISVALIDST_ISVALIDDETAILEDST_WITHIN
字符串函数 该字符串函数对字符串输入值执行操作,并返回字符串、数值或布尔值。 CONCATCONTAINSENDSWITHINDEX_OFLEFTLENGTHLOWERLTRIMREGEXMATCHREPLACEREPLICATEREVERSERIGHTRTRIMSTARTSWITHStringToArrayStringToBooleanStringToNullStringToNumberStringToObjectSUBSTRINGToStringTRIMUPPER
类型检查函数 类型检查函数使你能够检查 SQL 查询内表达式的类型。 IS_ARRAYIS_BOOLIS_DEFINEDIS_NULLIS_NUMBERIS_OBJECTIS_PRIMITIVEIS_STRING

内置函数与用户定义函数 (UDF)

如果当前正在使用的用户定义的函数 (UDF) 有内置函数可用,则相应的内置函数会更快更有效地运行。

内置函数与 ANSI SQL 函数

Cosmos DB 函数与 ANSI SQL 函数之间的主要差别在于,Cosmos DB 函数能够很好地处理无架构数据和混合架构数据。 例如,如果某个属性缺失或包含类似于 undefined 的非数字值,则会跳过该项,而不是返回错误。

后续步骤