DocumentDB SQL-内置函数

Azure Cosmos DB 是一项多模型数据库服务，可以支持很多 API 和语言。其中，DocumentDB SQL API 是专为处理 JSON 文档而设计的。它是一种基于 SQL 的查询语言，支持很多强大的内置函数。本文将介绍 DocumentDB SQL 中的一些常用的内置函数。

数学函数

ABS

ABS 函数返回一个数字的绝对值。

SELECT ABS(-10) AS AbsValue

输出：

{ "AbsValue": 10 }

FLOOR

FLOOR 函数返回一个数字的最大整数部分。例如，FLOOR(2.8) 返回 2。

SELECT FLOOR(10.5) AS FloorValue

输出：

{ "FloorValue": 10 }

CEILING

CEILING 函数返回一个数字的最小整数部分。例如，CEILING(2.3) 返回 3。

SELECT CEILING(10.5) AS CeilingValue

输出：

{ "CeilingValue": 11 }

字符串函数

CONCAT

CONCAT 函数连接两个或多个字符串。

SELECT CONCAT("Hello, ", "World!") AS Greeting

输出：

{ "Greeting": "Hello, World!" }

UPPER

UPPER 函数将指定字符串中的所有字母转换为大写字母。

SELECT UPPER("Hello, World!") AS UpperGreeting

输出：

{ "UpperGreeting": "HELLO, WORLD!" }

LOWER

LOWER 函数将指定字符串中的所有字母转换为小写字母。

SELECT LOWER("Hello, World!") AS LowerGreeting

输出：

{ "LowerGreeting": "hello, world!" }

日期和时间函数

GETDATE

GETDATE 函数返回当前日期和时间。

SELECT GETDATE() AS CurrentDateTime

输出：

{ "CurrentDateTime": "2022-02-21T21:02:46Z" }

DATEPART

DATEPART 函数返回指定日期部分的整数值。其中，第一个参数是日期部分的名称，第二个参数是要提取该部分的日期值。

SELECT DATEPART(day, '2022-02-21') AS DayOfMonth

输出：

{ "DayOfMonth": 21 }

数组和对象函数

ARRAY_CONCAT

ARRAY_CONCAT 函数连接两个或多个数组，返回一个新的数组。

SELECT ARRAY_CONCAT([1, 2], [3, 4], [5]) AS ConcatenatedArray

输出：

{ "ConcatenatedArray": [1, 2, 3, 4, 5] }

OBJECT_VALUES

OBJECT_VALUES 函数返回对象中的所有值，返回值是一个数组。

SELECT OBJECT_VALUES({'foo': 1, 'bar': 2, 'baz': 3}) AS ObjectValues

输出：

{ "ObjectValues": [1, 2, 3] }

OBJECT_REMOVE

OBJECT_REMOVE 函数从对象中删除指定的键。

SELECT OBJECT_REMOVE({'foo': 1, 'bar': 2, 'baz': 3}, 'foo') AS ObjectWithoutFoo

输出：

{ "ObjectWithoutFoo": {"bar": 2, "baz": 3} }

总结

DocumentDB SQL 内置函数提供了很多强大的功能，特别是在处理 JSON 数据时非常实用。开发人员可以根据具体业务场景灵活使用这些内置函数，提高开发效率。本文介绍的仅仅是一些常用的内置函数，具体文档请参考官方文档。