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.

    附件列表


    主题: System Management
    • Helpful
    • Not helpful
    • Only read

    滑鼠選中內容,快速回饋問題

    滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

    不再提示

    10s後關閉

    Get
    Help
    Online Support
    Professional technical support is provided to quickly help you solve problems.
    Online support is available from 9:00-12:00 and 13:30-17:30 on weekdays.
    Page Feedback
    You can provide suggestions and feedback for the current web page.
    Pre-Sales Consultation
    Business Consultation
    Business: international@fanruan.com
    Support: support@fanruan.com
    Page Feedback
    *Problem Type
    Cannot be empty
    Problem Description
    0/1000
    Cannot be empty

    Submitted successfully

    Network busy