OrientDB - 函数

本章解释了 OrientDB 中不同类型函数的完整参考。下表定义了函数列表，按其功能分类。

图函数

用于操作图数据的函数。

序号	函数名称及描述
1	Out() 从当前记录（作为顶点）开始获取相邻的输出顶点。语法 − out([<标签-1>][,<标签-n>]*)
2	In() 从当前记录（作为顶点）开始获取相邻的输入顶点。语法 − in([<标签-1>][,<标签-n>]*)
3	Both() 从当前记录（作为顶点）开始获取相邻的输出和输入顶点。语法 − both([<标签1>][,<标签-n>]*)
4	outE() 从当前记录（作为顶点）开始获取相邻的输出边。语法 − outE([<标签1>][,<标签-n>]*)
5	inE() 从当前记录（作为顶点）开始获取相邻的输入边。语法 − inE([<标签1>][,<标签-n>]*)
6	bothE() 从当前记录（作为顶点）开始获取相邻的输出和输入边。语法 − bothE([<标签1>][,<标签-n>]*)
7	outV() 从当前记录（作为边）开始获取输出顶点。语法 − outV()
8	inV() 从当前记录（作为边）获取输入顶点。语法 − inV()
9	traversedElement() 返回 Traverse 命令中遍历的元素。语法 − traversedElement(<索引> [,<项目>])
10	traversedVertex() 返回 Traverse 命令中遍历的顶点。语法 − traversedVertex(<索引> [,<项目>])
11	traversedEdge() 返回 Traverse 命令中遍历的边。语法 − traversedEdge(<索引> [,<项目>])
12	shortestPath() 返回两个顶点之间的最短路径。方向可以是 OUT（默认）、IN 或 BOTH。语法 − shortestPath( <源顶点>, <目标顶点> [, <方向> [, <边类名>]])
13	dijkstra() 使用 Dijkstra 算法返回两个顶点之间的最廉价路径。语法 − dijkstra(<源顶点>, <目标顶点>, <权重边字段名> [, <方向>])

尝试一些图函数以及以下查询。

执行以下查询以获取所有车辆顶点的所有输出顶点。

orientdb {db = demo}>SELECT out() from Vehicle

如果以上查询成功执行，您将获得以下输出。

---+----------+--------- 
 # | @class   | out 
---+----------+--------- 
 0 | Vehicle  | #11:2 
 1 | Vehicle  | #13:1 
 2 | Vehicle  | #13:4 
---+----------+---------

执行以下查询以获取顶点 #11:3 的输入和输出顶点。

orientdb {db = demo}>SELECT both() FROM #11:3

如果以上查询成功执行，您将获得以下输出。

---+----------+--------+------- 
 # | @class   | out    | in  
---+----------+--------+------- 
 0 | Vehicle  | #13:2  | #10:2   
 ---+----------+-------+-------

数学函数

下表定义了用于执行数学表达式的数学函数列表。

序号	函数名称及描述
1	eval() 计算引号（或双引号）之间的表达式。语法 − eval('<表达式>')
2	min() 返回最小值。如果使用多个参数调用，则返回所有参数之间的最小参数值。语法 − min(<字段> [, <字段-n>]* )
3	max() 返回最大值。如果使用多个参数调用，则返回所有参数之间的最大值。语法 − max(<字段> [, <字段-n>]* )
4	sum() 返回所有返回值的总和。语法 − sum(<字段>)
5	abs() 返回绝对值。它适用于整数、长整数、短整数、双精度浮点数、浮点数、大整数、BigDecimal、null。语法 − abs(<字段>)
6	avg() 返回平均值。语法 − avg(<字段>)
7	count() 计算匹配查询条件的记录数。如果未使用 * 作为字段，则仅当内容不为空时才计算记录。语法 − count(<字段>)
8	mode() 返回出现频率最高的那个值。计算时忽略空值。语法 − mode(<字段>)
9	median() 返回中间值或表示中间值的插值，在值排序后。计算时忽略空值。语法 − median(<字段>)
10	percentile() 返回第 n 个百分位数。计算时忽略空值。语法 − percentile(<字段> [, <分位数-n>]*)
11	variance() 返回中间方差：均值平方差的平均值。语法 − variance(<字段>)
12	stddev() 返回标准差：衡量值分散程度的指标。计算时忽略空值。语法 − stddev(<字段>)

