Introduction to FineDB

  • Last update:  2023-06-25
  • Overview

    Except for platform attribute configurations, all information in the FineBI system, including directory tree settings, scheduled task information, etc., is stored in FineDB database. 

    FineBI supports using the built-in FineDB database or connecting to an external FineDB database.

    Built-in Database

    FineBI has a built-in HSQL database as FineDB database.

    Storage Location

    FineDB database is stored at % BI_Home %\webapps\ webroot \WEB-INF\embed, as shown below:

    Picture4.png

    Database Table Content

    FineDB database stores all information in FineBI system except for platform attribute configurations, including directory tree settings, scheduled task information, etc. 

    For details, see FineDB Table Structure.

    Database File


    File Name

    Required or Not

    Storage Content

    db.properties

    Required

    Used to store HSQL database properties

    db.script

    Required

    Used to save table and data

    db.lck

    Not required

    Used to indicate that the database is open

    db.log

    Not required

    Used to record changes of the current database

    db.lobs

    Not required

    Used to save certain types of data

    db.tmp

    Not required

    Temporary file directory

    iconNote:

    1. Newly installed FineBI only has required files such as db.properties and db.script. But if the database is used and some properties of the table and data are modified, other files will be generated automatically.

    2. Newly installed FineBI only has required files such as db.properties and db.script. But if the database is used and some properties of the table and data are modified, other files will be generated automatically.

    FineDB Data Connection


    iconNote:
    Built-in FineDB database is an HSQL database that will create an in-memory database when used, which will occupy a large amount of memory when the data volume is large. Therefore, do not create a Built-in FineDB Database data connection in FineBI project unless necessary.


    Users can connect to the built-in FineDB database in the BI platform.

    1) Admin logs into FineBI, clicks Manage > Data Connection > Data Connection Management > New Data Connection, as shown below:

    2) Click Other, select Other JDBC, as shown in the figure below:

    2022-07-13_11-33-51.png

    3) Fill in the information, and click Click to connect database on the right of Pattern, and select PUBLIC, as shown in the figure below:

    Parameter

    Value

    Data Connection Name

    FineDB (user-defined)

    Driver

    Enter com.fr.third.org.hsqldb.jdbcDriver

    URL

    Enter jdbc:hsqldb:file://${ENV_HOME}/embed/finedb/db

    Compatible with Windows/Linux/Mac

    Username

      Enter sa

    Password

    No need to enter

    Pattern

      Select PUBLIC

    3..png

    4) Click Test Connection. It will prompt Connection Successful, as shown below:2022-07-13_16-49-39.png

    5) Click Save in the upper right corner.

    iconNote:
    After establishing a FineDB data connection, it is necessary to control data connection permissions, otherwise the database might be accessed and modified by unauthorized personnel.

    External Database

    HSQL database cannot be accessed by multiple threads. In a clustered environment with large amounts of data, HSQL database may become unstable.  Therefore, it is recommended to configure an external database in formal enterprise projects.

    For the types of supported external databases and usage, see Configure External Database.


    iconNote:

    1. If you want to use data from an external database for analysis, select an appropriate data connection method according to the database type.

    2. After establishing a FineDB data connection, it is necessary to control data connection permissions, otherwise the database might be accessed and modified by unauthorized personnel.

    FineDB Table

    Table Structure Introduction

    For details, see FineDB Table Structure.

    Table Field Modification

    Some configuration items cannot be modified in the platform and can only be modified by adjusting table field in the FineDB databases.

    Some fields in the FineDB database can be modified by plugins.

    It is prohibited to modify the FineDb data file directly and to connect/modify FineDB database through third-party software.

    Attachment List


    Theme: System Management
    前の記事
    次の記事
    • いいね
    • 良くない
    • 閲覧しただけ

    フィードバック

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    反馈已提交

    网络繁忙