---
url: /v6.2/setting-system-env.md
---
# 环境变量

HENGSHI SENSE 提供了非常丰富的功能，可以满个各种业务场景。针对一些特殊环境和功能需求，可以通过适当的修改环境变量配置来满足一些特殊的需求。

下面是一些主要的 环境变量 配置和简单说明。

***

**APP_CONFIG_APP_ENABLE_EXTEND_APP_APPROVAL**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `false` | 应用是否启用扩展应用审批 |

***

**APP_CONFIG_APP_ENABLE_RULE_STRICT_VALIDATE**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `false` | 应用是否启用规则严格验证 |

***

**APP_CONFIG_ENABLE_TENANT_APP_VERSION**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `false` | 是否给租户开启应用版本功能（仅当前License支持应用版本才生效） |

***

**ENGINE_CONFIG_ANALYZE_ENGINE_TABLE_WHEN_IMPORT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `true` | 导入引擎时是否分析引擎表 |

***

**ENGINE_CONFIG_DATASET_CACHE_IMPORT_MAX_TIME**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `3` | 数据集缓存导入的最大时间（小时） |

***

**ENGINE_CONFIG_ENGINE_FIELD_TYPE_CHANGE_AUTO_IMPORT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `true` | 引擎字段类型更改时是否自动导入 |

***

**ENGINE_CONFIG_ENGINE_FIELD_TYPE_CHANGE_IMPORT_DELAY_TIME**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `120` | 引擎字段类型更改导入的延迟时间（秒） |

***

**ENGINE_CONFIG_ENGINE_IMPORT_CHECK_TABLE_EXISTS**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `false` | 引擎导入时是否检查表是否存在 |

***

**ENGINE_CONFIG_ENGINE_IMPORT_EXPR_JSON_FIELD**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `false` | 引擎导入时是否导入表达式JSON字段 |

***

**ENGINE_CONFIG_ENGINE_IMPORT_FROM_PG_BATCH_FETCH_SIZE**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `-1` |  |

***

**ENGINE_CONFIG_ENGINE_IMPORT_USER_EXPR_AND_TYPE**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `true` | 引擎导入时是否使用用户表达式和类型 |

***

**ENGINE_CONFIG_ENGINE_TABLES_SYNC_INTERVAL**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `3600000` | 引擎表同步的时间间隔（ms） |

***

**ENGINE_CONFIG_GPDB_ENGINE_IDLE_IN_TRANSACTION_MAX**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `60` | gpdb engine 查询队列 引擎资源管理 gpdb引擎清理idle in transaction最大时长 |

***

**ENGINE_CONFIG_GPDB_WITH_TO_TEMP_TABLE_THRESHOLD**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `5` | GPDB使用临时表的阈值 |

***

**EXTERNAL_DB_CONFIG_BATCH_INSERT_MAX_CELL_COUNT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `100000` | 批量插入最大单元格数量 |

***

**EXTERNAL_DB_CONFIG_CONN_LOCK_TIMEOUT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `600000` | 连接锁超时时间（毫秒） |

***

**EXTERNAL_DB_CONFIG_DORIS_BATCH_INSERT_SIZE**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `-1` |  |

***

**EXTERNAL_DB_CONFIG_DORIS_TABLE_NAME_MAX_LENGTH**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `64` |  |

***

**EXTERNAL_DB_CONFIG_DORIS_TABLE_REPLICATION_NUM**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `1` |  |

***

**EXTERNAL_DB_CONFIG_JDBC_CONNECT_TIMEOUT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `20` | JDBC连接超时时间（秒） |

***

**EXTERNAL_DB_CONFIG_JDBC_GET_CONN_TEST_SOCKET**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `false` | JDBC获取连接时是否测试套接字 |

***

**EXTERNAL_DB_CONFIG_JDBC_SOCKET_TIMEOUT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `3600` | JDBC套接字超时时间（秒） |

***

**EXTERNAL_DB_CONFIG_SPLIT_BATCH_FOR_STAR_ROCKS_SPECIAL_CHAR_INSERT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `true` | StarRocks特殊字符插入是否拆分批次 |

***

**EXTERNAL_DB_CONFIG_THROTTLE_QUERY_TIMEOUT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `600` | vendor query throttle 节流查询超时时间（秒） |

***

**GENERAL_CONFIG_API_DATASET_IMPORT_TIME_OUT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `3600000` | api数据集导入超时时间，默认1小时 API数据集导入超时时间（ms） |

***

**GENERAL_CONFIG_APP_IMAGE_MAX_AGE**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `31536000` | 应用图片最大有效期（秒） |

***

**GENERAL_CONFIG_AUDIT_LOG_HISTORY_RESERVE_DAYS**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `90` | 审计日志历史记录保留天数 |

***