尝试使用以下查询的一些数学函数。

执行以下查询以获取所有员工的薪资总和。

orientdb {db = demo}>SELECT SUM(salary) FROM Employee

如果以上查询成功执行，您将获得以下输出。

---+----------+--------- 
 # | @CLASS   | sum 
---+----------+--------- 
 0 | null     | 150000 
---+----------+---------

执行以下查询以获取所有员工的平均薪资。

orientdb {db = demo}>SELECT avg(salary) FROM Employee

如果以上查询成功执行，您将获得以下输出。

---+----------+--------- 
 # | @CLASS   | avg 
---+----------+--------- 
 0 | null     | 25 
---+----------+---------

集合函数

下表定义了操作集合数据的函数列表。

序号	函数名称及描述
1	set() 向集合添加值。如果该值为集合，则将其与集合合并，否则添加 <值>。语法 − set(<字段>)
2	map() 第一次创建映射时向映射添加值。如果 <值> 是映射，则将其与映射合并，否则将 <键> 和 <值> 对作为新条目添加到映射中。语法 − map(<键>, <值>)
3	ist() 第一次创建列表时向列表添加值。如果 <值> 是集合，则将其与列表合并，否则将 <值> 添加到列表中。语法 − list(<字段>)
4	difference() 用作聚合或内联。如果只传递一个参数，则聚合，否则执行并返回作为参数接收的集合之间的差值。语法 − difference(<字段> [,<字段-n>]*)
5	first() 仅检索多值字段（数组、集合和映射）的第一个项目。对于非多值类型，只需返回该值。语法 − first(<字段>)
6	intersect() 用作聚合或内联。如果只传递一个参数，则聚合，否则执行并返回作为参数接收的集合的交集。语法 − intersect(<字段> [,<字段-n>]*)
7	distinct() 根据您指定为参数的字段检索唯一的数据条目。与标准 SQL DISTINCT 的主要区别在于，使用 OrientDB，可以指定带括号且只有一个字段的函数。语法 − distinct(<字段>)
8	expand() 此函数有两个含义：在集合字段上使用时，它会展开字段中的集合并将其用作结果。在链接（RID）字段上使用时，它会展开该链接指向的文档。语法 − expand(<字段>)
9	unionall() 用作聚合或内联。如果只传递一个参数，则聚合，否则执行并返回作为参数接收的所有集合的并集。也适用于没有集合值的场景。语法 − unionall(<字段> [,<字段-n>]*)
10	flatten() 提取字段中的集合并将其用作结果。已弃用，请改用 expand()。语法 − flatten(<字段>)
11	last() 仅检索多值字段（数组、集合和映射）的最后一个项目。对于非多值类型，只需返回该值。语法 − last(<字段>)
12	symmetricDifference() 用作聚合或内联。如果只传递一个参数，则聚合，否则执行并返回作为参数接收的集合的对称差。语法 − symmetricDifference(<字段> [,<字段-n>]*)

尝试使用以下查询的一些集合函数。

执行以下查询以获取教授九年级课程的教师集合。

orientdb {db = demo}>SELECT ID, set(teacher.id) AS teacherID from classess where class_id = 9

如果以上查询成功执行，您将获得以下输出。

---+----------+--------+-------------------------- 
 # | @CLASS   | id     | TeacherID 
---+----------+--------+-------------------------- 
 0 | null     | 9     |   1201, 1202, 1205, 1208 
---+----------+-------+---------------------------

其他函数

下表定义了执行其他操作的函数列表。

