1. 概述
通過選項,可以不需要設計器,直接新建數據連接,還可以查看當前報表連接了哪些數據庫,并且進行修改。設計器可以創建 JNDI 數據連接 和 多維數據連接 ,平台創建的數據連接在設計器裏也可以進行管理。
詳細點擊 [設計器] JDBC 連接數據庫
2. 創建數據連接
以管理員身份進入數據決策系統,點擊「管理系統>數據連接>數據連接管理>新建數據連接」可創建新的數據連接,如下圖所示:
注:如果非管理員用戶想要配置數據連接,需要管理員給其分配管理系統下數據連接節點的權限,具體操作請查看 數據連接控制
3. 選擇數據庫類型
單擊「新建數據連接」按鈕,有三種類型選擇,分别爲常用,所有,其他。如下圖所示:
3.1 常用
固定顯示幾個常用的數據庫類型,分别爲 HSQL、IBM DB2、Microsoft SQL Server、MySQL、Oracle。如下圖所示:
3.2 所有
FineReport 設計器所有支持的數據庫類型,分别爲:ADS、Amazon Redshift、Apache Impala、Apache KYLIN、Apache Phoenix、DERBY、GBase 8A、GBase 8S、GBase 8T、H2、華爲雲DWS、Fusioninsight elk、Fusioninsight HD、GaussDB 200、Hadoop Hive、HBase、HP Vertica、HSQL、IBM DB2、INFORMIX、KINGBASE、Microsoft SQL Server、MySQL、Oracle、Pivotal Greenplum Database、Postgresql、Presto、SAP HANA、SAP Sybase、SPARK、SqLite、TeraData、TRANSWARP INCEPTOR,如下圖所示:
主要介紹如下所示:
「内置支持」和「插件支持」默認兩個都勾選。
左側切換數據庫類型後,「内置支持」和「插件支持」恢複默認狀态。
可通過「内置支持」和「插件支持」的勾選,對數據庫類型進行篩選;若都不勾選,則顯示空白。
3.3 其他
「其他」類型中包括JNDI數據連接,其他JDBC。如下圖所示:
主要介紹如下所示:
新建數據連接包括 JDBC 數據連接和 JNDI 數據連接,和已适配的第三方數據源插件。
平台未适配的數據連接,平台中只能讀取到數據源的名字,無法新建、編輯及查看具體的設置,只能在設計器中進行新建、編輯和查看。
3.3.1 JNDI 數據連接
在「其他」類型中選擇「JNDI數據連接 」,如下圖所示:
注:JNDI 數據連接請參考 JNDI數據連接
3.3.2 其他 JDBC
如果數據庫列表中沒有所需的數據庫類型,則選擇「其他JDBC 」。
将對應驅動包放置在%FR_HOME%\webapps\webroot\WEB-INF\lib下面并重啓報表服務器。
在「其他」類型中選擇「其他JDBC」,手動輸入驅動器名稱、URL 等完整數據連接信息,點擊「測試連接」連接成功後,點擊「保存」即可。如下圖所示:
1)數據連接信息:數據連接名稱、驅動器、URL、編碼(推薦直接選自動即可,2018-12-27 及以後的 JAR 開始支持)、用戶名、密碼。
2)測試連接:測試數據庫配置是否成功,若成功則彈出「連接成功」,若失敗則顯示失敗詳細原因。
4. 配置信息介紹
具體配置信息請根據實際數據庫參考對應文檔進行配置。
不同數據庫需配置的信息可能有所不同,下面介紹「模式」和「認證方式」這兩個屬性的具體信息。
4.1 模式
在連接 Amazon Redshift 、Apache KYLIN、Apache Phoenix、DEBRY、HP Vertica、IBM DB2、INFORMIX、Microsoft SQL Server、Oracle、Pivotal Greenplum Database、Postgresql、GBase 8S、GBase 8T、KINGBASE、Presto、SAP HANA、SAP Sybase、Hbase 這些數據庫時,會比其他數據連接多了一步:模式。如下圖所示:
模式介紹如下所示:
如果這些數據庫未進行模式選擇,則默認選擇的是第一個模式。
當數據庫不存在模式選擇,則無需進行模式選擇。
模式默認不可編輯,點擊「點擊連接數據庫」且連接成功後可編輯。
模式建立的初衷是爲了其他功能更容易讀取數據庫裏的數據,選擇「默認值」即可。
連接多模式的數據庫時使用 SQL 語句需要帶上模式名前綴進行搜索。
注:有模式選擇的數據庫,需要保證數據庫中有可用的模式,否則連接時會報錯。
4.2 認證方式
其中 APACHE IMPALA、Hadoop Hive、SPARK 、TRANSWARP INCEPTOR、APACHE Phoenix、HBase 這六個數據庫在配置數據連接時有 認證方式這一選項。如下圖所示:
具體介紹如下所示:
若數據庫支持多種認證方式,則點擊會出現認證方式下拉框。
若選擇「Kerberos」認證,則填入注冊過 kdc 的客戶端名稱和 keytab 密鑰路徑。
詳細 Kerberos 認證請參考 [平台]數據連接 Kerberos 認證
4.3 高級設置
高級設置界面如下圖所示:
各參數介紹請參見:連接池屬性 文檔中的 2.2 節内容。
5. 管理數據連接
5.1 管理範圍
在數據決策系統中,點擊「管理系統>數據連接>數據連接管理」,點擊某一數據庫右側圖标,如下圖所示:
注:未适配的數據庫類型右側不顯示圖标。
點擊某一數據連接右側圖标後,出現的按鈕介紹如下表所示:
按鈕名稱 | 說明 |
---|---|
測試連接 | 測試數據庫配置是否成功 |
編輯 | 點擊「編輯」按鈕後,可修改數據連接的各配置項 |
重命名 | 重命名該數據連接 |
複制 | 複制該數據庫,且數據連接名自動加 1 |
删除 | 删除該數據庫 |
類型、創建者 | 顯示數據庫類型和創建者 |
平台未适配的數據連接,例如未适配的第三方數據源插件,平台中只能讀取到數據源的名字,無法新建、編輯及查看具體的設置,只能在設計器中進行新建、編輯和查看,如 JSON數據集 。如下圖所示:
5.2 連接池狀态
注:只有 JDBC 類型的數據庫有連接池。
數據連接界面提供連接池狀态頁面,可看到目前已創建的數據連接及對應的連接狀态,如下圖所示:
「活動連接數」和「空閑連接數」的說明如下表所示:
連接池狀态 | 說明 |
---|---|
活動連接數 | 連接池最大可創建的連接數,若最大連接數是 10 ,程序已申請 10 個連接,而且一直在使用,第 11 個連接申請時報錯:active 10 maxActive 10 |
空閑連接數 | 當前處於空閑狀态的連接, 随時會轉成活動連接, 空閑狀态超過最大空閑連接時間時自動釋放 活動連接數+空閑連接數=實際物理連接數 |