系统变量

在此页面上

Overview

设置系统变量

Overview

BI Connector 提供以下环境变量：

系统变量	数据类型	说明	默认值
`full_pushdown_exec_mode`	布尔	指定对于包含未完全转换为 MongoDB 查询语言的子句的查询，是否返回查询错误。 SQL 查询谓词用于筛选查询返回的数据。	`0 (false)`
`log_level`	整型	指定 BI Connector 的日志记录级别： `-1`：不记录。 `0`：仅记录数据库用户的消息，例如基本`mongosqld`事件和状态更改。 `1`：数据库用户和`mongosqld`管理员的日志消息。 `2`：仅供内部使用。	`2 (Atlas-hosted) and 0 (self-managed)`
`max_nested_table_depth`	整型	指定唯一嵌套字段路径（Field Path）的最大数量， `mongosqld`映射到collection的关系表。	`50`
`max_num_global_tables`	整型	具有自动生成模式的 MongoDB 部署中允许的最大表数。	`4000`
`max_num_tables_per_collection`	整型	具有自动生成模式的表的collection中允许的最大表数。	`200`
`max_nested_table_depth`	整型	在具有自动生成模式的collection中，MongoDB 转换为表的数组的表嵌套深度的默认限制。	`10`
`max_num_fields_per_collection`	整型	在具有自动生成模式的表中，每个collection检查的最大字段数。	`2000`
`mongodb_max_varchar_length`	整型	指定为使用`VARCHAR`数据类型的列返回的最大字符串长度。值为`0`指定没有限制。	`0`
`polymorphic_type_conversion_mode`	字符串	确定BI Connector如何评估使用多种数据类型指定的文档字段。示例，`count` 在一个文档中可能是数字，在另一个文档中可能是string 。 BI Connector选择的数据类型取决于`schema_mapping_mode`系统变量的值。值为 `majority` 会导致BI Connector选择大多数文档字段中出现的类型，而值为 `lattice` 会导致BI Connector选择string作为`count`的数据类型。有关更多信息，请参阅缓存采样。将`polymorphic_type_conversion_mode`设置为以下值之一： `off`注意：对于使用多种数据类型指定的文档字段，如果不进行显式转换，查询可能会失败。 `fast`：BI Connector 仅转换在采样期间显示为多种数据类型的文档字段。 `safe`：BI Connector 会将所有文档字段转换为采样期间发现的数据类型，即使字段不显示为多种数据类型。	`off`
`reconcile_arithmetic_agg_functions`	布尔	允许您选择 MongoDB 不对某些使用算术聚合函数的查询自动转换类型的行为。在 MongoDB 3.6 及更早版本中，与后续版本中算术聚合函数的隐式类型转换相比，此行为可提高性能。有关更多信息，请参阅类型转换模式。	`true`
`sample_refresh_interval_secs`	整型	指定 BI Connector 模式的更新频率（以秒为单位）。值为`0`指定在 BI Connector 启动后不刷新模式。有关更多信息，请参阅缓存采样。	`0`
`sample_size`	整型	指定 BI Connector 在生成其模式时采样的文档数量。 `0`的值指定 BI Connector 对所有样本`namespaces`执行collection扫描。有关更多信息，请参阅缓存采样。	`100`
`schema_mapping_mode`	字符串	指定如何将 MongoDB 模式转换为关系模式： `lattice`：请参阅采样类型冲突以了解更多信息。 `majority`：BI Connector 为样本中出现的字段分配最常见的数据类型。	`lattice`
`type_conversion_mode`	字符串	指定 BI Connector 用于类型转换的语义，例如`CAST`函数。 `mysql` `mongosql`	`mongosql`

设置系统变量

您必须具有 atlasAdmin数据库角色，才能在 Atlas 托管的 BI Connector 上设置环境变量。要为自管理的BI Connector 设置它们，您必须对已连接inprog MongoDB database的具有BI Connector 特权。

使用任何连接到 BI Connector 的 SQL 客户端来设置这些变量。以下示例将mongodb_max_varchar_length设置为100 ：

SET GLOBAL mongodb_max_varchar_length = 100

设置系统变量后，必须启动与 BI Connector 的新连接。用于设置系统变量的连接不受影响。

后退

用户授权模型

来年

MongoDB Connector for BI 的已知问题