**GENERAL_CONFIG_CHART_DATA_ROWS_LIMIT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `100000` | 图表数据行数限制 |

***

**GENERAL_CONFIG_COLUMN_AUTH_HIDE_FIELD_NAME**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `true` | 列权限是否隐藏字段名 |

***

**GENERAL_CONFIG_DEFAULT_IMAGE_COMPRESS_QUALITY**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `0.75` | 图片压缩比 |

***

**GENERAL_CONFIG_DOWNLOAD_INTERVAL**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `5000` |  |

***

**GENERAL_CONFIG_DOWNLOAD_TIMEOUT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `55000` | 下载超时时间（ms） |

***

**GENERAL_CONFIG_ENABLE_BODY_ENCODE**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `false` | HTTP请求体是否进行编码，修改后需刷新页面才能生效 |

***

**GENERAL_CONFIG_ENABLE_VERIFY_ADMIN_PASSWORD**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `true` | 重置密码时 是否验证当前用户密码 |

***

**GENERAL_CONFIG_EVEREST_DELETED_USER_RESERVED_DAYS**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `15` | 删除用户保留天数。删除默认软删除，超过配置天数后才会物理删除 |

***

**GENERAL_CONFIG_EVEREST_MSG_MAX_LENGTH**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `300` |  |

***

**GENERAL_CONFIG_EXPORT_INVISIBLE_FIELDS**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `false` | 导出时是否包含不可见字段 |

***

**GENERAL_CONFIG_FILE_HEADER_ABNORMAL_RATIO_THRESHOLD**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `1.1` | 文件表头异常比率阈值 |

***

**GENERAL_CONFIG_FILE_HEADER_SUPPORT_PADDING**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `true` | 是否支持纯数据文件自动添加表头的方式 |

***

**GENERAL_CONFIG_FILE_MEM_PROCESSING_THRESHOLD**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `52428800` | 文件内存处理阈值（字节） |

***

**GENERAL_CONFIG_FILE_TYPE_DETECT_LINE_LIMIT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `50000` | 文件检查类型的最大行数 |

***

**GENERAL_CONFIG_HENGSHI_ACCESS_AGGREGATION_LOG_RESERVED_DAYS**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `180` | 访问聚合日志保留天数 |

***

**GENERAL_CONFIG_HENGSHI_ACCESS_LOG_RESERVED_DAYS**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `32` | 访问日志保留天数 |

***

**GENERAL_CONFIG_HENGSHI_BACKGROUND_JOB_LOG_RESERVED_DAYS**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `2` | 后台作业日志保留天数 |

***

**GENERAL_CONFIG_LOGIN_BLOCK_MINUTE**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `3` | 登录失败后封禁分钟数 |

***

**GENERAL_CONFIG_LOGIN_RETRY_COUNT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `3` | 登录失败重试次数 |

***

**GENERAL_CONFIG_PLATFORM_CONNECTION_AUTH**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| string | `customize` | 平台连接授权给租户后的权限。`customize`: 租户管理员可以自行管理权限，`read`： 租户下全部用户统一是`read`权限。 |

***

**GENERAL_CONFIG_PLATFORM_FOLDER_AUTH**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| string | `customize` | 平台授权给租户的文件夹/数据包的权限。`customize`: 租户管理员可以自行管理权限，`read`： 租户下全部用户统一是`read`权限。 |

***

**GENERAL_CONFIG_SAMPLE_COUNT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `10000` | 采样数量 |

***

**GENERAL_CONFIG_SESSION_COOKIE_MAX_AGE**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `86400` | cookie最大有效期 |

***

**HE_QUERY_CONFIG_CONSTANT_EXPRESSION_OPTIMIZER**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `true` | 常量表达式优化器是否启用 |

***

**HE_QUERY_CONFIG_DISABLE_MINIO_CACHE_FOR_CHART_DATA**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `false` | 是否关闭超阈值chart-data的minio保存策略 |

***

**HE_QUERY_CONFIG_ENGINE_FALLBACK_DATA_QUERY_TO_SOURCE**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `true` | 引擎数据查询是否回退到数据源查询 |

***

**HE_QUERY_CONFIG_REDIS_MAX_CHART_DATA_SIZE**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `2621440` | chart-data能够保存到redis的长度，以序列化为json字符串后的字符串长度进行计算。 默认以5MB，单个字符占2个字节进行计算。 |

***

**MESSAGE_PUSH_CONFIG_APP_EMAIL_ATTACHEMENT_MAX_SIZE_MB**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `25` | 应用订阅中邮件附件最大大小（MB） |

***

**MESSAGE_PUSH_CONFIG_APP_SUBSCRIBE_NEED_MERGE_CHART_EXCEL_TABLE_MAX_SIZE_MB**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `5` | 应用订阅中需要合并图表Excel表最大大小（MB） |

