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操作符,实现在字段条件不区分大小写筛选的效果。 | 否 | |
用户管理 | 组排序方式 | 用于设置用户管理模块中“组”的排序方式,主要有:按名称、按别名、按编号。 | 按名称 |
用户排序方式 | 用于设置用户管理模块中“用户”的排序方式,主要有:按名称、按别名。 | 按名称 | |
角色排序方式 | 用于设置用户管理模块中“角色”的排序方式,主要有:按名称、按别名。 | 按名称 | |
不允许调用没有用权限的服务接口 | 用于控制越权访问。 | 否 | |
索引设置 | 索引服务器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系统。通过该设置项可以快速更换加密算法,以达到快速测试哪种加密算法可以绕过拦截。 | |
设置说明 |
| |
(1)若管理员切换了算法,由于其他用户前端仍使用旧算法来加密请求,会影响用户对系统的操作,所以在设置了新算法后,需要其他用户重新刷新系统界面。 (2)若在浏览器访问地址添加了debug=true,那【网络传输加密算法】设置项将不生效。 |
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数据源 。 |
注意事项 | SQL查询中定义的LIKE后面的内容,不受此设置项的影响。 |