Groovy 腳本語言 · Elasticsearch 5.4 中文文檔

# Groovy 腳本語言原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.3/modules-scripting-groovy.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/modules-scripting-groovy.html) 譯文鏈接 : [http://www.apache.wiki/pages/editpage.action?pageId=10027176](http://www.apache.wiki/pages/editpage.action?pageId=10027176) 貢獻者 : [@琴劍藍天](http://www.apache.wiki/users/viewuserprofile.action?username=xujie)，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina) 5.0.0中棄用。 Groovy將被新的腳本語言Painless所取代默認情況下，**Groovy** 可用于Elasticsearch。雖然受 **Java** 安全管理器限制，但它不是沙盒語言，默認情況下只能使用文件腳本。啟用內聯或存儲的Groovy腳本是一種安全風險，只有當您的Elasticsearch集群受到外部環境的保護時，才應該考慮。即使一個簡單的 _while（true）{}_ 循環也可能作為對您的集群的拒絕服務攻擊。 ?有關腳本的安全問題的詳細信息，請參閱[腳本和安全性](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/modules-scripting-security.html)，包括如何自定義類白名單。 ## Doc值屬性和方法 **Groovy** 中的 **Doc** 值支持以下屬性和方法（取決于底層字段類型）： _doc['field_name'].value_ ? ?? 字段的本機值。例如，如果它是一個短型，它會很短。 _doc['field_name'].values_ ? ??字段的本機數組值。例如，如果它是一個簡短的類型，它會很短[]。請記住，一個字段可以在單個文檔中具有多個值。如果該字段沒有值，則返回一個空數組。 _doc['field_name'].empty_ 一個布爾值，指示該字段在文檔中是否沒有值。 ?_doc['field_name'].lat_ 地理位置類型的緯度，或空值。 _doc['field_name'].lon_ 地理點類型的經度，或空值。 _doc['field_name'].lats_ ? ??地理點類型的緯度或空數組。 _doc['field_name'].lons_ ? ??地理點類型的經度，或空數組。 _doc['field_name'].arcDistance(lat, lon)_ ? ??該地理點字段與提供的緯度/距離的弧距（以米為單位）。 _doc['field_name'].arcDistanceWithDefault(lat, lon, default)_ ? ??該地理點字段與提供的lat / lon的弧距（以米為單位），具有空字段的默認值 _doc['field_name'].planeDistance(lat, lon)_ ? ??該地理點字段與提供的緯度/距離的平面距離（以米為單位）。 _doc['field_name'].planeDistanceWithDefault(lat, lon, default)_ ? ??該地理點字段與提供的lat / lon的平面距離（以米為單位），空字段的默認值 _doc['field_name'].geohashDistance(geohash)_ ? ??該地理位置字段與提供的geohash的弧距（以米為單位）。 _doc['field_name'].geohashDistanceWithDefault(geohash, default) _? ? ??來自提供的 _geohash_ 的該地理點字段的弧距（以米為單位），空字段的默認值 ## Groovy內置功能有幾個可以在腳本中使用的內置函數。他們包括： | 函數 | 描述 | | --- | --- | | `sin(a)` | 返回角度的三角正弦。 | | `cos(a)` | 返回角度的三角余弦。 | | `tan(a)` | 返回角度的三角正切。 | | `asin(a)` | 返回一個值的正弦。 | | `acos(a)` | 返回值的反余弦值。 | | `atan(a)` | 返回值的反正切值。 | | `toRadians``(angdeg)` | 將以度為單位的角度轉換為以弧度測量的大致相等的角度 | | `toDegrees``(angrad)` | 將以度為單位的角度轉換為以弧度測量的大致相等的角度 | | `exp(a)` | 返回歐拉的數字e提高到價值的力量。 | | `log(a)` | 返回歐拉的數字e提高到價值的力量。 | | `log10(a)` | 返回歐拉的數字e提高到價值的力量。 | | `sqrt(a)` | 返回歐拉的數字e提高到價值的力量。 | | `cbrt(a)` | 返回雙值的多維數據集根。 | | `IEEEremainder``(f1, f2)` | 根據IEEE 754標準計算兩個參數的余數運算。 | | `ceil(a)` | 返回大于或等于參數的最小（最接近負的無窮大）值，并且等于數學整數。 | | `floor(a)` | 返回小于或等于參數的最大（最接近正無窮大）的值，等于一個數學整數。 | | `rint(a)` | 返回與參數最接近的值，并等于數學整數。 | | `atan2(y, x)` | 從直角坐標（x，y）到極坐標（r，theta）的轉換返回角度θ。 | | `pow(a, b)` | 將第一個參數的值返回到第二個參數的冪。 | | `round(a)` | 返回最接近參數的int。 | | `random()` | 返回一個隨機雙重值。 | | `abs(a)` | 返回值的絕對值。 | | `max(a, b)` | 返回兩個值中的較大值。 | | `min(a, b)` | 返回兩個值中的較小值。 | | `ulp(d)` | 返回參數的ulp的大小。 | | `signum(d)` | 返回參數的signum函數。 | | `sinh(x)` | 返回值的雙曲正弦。 | | `cosh(x)` | 返回值的雙曲余弦值。 | | `tanh(x)` | 返回值的雙曲正切值。 | | `hypot(x, y)` | 返回sqrt（x2 + y2），沒有中間溢出或下溢。 |