配置資料連結

配置資料連結線上視頻學習請參見 資料連結 

1.1 版本

1.2 功能簡介

使用 FineBI 進行資料分析的第一步即獲取資料，獲取資料的第一步即定義資料來源。實際使用者系統最常見的是將資料儲存在資料庫中，並且不斷更新。無論使用 FineBI Spider 引擎的何種資料型別，都支援對資料的不斷更新。

在進行資料連結時，不支援資料庫中表名和欄位名包含下表所示的特殊字元：

使用擁有 FineBI 資料連結權限的使用者帳號登入數據決策系統（一般為管理者），點選「管理系統>資料連結>資料連結管理>新建資料連結」可建立新的資料連結，如下圖所示：

注：如果非管理者使用者需要配置 FineBI 資料連結，需要管理者給其分配管理系統下「資料連結」節點的權限，具體操作請查看 資料連結控製

點選「新建資料連結」按鈕，有三種型別選擇，分別為常用、所有、其他。如下圖所示：

3.1 常用

固定顯示幾個常用的資料庫型別，分別為 Hsql、IBM DB2、Microsoft SQL Server、MySQL、Oracle。如下圖所示：

3.2 所有

顯示 FineBI 內建支援和插件支援的資料庫型別，分別為：阿里雲AnalyticDB、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」。如下圖所示：

3.3.1 JNDI 資料連結

點選建立資料連結按鈕，在「其他」型別中選擇「JNDI資料連結」，如下圖所示：

注：JNDI 資料連結僅支援 Finereport ，FineBI 暫不支援資料準備處使用。

3.3.2 其他 JDBC

如果資料庫列表中沒有所需的資料庫型別，則選擇「其他」型別下的其他JDBC，將對應驅動包放置在%FineBI%\webapps\webroot\WEB-INF\lib下，並重啓 FineBI，需要手動輸入驅動器名稱、URL 等完整資料連結資訊，點選「測試連結」連結成功後，點選「儲存」即可。如下圖所示：

以下為部分數據連接信息的詳細解釋：

不同資料庫需配置的資訊可能有所不同，下面介紹「模式」和「認證方式」這兩個屬性的具體資訊。

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 高階設定

高階設定介面如下圖所示：

其中連結池屬性的各參數說明如下表所示

• 常用連結池屬性

• 不太常用的連結池屬性（如無特殊場景不建議修改）

5.1 管理範圍

在數據決策系統中，點選「管理系統>資料連結>資料連結管理」，點選某一資料庫右側圖示，如下圖所示：

「資料連結管理」各設定項說明如下表所示：

需要注意以下幾點：

未適配的資料庫型別右側不顯示圖標。

在管理資料連結時，資料連結的名稱不能隨意改動。更新到本地的表與資料庫匹配依靠的是資料連結的名稱，如果修改資料連結的名稱，從該連結中取出的表將無法再更新。  

如果是 SQL 資料集，也會導致沒有「修改 SQL」的按鈕。

如果更新本地儲存的表中的資料庫，例如由開發環境變化到生產環境，表名與表結構均一致時，只需要修改資料連結的 URL 即可。本地儲存的表依照資料連結名依然可以更新資料。

5.2 連結池狀態

資料連結介面提供連結池狀態頁面，可看到目前已建立的資料連結及對應的連結狀態，如下圖所示：

「活動連結數」和「空間連結數」的說明如下表所示：

6.1 資料無法預覽

問題描述：

BI 連結伺服器資料集，資料預覽時有報錯資訊：find fieldinfo failed for table:XXX

原因分析：

資料庫表中有重複的欄位名，BI 是不支援重複欄位名及空值的，如下圖所示：

解決方案：

重新修改重複的欄位名。