序号	函数名称及描述
1	date() 返回格式化字符串的日期。<日期作为字符串> 是字符串格式的日期，<格式> 是遵循以下规则的日期格式。语法 − date( <日期字符串> [<格式>] [,<时区>] )
2	sysdate() 返回当前日期和时间。语法 − sysdate( [<格式>] [,<时区>] )
3	format() 使用 String.format() 约定格式化值。语法 − format( <格式> [,<参数1> ](,<参数n>]*.md)
4	distance() 使用 Haversine 算法返回地球上两点之间的距离。坐标必须为度。语法 − distance( <x字段>, <y字段>, <x值>, <y值> )
5	ifnull() 返回传递的字段/值（或可选参数 return_value_if_not_null）。如果字段/值不为空，则返回 return_value_if_null。语法 − ifnull(<字段\|值>, <为空时返回值> [,<不为空时返回值>](,<字段&.md#124;值>]*)
6	coalesce() 返回第一个非空字段/值参数。如果所有字段/值都为空，则返回 null。语法 − coalesce(<字段\|值> [, <字段n\|值n>]*)
7	uuid() 使用 Leach-Salz 变体生成一个 128 位的 UUID 值。语法 − uuid()
8	if() 评估条件（第一个参数），如果条件为真，则返回第二个参数，否则返回第三个参数。语法 − if(<表达式>, <为真时的结果>, <为假时的结果>)

使用以下查询尝试一些杂项函数。

执行以下查询以了解如何执行 if 表达式。

orientdb {db = demo}> SELECT if(eval("name = 'satish'"), "My name is satish", 
"My name is not satish") FROM Employee

如果以上查询成功执行，您将获得以下输出。

----+--------+----------------------- 
#   |@CLASS  | IF 
----+--------+----------------------- 
0   |null    |My name is satish  
1   |null    |My name is not satish 
2   |null    |My name is not satish  
3   |null    |My name is not satish  
4   |null    |My name is not satish  
----+--------+------------------------

执行以下查询以获取系统日期。

orientdb {db = demo}> SELECT SYSDATE() FROM Employee

如果以上查询成功执行，您将获得以下输出。

----+--------+----------------------- 
#   |@CLASS  | SYSDATE 
----+--------+----------------------- 
0   |null    |2016-02-10 12:05:06 
1   |null    |2016-02-10 12:05:06 
2   |null    |2016-02-10 12:05:06 
3   |null    |2016-02-10 12:05:06 
4   |null    |2016-02-10 12:05:06 
----+--------+------------------------

通过彻底使用此函数，您可以轻松地操作 OrientDB 数据。

打印页面

序号	函数名称及描述
1	Out() 从当前记录（作为顶点）开始获取相邻的输出顶点。语法 − out([<标签-1>][,<标签-n>]*)
2	In() 从当前记录（作为顶点）开始获取相邻的输入顶点。语法 − in([<标签-1>][,<标签-n>]*)
3	Both() 从当前记录（作为顶点）开始获取相邻的输出和输入顶点。语法 − both([<标签1>][,<标签-n>]*)
4	outE() 从当前记录（作为顶点）开始获取相邻的输出边。语法 − outE([<标签1>][,<标签-n>]*)
5	inE() 从当前记录（作为顶点）开始获取相邻的输入边。语法 − inE([<标签1>][,<标签-n>]*)
6	bothE() 从当前记录（作为顶点）开始获取相邻的输出和输入边。语法 − bothE([<标签1>][,<标签-n>]*)
7	outV() 从当前记录（作为边）开始获取输出顶点。语法 − outV()
8	inV() 从当前记录（作为边）获取输入顶点。语法 − inV()
9	traversedElement() 返回 Traverse 命令中遍历的元素。语法 − traversedElement(<索引> [,<项目>])
10	traversedVertex() 返回 Traverse 命令中遍历的顶点。语法 − traversedVertex(<索引> [,<项目>])
11	traversedEdge() 返回 Traverse 命令中遍历的边。语法 − traversedEdge(<索引> [,<项目>])
12	shortestPath() 返回两个顶点之间的最短路径。方向可以是 OUT（默认）、IN 或 BOTH。语法 − shortestPath( <源顶点>, <目标顶点> [, <方向> [, <边类名>]])
13	dijkstra() 使用 Dijkstra 算法返回两个顶点之间的最廉价路径。语法 − dijkstra(<源顶点>, <目标顶点>, <权重边字段名> [, <方向>])

序号	函数名称及描述
1	eval() 计算引号（或双引号）之间的表达式。语法 − eval('<表达式>')
2	min() 返回最小值。如果使用多个参数调用，则返回所有参数之间的最小参数值。语法 − min(<字段> [, <字段-n>]* )
3	max() 返回最大值。如果使用多个参数调用，则返回所有参数之间的最大值。语法 − max(<字段> [, <字段-n>]* )
4	sum() 返回所有返回值的总和。语法 − sum(<字段>)
5	abs() 返回绝对值。它适用于整数、长整数、短整数、双精度浮点数、浮点数、大整数、BigDecimal、null。语法 − abs(<字段>)
6	avg() 返回平均值。语法 − avg(<字段>)
7	count() 计算匹配查询条件的记录数。如果未使用 * 作为字段，则仅当内容不为空时才计算记录。语法 − count(<字段>)
8	mode() 返回出现频率最高的那个值。计算时忽略空值。语法 − mode(<字段>)
9	median() 返回中间值或表示中间值的插值，在值排序后。计算时忽略空值。语法 − median(<字段>)
10	percentile() 返回第 n 个百分位数。计算时忽略空值。语法 − percentile(<字段> [, <分位数-n>]*)
11	variance() 返回中间方差：均值平方差的平均值。语法 − variance(<字段>)
12	stddev() 返回标准差：衡量值分散程度的指标。计算时忽略空值。语法 − stddev(<字段>)

序号	函数名称及描述
1	set() 向集合添加值。如果该值为集合，则将其与集合合并，否则添加 <值>。语法 − set(<字段>)
2	map() 第一次创建映射时向映射添加值。如果 <值> 是映射，则将其与映射合并，否则将 <键> 和 <值> 对作为新条目添加到映射中。语法 − map(<键>, <值>)
3	ist() 第一次创建列表时向列表添加值。如果 <值> 是集合，则将其与列表合并，否则将 <值> 添加到列表中。语法 − list(<字段>)
4	difference() 用作聚合或内联。如果只传递一个参数，则聚合，否则执行并返回作为参数接收的集合之间的差值。语法 − difference(<字段> [,<字段-n>]*)
5	first() 仅检索多值字段（数组、集合和映射）的第一个项目。对于非多值类型，只需返回该值。语法 − first(<字段>)
6	intersect() 用作聚合或内联。如果只传递一个参数，则聚合，否则执行并返回作为参数接收的集合的交集。语法 − intersect(<字段> [,<字段-n>]*)
7	distinct() 根据您指定为参数的字段检索唯一的数据条目。与标准 SQL DISTINCT 的主要区别在于，使用 OrientDB，可以指定带括号且只有一个字段的函数。语法 − distinct(<字段>)
8	expand() 此函数有两个含义：在集合字段上使用时，它会展开字段中的集合并将其用作结果。在链接（RID）字段上使用时，它会展开该链接指向的文档。语法 − expand(<字段>)
9	unionall() 用作聚合或内联。如果只传递一个参数，则聚合，否则执行并返回作为参数接收的所有集合的并集。也适用于没有集合值的场景。语法 − unionall(<字段> [,<字段-n>]*)
10	flatten() 提取字段中的集合并将其用作结果。已弃用，请改用 expand()。语法 − flatten(<字段>)
11	last() 仅检索多值字段（数组、集合和映射）的最后一个项目。对于非多值类型，只需返回该值。语法 − last(<字段>)
12	symmetricDifference() 用作聚合或内联。如果只传递一个参数，则聚合，否则执行并返回作为参数接收的集合的对称差。语法 − symmetricDifference(<字段> [,<字段-n>]*)

序号	函数名称及描述
1	date() 返回格式化字符串的日期。<日期作为字符串> 是字符串格式的日期，<格式> 是遵循以下规则的日期格式。语法 − date( <日期字符串> [<格式>] [,<时区>] )
2	sysdate() 返回当前日期和时间。语法 − sysdate( [<格式>] [,<时区>] )
3	format() 使用 String.format() 约定格式化值。语法 − format( <格式> [,<参数1> ](,<参数n>]*.md)
4	distance() 使用 Haversine 算法返回地球上两点之间的距离。坐标必须为度。语法 − distance( <x字段>, <y字段>, <x值>, <y值> )
5	ifnull() 返回传递的字段/值（或可选参数 return_value_if_not_null）。如果字段/值不为空，则返回 return_value_if_null。语法 − ifnull(<字段\|值>, <为空时返回值> [,<不为空时返回值>](,<字段&.md#124;值>]*)
6	coalesce() 返回第一个非空字段/值参数。如果所有字段/值都为空，则返回 null。语法 − coalesce(<字段\|值> [, <字段n\|值n>]*)
7	uuid() 使用 Leach-Salz 变体生成一个 128 位的 UUID 值。语法 − uuid()
8	if() 评估条件（第一个参数），如果条件为真，则返回第二个参数，否则返回第三个参数。语法 − if(<表达式>, <为真时的结果>, <为假时的结果>)