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(<表示式>, <為真時的結果>, <為假時的結果>)