***

**MESSAGE_PUSH_CONFIG_EXPORT_TABLE_MAX_DATA_NUM**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `50000` | 应用订阅中导出表的最大数据数量 |

***

**MESSAGE_PUSH_CONFIG_EXPORT_TABLE_MAX_TIMEOUT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | 180000 | 应用订阅中导出表的最大超时时间（ms） |

***

**MESSAGE_PUSH_CONFIG_EXPORT_TABLE_RETRY_WAIT_TIME**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `5000` | 应用订阅中导出表重试等待时间（ms） |

***

**MESSAGE_PUSH_CONFIG_MAX_NOTIFY_TEST_API_CALL_TIMES**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `10` | 最大通知测试API调用次数 |

***

**SCREENSHOT_CONFIG_HENGSHI_THUMBNAIL_DELAY_TIME**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `10` | 生成缩略图的延迟时间（秒） |

***

**SCREENSHOT_CONFIG_HENGSHI_THUMBNAIL_ENABLED**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `true` | 是否启用生成缩略图 |

***

**SCREENSHOT_CONFIG_SCREENSHOT_CHART_BASE_TIMEOUT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `40000` | 截图的基础超时时间（ms） |

***

**SCREENSHOT_CONFIG_SCREENSHOT_IS_NICE**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `false` | 截图是否使用nice |

***

**SCREENSHOT_CONFIG_SCREENSHOT_NICE_VALUE**

| 值类型 | 默认值 | 作用       |
| ------ | ------ | ---------- |
| number | `19`   | 截图nice值 |

***

**SCREENSHOT_CONFIG_SCREENSHOT_JS_TIMEOUT_DIFF**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `8000` | 截图JS超时时间差（ms） |

***

**SCREENSHOT_CONFIG_SCREENSHOT_MAX_TIMEOUT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `90000` | 截图的最大超时时间（ms） |

***

**SCREENSHOT_CONFIG_SCREENSHOT_PPT_EXPORT_MAX_IMG_SIZE**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `10000000` | 导出PPT的最大图片大小（字节） |

***

**SCREENSHOT_CONFIG_SCREENSHOT_PUBLISHED_THUMBNAIL_RESIZE_FACTOR**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `6` | 缩略图的缩放因子 |

***

**SCREENSHOT_CONFIG_SCREENSHOT_RETRY_INTERVAL**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `1000` | 截图重试间隔（ms） |

***

**SCREENSHOT_CONFIG_SCREENSHOT_RETRY_NUM**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `3` | 截图重试次数 |

***

**SCREENSHOT_CONFIG_SCREENSHOT_WAIT_TIMEOUT**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `1200000` | 截图等待超时时间（ms） |

***

**SCREENSHOT_CONFIG_THUMBNAIL_MAX_AGE**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `300` |  |

***

**SECURITY_CORS_CONFIG_ACCESS_CONTROL_ALLOW_CREDENTIALS**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| boolean | `true` | 是否允许浏览器在跨域请求中携带身份凭证，建议使用默认值(true)。 参考资料：[Access-Control-Allow-Credentials](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Headers/Access-Control-Allow-Credentials) |

***

**SECURITY_CORS_CONFIG_ACCESS_CONTROL_ALLOW_HEADERS**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| string | `Origin, No-Cache, X-Requested-With, If-Modified-Since, Pragma, Last-Modified, Cache-Control, Expires, Content-Type, X-E4M-With,userId, token, X-Request-Domain, X-Request-Hash-Url, X-CSRF-Token, x-request-proxy` | 浏览器在跨域请求中被允许使用的请求头字段。如果新增，需要带上所有的值。参考资料：[Access-Control-Allow-Headers](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Headers/Access-Control-Allow-Headers) |

***

**SECURITY_CORS_CONFIG_ACCESS_CONTROL_ALLOW_METHODS**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| string | `POST, GET, PUT, OPTIONS, DELETE` | 浏览器在跨域请求中被允许使用的 HTTP 方法。参考资料： [ACCESS_CONTROL_ALLOW_METHODS](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Headers/Access-Control-Allow-Methods) |

***

**SECURITY_CORS_CONFIG_ACCESS_CONTROL_ALLOW_ORIGIN**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| string | \`\` | 允许访问该资源的外部域名。参考资料： [Access-Control-Allow-Origin](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Headers/Access-Control-Allow-Origin) |

***

**SECURITY_CORS_CONFIG_ACCESS_CONTROL_MAX_AGE**

| 值类型 | 默认值 | 作用 |
| ------- | ------ | ------- |
| number | `-1` | 预检请求（Preflight Request）的结果可以被缓存的时间（秒）。参考资料： [Access-Control-Max-Age](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Headers/Access-Control-Max-Age) |