Day14 NiFi - NiFi Expression Language - iT 邦幫忙::一起幫忙解決難題，拯救 IT 人的一天

What is the NEL?

NEL 我們可以想成他是在 NiFi 內建好的 function，根據官方文件，我們可以將大概分為以下幾類：

Boolean Logic
這一類簡單來說就是回傳一些 Bool 的 NEL，以及一些條件判斷的 NEL，ex. ifElse, isNull, equals, etc.

String Manipulation
這一類則是做一些字串的操作，例如大小寫轉換、append 字串、substring等相關字串應用。對應的 NEL 有 toUpper, toLower, trim, replace, etc.

Encode/Decode Functions
這一類則是將字串轉成特定格式的編碼，ex. escapeJson, escapeCsv, etc.

Searching
這一類則是搜尋字串內的字，或是做一些包含等判斷，ex. startWith, in, contains, matches, etc.

Mathematical Operations and Numeric Manipulation
這一類就很單純地是做一些數學運算的處理，ex. plus, minus, mod, etc.

Date Manipulation
這一類是做一些日期上的運算，ex. format, toDate, now, etc.

Type Corericon
這一類則是做些轉型的運算，ex. tostring, toNumber, toDecimal, etc.

Subjectless Functions
這一類則是用在不需要配合 Variables 的 NEL，像是要取的 ip, hostname 等，他可以直接 ${ip} , ${hostname} 來做呼叫，就不用像其他類 ${variables:function()} 這樣的方式做使用。

Evaluating Multiple Attributes
這一類則是針對多的 attributes 作處理和判斷，當然也可以用 and 或 or 等做運算，但 NiFi 也有提供類似的 NEL 來做類似的處理。

How to use?

在 NEL 的用法上，Variables 後面透過 : 來接 NEL function，就代表該 Variables 套用到這個 function上;此外，NEL 可採用 link-usage，也就是 Variables 後面可以接多的 NEL，範例如下：

${filename:toUpper():equals("HELLO.TXT")}
這個意思就是在 FlowFile 中的 filename 這個 attributes 的 value，先轉成大寫，接著判斷是否為 "HELLO.TXT"。所以可以發現，我們可以在後面接續著很多的 NEL function，這就是 Link-usage。
這裡我們在拿先前用到的例子來做簡單的說明，我們來看一下紅框中的 RouteOnAttribute Processor，如果大家還記得的話，這個 Processor 是可以由我們自定義 output 出去的 Connection：

其中內部的設定長得像這樣：

embark_c: ${embark:equals("C")}
embark_q: ${embark:equals("Q")}
embark_s: ${embark:equals("S")}
代表著流到這裡的 FlowFiles 都會有一個 embark 這個 attributes，我們希望當它等於 C 的時候流向 embark_c Connection; 等於 Q 的時候流向 embark_q Connection; 而等於 S 的時候則流向 embark_c 的 Connection。
所以我們就可以透過 NEL 搭配 Variables 來做一些處理及判斷，這樣的操作是不是相對簡單呢？
這邊再帶另外一個範例，是關於時間的操作，我們簡單拉一個 GenerateFlowFile 的 Processor 就好:

其中內部的設定長這樣:

datetime: ${now()}
timestamp: ${now():toNumber()}
today_format: ${now():format('yyyy-MM-dd')}
yesterday: ${now():toNumber():minus(86400000):format('yyyy-MM-dd')}
就可以看到 FlowFiles 會產生對應的 attributes:

所以透過這樣簡單的範例，想必大家都大概知道 NEL 是如何操作的了，今天這篇提了兩個簡單小範例，在系列文最後面會有一個比較大的場境應用，到時候也會有較複雜的 NEL 操作，但只要讀者們掌握好 NEL 的精髓和使用方式，其實就很容易上手了。
今天大概提了一下 NEL 的用法與操作，其實真的不難，只要掌握好原則，再搭配 document 的範例與說明，就能輕鬆將 attributes 處理成自己想要的樣子。
到這篇為止，大致上 NiFi 本身幾個重要的 Componenet 都介紹到一輪了，像是 Processor, Connection, Processor Group等，明天開始我們會進入到下一個環節，也就是與DB, Cloud 服務的對接說明，主要會拿 DB, AWS 和 GCP 來做一個介紹與範例，這樣的範例在實務上是很常用到的，同時也是非常重要的議題，所以接下來的幾篇，也要好好地學起來！
Reference
NiFi Expression Language