過程資料集

1.1 應用場景

使用者有時需要使用自訂型別的資料源來進行資料分析和儀表板展示。  

1.2 功能簡介

FineBI 可以與 FineReport 建立遠端連結來使用自訂資料源-過程資料集，進而 BI 引擎讀取定義的資料源來進行資料分析和儀表板製作。

注：2019-06-14 之後的 5.1 版本對過程資料集的更新做了優化，從全量資料抽取到記憶體的方式改為了流式抽取，支援億級資料量的抽取。

本例以 FineBI 內建範本執行日誌為例進行介紹。

2.1 定義資料源過程

點選下載範本執行日誌檔案：ExecuteLog.class 

點選下載平台管理日誌檔案：OperateLog.class

1）將 ExecuteLog.class 檔案並將其copy到%FineBI%/webapps/webroot/WEB-INF/classes/com/fr/log下，此時該過程資料源定義成功，如下圖所示：

範本執行日誌檔案代碼如下所示，可以進行編譯成 class 檔案：

package com.fr.log;

import com.fr.data.AbstractTableData;
import com.fr.decision.log.ExecuteMessage;
import com.fr.general.data.TableDataException;
import com.fr.intelli.record.MetricRegistry;
import com.fr.stable.query.QueryFactory;
import com.fr.third.springframework.util.CollectionUtils;

import java.util.ArrayList;
import java.util.List;

/**
 * @author Munin
 * @version 5.1.3
 * Created by Munin on 2020/4/27
 */
public class ExecuteLog extends AbstractTableData {

    private static final long serialVersionUID = -3233073054624031382L;
    private String[] columnNames = {
            "tname",
            "type",
            "userrole",
            "param",
            "ip",
            "username",
            "consume",
            "sql",
            "browser",
            "memory",
            "time",
            "reportId"
    };
    private List<List<Object>> cacheData = new ArrayList<>();


    public ExecuteLog() {
    }

    /**
     * 懶載入，解決不必要的取明細效能問題
     */
    private List<List<Object>> getExecuteData() {
        if (CollectionUtils.isEmpty(cacheData)) {
            init();
        }
        return cacheData;
    }

    private void init() {
        try {
            List<ExecuteMessage> messages = MetricRegistry.getMetric().find(ExecuteMessage.class, QueryFactory.create()).getList();
            if (messages != null 
                for (ExecuteMessage message : messages) {
                    List<Object> objects = new ArrayList<Object>();
                    objects.add(message.getTemplate());
                    objects.add(message.getType());
                    objects.add(message.getUserrole());
                    objects.add(message.getParameters());
                    objects.add(message.getIp());
                    objects.add(message.getUsername());
                    objects.add(message.getConsume());
                    objects.add(message.getSql());
                    objects.add(message.getBrowser());
                    objects.add(message.getMemory());
                    objects.add(message.getTime());
                    objects.add(message.getReportId());
                    cacheData.add(objects);
                }
            }
        } catch (Exception e) {
            FineLoggerFactory.getLogger().error(e.getMessage(), e);
        }
    }

    @Override
    public int getColumnCount() throws TableDataException {
        return columnNames.length;
    }

    @Override
    public String getColumnName(int i) throws TableDataException {
        return columnNames[i];
    }

    @Override
    public int getRowCount() throws TableDataException {
        return getExecuteData().size();
    }

    @Override
    public Object getValueAt(int i, int i1) {
        List<List<Object>> data = getExecuteData();
        if (i < data.size()) {
            List<Object> message = data.get(i);
            if (i1 < message.size()) {
                return message.get(i1);
            }
        }
        return null;
    }

2.2 建立遠端連結

首先需要將設計器遠端連結至 FineBI 伺服器。此處詳情請參見：遠端連結 FineReport 設計器

1）開啟設計器，選擇伺服器>伺服器資料集，如下圖所示：

2）進入伺服器資料集設定介面，選擇 >過程，如下圖所示：

3）點選選擇，選擇新增的ExecuteLog.class檔案，點選確定儲存。如下圖所示：

4）在伺服器資料集下能看到剛剛新增的過程資料集，如下圖所示：

注：此處若想新增多個，可重複上述步驟選擇 OperateLog.class 檔案新增。

2.3 FineBI 中新增過程資料表

1）登入數據決策系統，選擇公共資料，進入業務包選擇建立資料集>資料庫表，如下圖所示：

2）在伺服器資料集下，可以看到剛剛在設計器中新增的過程4，選中表並點選確定新增到業務包中即可使用。如下圖所示：