---
url: /v6.2/connecting-mongo-bi.md
---
# MongoDB BI Connector

### 连接步骤

连接 MongoDB 需要 server 端安装好 `MongoDB BI Connector`。详细内容参考[MongoDB BI Connector 指南](mongodb-guide.md)。

安装后参照如下步骤添加 `MongoDB BI Connector` 连接。

1. 在数据连接页面右上角点击新建数据连接。
   ![](/images/data-connection/connection-001.png)

2. 在数据源种类中选择 `MongoDB BI Connector`。
   ![](/images/data-connection/connecting-mongo-bi-001.png)

3. 按要求填写连接时数据源的参数。
   ![](/images/data-connection/connecting-mongo-bi-002.png)

   **连接配置信息说明**

   | 字段                                  | 说明                                                       |
   | ------------------------------------- | ---------------------------------------------------------- |
   | 名称                                  | 连接的名称。必填，且用户内唯一                             |
   | 机器地址                              | 数据库的地址。如果填了 url 字段，优先使用 url 里面的       |
   | 端口                                  | 数据库的端口。如果填了 url 字段，优先使用 url 里面的       |
   | 用户名                                | 数据库的用户名                                             |
   | 密码                                  | 数据库的密码                                               |
   | 数据库                                | 数据库名称                                                 |
   | 最大连接数                            | 连接池最大连接数                                           |
   | 认证数据库                            | 用来连接的用户在哪个库中创建的                             |
   | 优先使用数据库 comment 做数据集的标题 | 优先显示表的名字还是表的注释                               |
   | URL                                   | 数据库的 jdbc url                                          |
   | 查询超时时间（秒）                    | 默认为 600. 当数据量较大时,可以适当增加超时时间            |
   | 只显示指定数据库/模式下的表           | 该项选中时并且 database 字段不为空，则只显示该 db 下面的表 |

4. 填好参数后，点击`验证`按钮，获取验证结果(验证 HENGSHI SENSE 和设置的数据连接的连通性，在未验证通过时不可添加)。

5. 验证通过后，点击 `执行预置代码`，弹出该数据源对应的预置代码，点击执行按钮。

6. 点击`添加`按钮，添加  `MongoDB BI Connector` 连接。

> \[!CAUTION] 请注意
>
> 1. 配置参数时带\*的参数是必填参数，其他参数为选填。
> 2. 连接数据源时，必须执行预置代码。不执行会导致数据分析过程中某些函数无法使用。此外，从4.4之前的版本升到4.4时，需要对系统中已经存在的数据连接执行预置代码。

***

### 支持的版本

`2.6.X`、`3.0.X`、`3.2.X` 、`3.4.X`、`3.6.X`、`4.0.X`、`4.2.X`、`4.4.X` 以及 `4.4以上版本`

### 数据连接预览支持

支持一个database下面的所有collection。

### SQL查询数据集对于SQL的支持

SQL查询数据集支持`Mongodb BI connector`语法中的SQL语句。

### 连接认证方式支持

支持无认证，用户名密码认证，不支持SSL。

### 不支持的字段类型

Mongodb的以下类型的列，不能正确处理。

* Object