1. 界面介绍
在“系统选项”界面选择 高级设置 ，“高级设置”界面由文本编辑器、格式化代码和帮助按钮组成，如下图：
1.1文本编辑器
| 配置项 | 说明 | |
|---|---|---|
| 内容结构 |
| |
| 组名 | 每个分组的名称。 | |
| 配置项内容 | 配置项名称 | 该配置项的名称。 |
| 配置项说明 | 配置项的说明信息，包括备选值和初始值。 | |
配置项的值 | 由键值对“key = value”构成。
1、key值只能由字母、数字或下划线组成，如: NEW_TEST_KEY=VALUE。 2、key值不能以smartbi.和smartbix.为开始，如：smartbi.test（错误）。 3、不能有两个同名的key，如“test=value1”和“test=value2”。 关于设置配置项的值，有以下三种情况： 1、原配置项的值为修改值。 直接修改“=”后的值即可。 2、原配置项的值为默认值。
用户想要修改配置项的值，直接去除“##”，在“=”赋值即可。
3、恢复配置项的值为默认值，有以下三种方式： 1）将配置项的值修改为默认值，如下图： 2）在配置项前加“#”注释掉（推荐）。 3）直接删除配置项的键值对（建议慎用）。 当用户再次打开高级设置项页面时，恢复为默认值的项会显示为默认样式。
| |
（2）文本编辑器的内容较多时，我们可以通过Ctrl+F弹出搜索框，输入key值、描述等进行搜索。
（3）在文本编辑器中我们还能添加“自定义属性”和“自定义注释”。
- 自定义属性：自定义属性需要后台有相应的处理逻辑才能生效，否则只是一个没有意义的键值对。如下所示：
- 自定义注释：用户可以使用“## ”在key的上方添加自定义注释，如下所示：
1、添加自定义属性之前需要与研发人员确认该属性是否生效。
2、自定义属性建议放置在高级设置项末尾，且添加空格加以和其他内容区别。
3、自定义注释建议独占一行，且在需要添加注释的行上方。
4、通常情况下如非必要，不推荐添加自定义注释，因为 格式化 操作会导致自定义注释消失。
1.2 格式化代码
功能简介：点击 格式化代码 按钮，会清除用户添加的自定义注释，且将所有的自定义属性移动至页面最下方。
使用场景：假如把初始的那些注释删掉了，点击 格式化代码 按钮，被删掉注释会重新生成回来。
1.3 帮助
点击 帮助 按钮，打开帮助中心，里面详细说明高级设置中每个设置项的作用和使用场景。
2. 设置项说明
“高级设置”中各设置项说明如下：
| 设置项 | 说明 | 默认值 | |
|---|---|---|---|
| 公共设置 | ZIP编码设置 | 用于设置ZIP编码。如GBK、BIG5等等 | GBK |
| 用于设置扩展包JSP处理器。包含默认和嵌入式。 | 嵌入式 | ||
用于统一设置网络传输数据时，具体采用哪种加密算法。 | SF1 | ||
| 是否切换为V8的操作权限 | 用于切换用户管理中操作权限体系结构的新旧模式。 | 否 | |
| 是否开启vertica数据库用ilike代替like，模糊匹配不区分大小写 | 用于Vertica数据库中能否使用ILIKE代替LIKE操作符，实现在字段条件不区分大小写筛选的效果。 | 否 | |
| 多维查询引擎地址 | 用于配置多维查询引擎的地址，默认为内置安装Mondrian的地址。 若多维查询引擎为独立部署，需要修改实际地址，并在 http://IP:端口/mondrian/manager/config.jsp 页面中设置”同步驱动“，详情请参考 Windows 部署Smartbi OLAP Server、Linux部署Smartbi OLAP Server集群。 | http://localhost:8080/ mondrian/smartbiquery | |
用户管理 | 组排序方式 | 用于设置用户管理模块中“组”的排序方式，主要有：按名称、按别名、按编号。 | 按名称 |
| 用户排序方式 | 用于设置用户管理模块中“用户”的排序方式，主要有：按名称、按别名。 | 按名称 | |
| 角色排序方式 | 用于设置用户管理模块中“角色”的排序方式，主要有：按名称、按别名。 | 按名称 | |
| 不允许调用没有用权限的服务接口 | 用于控制越权访问。 | 否 | |
| 索引设置 | 索引服务器URL地址（当索引服务器单独部署时填写此地址，否则留空） | 通常情况下索引服务器默认与Smartbi服务器部署在一起，此时不需要设置索引服务器URL地址； 当索引服务器与 Smartbi服务器分开部署时，则需要设置索引服务器的URL地址。常用于Smartbi应用服务器需要集群部署时，索引服务器不支持集群，此时需要将索引服务器单独部署。 | |
索引在服务器上的保存目录 | 用于设置索引在索引服务器中的保存目录。 | ||
索引搜索每页显示行数 | 用于设置进行元数据搜索时，搜索结果在每页显示的记录行数，其中每个资源的完整说明才算是一行记录。 | 20 | |
| 性能优化 | 数据集查询Fetchsize | 数据集查询时setfetchsize设置的数量。如果设置的值太大，会导致内存溢出。 | 5000 |
| 是否设置Statement的最大行数 | 是 | ||
| 参数备选值最大返回行数 | 用于设置参数备选值的最大返回行数。 | 10000 | |
| 报表个人参数数量 | 用于设置单个报表中个人参数的最大数量。 | 5 | |
| 业务数据缓冲池/对象最大激活个数 | 用于设置业务数据对象最大允许设置的最大对象总数。 | -1 | |
| 数据集定义对象池/对象最大激活个数 | 用于设置数据集定义对象最大允许设置的最大对象总数。 | -1 | |
是否启用告警 ALERT_ENABLE | （1）适用场景：当用户查询的数据量巨大容易会引起内存溢出，为了确保系统的稳定性，可启用“告警”实时监控查询单元格数量和预警。 （2）功能说明：启用告警可实时监控全系统报表的单元格数量，当超过设置的阈值后，终止用户查询后并给管理员自动发送告警信息。 （3）告警监控的报表类型：数据集、透视分析、电子表格。 | 是 | |
告警提示方式 ALERT_MODE | （1）用于设置告警的提示方式，分为站内信和邮件提示，可多选。 （2）邮件地址可通过 系统选项>公共设置的【系统运维信息收件地址】设置。 | 站内信 | |
参数缓存 PARAM_AUTOCACHE | （1）效果：用于控制参数数据是否需要缓存。 （2）参数缓存：用来存储参数默认值和备选值数据信息。属于系统全局设置，默认针对所有参数生效。点击此处查阅详情。 （3）注意事项：产品支持对局部参数设置是否需要缓存；参数自身的缓存设置优先级>系统选项中全局参数缓存设置的优先级。 | 是 | |
| 透视分析临时表个数 | 用于设置抽取的临时表数量（临时表在配置的高速缓存库中创建）。 | 是 | |
页面 | 电脑边框设置 | 用于设置在电脑上仪表盘中是否显示承载资源的DashLet的皮肤内容，选项有：显示边框和按钮、只显示按钮、只显示边框和都不显示。 | 显示边框和按钮 |
移动设置边框设置 | 用于设置在移动设备上仪表盘中是否显示承载资源的DashLet的皮肤内容，选项有：不显示边框和显示边框。更多信息如下：
| 不显示边框 | |
导出值类型 | 用于设置导出的内容是显示值还是真实值，选项有真实值和显示值。 | 真实值 | |
分析报告 | 开启资源丢失提示 | 用于是否开启资源丢失提示。 | 否 |
OFFICE_REPORT_MAX_SEMAPHORE_NUM=OFF | 用于设置打开分析报告加载资源方式为串行，或者控制并发运行的最大线程数。 | 无限制 | |
| 电子表格 | 移动端URL控件缩放方式 MOBILE_URL_RESOURCE_SCALE | 用于设置电子表格的URL控件在移动端的缩放方式
| 默认 |
回写数据大小限制 SSR_WRITEBACK_DATA_LIMIT | （1）适用场景：为了避免用户回写数据太多、回写操作大量单元格导致系统宕机。 （2）功能说明：用于限制用户每次回写的数据行数。
| 1400~1500 | |
数据集最大行数 SPREAD_SHEET_REPORT_MAX_DATA_ROWS | （1）功能说明：用于设置电子表格引用的每个数据集的最大总行数。 （2）适用场景：为了避免用户查询数据过多，耗费太多内存导致系统卡死。 （3）注意事项
| 20000 | |
SmartbiMpp | 用于回写导入抽取等有NULL值。 | 否 | |
用于设置在数据抽取中数据库保留的备份表的个数 | 5 | ||
2.1 扩展包JSP处理器
| 功能说明 | “JSP_PROCESSOR_TYPE”用于加载扩展包时指定JSP的处理器是使用服务器自带，还是产品内书写的。 |
|
|---|---|---|
| 使用场景 | 当同一个扩展包，有的服务器可以加载成功，有的服务器其JSP加载报错。 此时则要考虑加载不成功的服务器是因为使用的JSP处理器有问题。可通过修改JSP处理器的处理方式，如是默认则改为嵌入式。 | |
修改此选项并保存后，需要重启服务器此设置才会生效。 | ||
2.2 网络传输加密算法
| 功能说明 | “NETWORK_TRANSNISSION_ALGORITHM”用于统一设置网络传输数据时，具体采用哪种加密算法。 |
|
|---|---|---|
| 使用场景 | 由于服务器存在防火墙策略，导致smartbi产品一些携带了特殊字符的请求被拦截，无法发送请求到smartbi系统。通过该设置项可以快速更换加密算法，以达到快速测试哪种加密算法可以绕过拦截。 | |
| 设置说明 |
修改设置项的算法后，WEB端需要刷新页面，移动端需要重新登录，设置项才能生效。 | |
2.3 分析报告最大并发处理线程数
适用场景 | 在打开word分析报告时，避免同时加载其过多的引用资源占用大量内存，导致服务器内存溢出。 |
|
|---|---|---|
功能说明 | 用于设置打开分析报告加载资源方式为串行，或者控制并发运行的最大线程数。 | |
注意事项 | 该设置项会影响分析报告类型：Word分析报告。（PPT分析报告不受影响）。 |
（1）线程数配置说明
输入类型 | 输入内容 | 效果 | 说明 |
|---|---|---|---|
有限制 | 1 | 表示串行方式加载。 | 有助于解决线程同时被占用过多，减轻服务器压力。 |
大于1的整数 | 表示最多同时开启设置线程数，进行并发加载。 | ||
无限制 | OFF | 表示不限制线程数并行加载资源。 | 若分析报告复杂引用过多资源且多人打开情况，可能会出现内存溢出。 |
（2）线程数配置建议
报表情况 | 服务器内存 | 建议配置数 |
|---|---|---|
假设每张分析报告引用50个电子表格， | 16G | 20 |
32G | 40 | |
注意：上表建议仅供参考，实际配置时需要综合考虑分析报告资源引用资源数量、每个引用资源的大小因素。 | ||
2.4 SmartbiMPP
2.4.1 插入数据时自动处理NULL值
| 背景 | SmartbiMPP作为业务库，并支持代替vertica、infobright作为系统的联合数据源使用。 | |
|---|---|---|
| 功能 | “CLICK_HOUSE_AOTU_CONVERT_NULL”可控制Smartbi MPP 插入数据时是否自动处理NULL值。默认为“否”，即不处理NULL值。 |  |
| 适用场景 | 一般在回写导入抽取等有NULL值的时候就会报错（如图），此时需要设置配置项的值为“true”，默认处理NULL值。 |
|
2.4.2 抽取目标表备份上限
背景 | 为了避免丢失高速缓存库中历史数据，产品支持备份抽取目标表和数据，方便后续恢复数据，有效提高数据安全。 | |
|---|---|---|
功能 | "BACKUP_TAB_RETAIN_NUM "用于设置在数据抽取中数据库保留的备份表的个数，默认为5个。 备份规则：在抽取数据之前，默认备份抽取表（第一次不备份）到数据库中，每抽取一次进行滚动备份，备份到设置的上限后，下次备份则移除最旧的备份表。
在数据抽取中只要清空抽取表的数据，系统就会自动备份。 | |
2.5 是否开启vertica数据库用ilike代替like，模糊匹配不区分大小写
| 背景 | 在Vertica数据库中，原先是通过修改数据库大小写配置，实现字段条件不区分大小写筛选的效果，但是这样会影响数据库性能。可以使用ILIKE代替LIKE操作符，既能实现效果，也不会影响数据库性能。 |
|---|---|
| 功能说明 | “VERTICA_LIKE_CONVERSION_ILIKE”用于Vertica数据库中能否使用ILIKE代替LIKE操作符，实现在字段条件不区分大小写筛选的效果。 生效范围：自助数据集筛选器条件、自助仪表盘筛选器条件、透视分析的条件面板参数过滤条件、即席查询的条件面板参数过滤条件。
关于连接Vertica数据源，详情请参考 关系数据源-连接Vertica数据源 。 |
| 示例 | 来源于Vertica数据源的透视分析中，想要通过“a”筛选出包含“A”、”a”的值，此时可以设置“VERTICA_LIKE_CONVERSION_ILIKE=true”，效果如下：
|
注意事项 | SQL语句定义LIKE后面的内容不受此设置项的影响。 |
