進階資料庫查詢插件

1.1 版本

注：JDK 版本：JDK 1.8 且小版本需在 JDK8u102 以上。

1.2 應用場景

FineReport 提供了簡單方便的連結各方資料的能力，要求客戶有基礎的 SQL 使用知識，通常的使用場景是客戶從其他地方獲取測試有效的 SQL 語句貼上到 FineReport ，比較麻煩。該插件提供了簡化 SQL 輸入，無縫對接 SQL 視覺化編輯工具的能力。

1.3 功能介紹

• 支援文法提示、自動補全(支援欄位名)和程式碼美化。

• 優化在 SQL 中加入帆軟公式支援。

• 支援視覺化的 SQL Builder。(只支援 mysql mssql oracle 等常用資料庫)。

• 視覺化生成參數過濾語句。

1.4 方案對比

對比項	當前方案	新方案
方案簡介	本文方法，透過安裝「進階資料庫查詢」插件實現	本文不做介紹 在 FineDataLink 中進行資料處理，一些視覺化算子，例如資料聯動、行轉列、列轉行、新增計算列，可幫您簡化 SQL 語句
介面對比		SQL 編輯器介面更加美觀
其他	該方案中，在 FineReport 中使用複雜 SQL 獲得目標資料，可能會導致報表開發成本高、維護成本高、取數慢的問題	可使用 FineDataLink 視覺化方式完成 資料加工 並進行業務註釋，FR 報表資料集只需要保留 select *  from table 的方式獲取結果指標資料，進而縮短 FR 資料集查詢時間，提升報表展示速度

2.1 插件安裝

點選下載插件：進階資料庫查詢

插件安裝方法參照 設計器插件管理

伺服器安裝插件方法參照 伺服器插件管理

2.2 操作方法

在插件商店安裝「進階資料庫查詢」後，建立「資料庫查詢」類型的資料集，資料庫查詢介面會預設更換為進階資料庫查詢。

在菜單欄「伺服器 -> 進階資料庫」中取消勾選 使用進階sql編輯器直接替代fr自帶編輯器 則可還原為FR預設編輯器。

2.2.1 定義資料連結按鈕

可直接點選點選下圖的第一步驟按鈕，進行新增定義資料連結。如下圖所示：

2.2.2 查看資料連結下的資料表

①為資料源，②為資料連結重新整理按鈕，③資料連結下的資料表。

2.2.3 自動補全介紹

• 點選①所在的按鈕，會跳出自動補全設定

• 其中③設定自動補全快捷鍵

•  ④，⑤新增高亮函式名和高亮關鍵字

• ⑥，⑦可自訂新增自動補全函式名，自動補全關鍵字。

• ②為是否開啟自動補全

2.2.4 視覺化 SQL 編輯器

點選①可進入視覺化編輯器，如下圖：

②為資料表，雙擊資料表可將此資料表的欄位新增到⑤中。

點選⑤中的勾選，可選用此欄位進行查詢。

點選⑥可對⑤所選的欄位進行重新命名，匯總，以及排序等。

④為文法選擇介面，可寫 SQL 語句進行操作，以及查看③操作過後的 SQL語句 。

2.2.5 參數注入

先書寫參數語句如①，然後再點選②重新整理顯示注入的參數。可在③查看參數是否新增成功，以及參數新增預設值。

視覺化插入參數注入

透過在②輸入[列名],[參數名]並選擇[元件類型]和是否[參數為空選擇全部]來生成參數注入語句,生成規則如下(會當前語句末尾是否有where或and來判斷是否生成and)

單選場景：

簡單參數篩選 列名='${參數名}'

參數為空選擇全部 ${if(len(參數名) == 0,"","and 列名 = '" + area + "'")}

多選場景：

簡單參數篩選 列名 in ('${replace(參數名,",","','")}')

參數為空選擇全部 ${if(len(參數名) == 0,"","and 列名 in ('" + replace(參數名,",","','") + "')")}

參數注入工具欄②預設顯示,可以透過點選①來顯示或隱藏

2.2.6 插入函式

點選①，進入②，使用 FR 的公式進行計算，點選確定後會將公式計算結果傳回給你資料集直接使用，如③。

2.2.7 其他按鈕介紹

①為SQL美化，②為使用分頁 SQL 編輯，③為查看執行SQL，④為 SQL 預覽按鈕，⑤為進階資料庫查詢最大化。

報表美化點選後 SQL 如下圖：

2.2.8 權限管理說明

權限管理用來配置在遠端設計器環境中，哪些人能夠看到哪些連結，哪些資料庫表，以便於進行報表設計。

管理者配置權限：

• 插件的安裝，遠端設計器，使用者本地設計器均需要安裝本插件

• 以管理者的身分連結遠端設計器

• 先到設計器的 伺服器--遠端設計權限管理 選單中配置哪些人能夠連結到遠端設計器

• 然後到 伺服器-進階資料庫查詢 選單中給這些能連結遠端設計器的人配置他們能看到哪些資料連結，哪些資料連結中的表

          左邊會將有連結遠端設計器權限的人列出來，右邊是所有的資料連結以及連結下的資料表

          左邊選中某人，右邊選擇他能看到的資料連結，資料表

          也可以多選使用者，點選批量設定來批量授權

• 配置好之後，使用者以自己的身分連結遠端設計器。他在做報表設計時，資料集選擇資料庫查詢，介面中只能看到上面勾選的連結跟表

3.1 自動補全

3.2 參數注入和插入函式

4.1 操作問題

1）雙擊表名會顯示欄位名然後自動補全中可以使用欄位名。

2）當自動補全不出現的時候按下 ctrl + space。

3）遠端設計時，超管需要給非超管開通權限才能使用。詳情請參見：給使用者分配遠端設計權限範例