/ /

部署 BI Connector

MongoDBconnectorfor Business Intelligence 允许您使用MongoDB database SQL命令查询，以帮助进行数据分析。它将SQL 查询从数据分析工具转换为针对MongoDB 的MongoDB database 聚合管道。要了解有关 BI Connector 的更多信息，请参阅BI Connector 手册。

使用以下过程为 Ops Manager 部署新的 MongoDB BI Connector 进行托管。

限制

BI Connector仅允许对MongoDB数据库中提供的数据执行只读操作。要创建、更新或删除数据，您必须使用mongosh 或任何适当的驾驶员。
MongoDB BI Connector for MongoDB Ops Manager与以下身份验证方法不兼容：
- Kerberos
- x.509
BI ConnectorMongoDB Ops Manager如果自动化代理身份验证机制是Kerberos (GSSAPI ) 身份验证，则无法使用部署。
BI Connector会跳过包含句点 (.) 的字段名称，例如 price.usd。此类字段不会出现在输出模式中。

先决条件

要部署 MongoDB 集群，您必须预配主机来为这些集群提供服务。 Ops Manager 需要访问这些主机。

重要

如果您运行MongoDB Enterprise并预配自己的Linux主机，则必须在安装MongoDB之前在每台服务器上安装所需的依赖项。MongoDB手册提供了相应的命令来安装依赖项。

要进一步了解操作系统的具体情况，请参阅下文：

步骤

导航至 Processes标签页进行部署。

如果尚未显示，请从导航栏的 Organizations 菜单中选择包含所需项目的组织。
如果尚未显示该页，请从导航栏的 Projects（项目）菜单中选择所需的项目。
单击侧边栏中的 Processes（支持）。

选择 New BI Connector。

单击 Add New 下拉菜单。
单击 New BI Connector（连接）。

配置 BI Connector 实例。

在New BI Connector模式中，配置以下设置：

Choose Server	选择安装此新 BI Connector 的主机。
Deployment Item	选择此新 BI Connector 所连接的部署项目（独立、副本集或分片集群）。
Port to Listen On	输入连接到这个新的BI Connector时要使用的 IANA 端口号。建议的端口号是 `3306`。
Read Preference	选择 BI Connector 将读取操作路由到副本集节点的方式。可用值包括： `Primary` `Primary Preferred` `Secondary Only` `Secondary Preferred` `Nearest`
Included Namespace(s) （可选）	键入数据库和/或collection的名称，以限制 BI Connector 可以访问的数据。将此框留空以允许 BI Connector 使用主机上的所有命名空间。单击+ add another namespace链接将另一个命名空间添加到包含的命名空间列表中。

注意

Ops Manager 托管 BI Connector 版本。您不能选择其他版本的 BI Connector。

为BI Connector实例设置任意 Additional settings。

TLS （可选）

如果需要使用TLS与部署项连接，请配置以下设置：

TLs Mode	选择Disabled 、 Allow TLS或Require TLS 。
TLS PEM Key File Path	输入 MongoDB 主机上存储 TLS PEM 密钥文件的路径。
TLS PEM Key Password （可选）	如果您加密了 PEM 文件，请键入其密码。
Minimum TLS Version	选择连接BI Connector 的最低 TLS 版本。默认值为 `TLS1_0`。接受的值为 `TLS1_0`、`TLS1_1` 和 `TLS1_2`。
MongoDB Minimum TLS Version	选择连接到MongoDB 的最低 TLS 版本。默认值为 `TLS1_0`。接受的值为 `TLS1_0`、`TLS1_1` 和 `TLS1_2`。

Logs （必需）

Linux Log File Path	（条件：Linux 平台上安装了 BI Connector）键入该主机上 BI Connector 日志的路径。
Windows Log File Path	（条件：Windows 平台上安装了 BI Connector）键入该主机上 BI Connector 日志的路径。
Log Verbosity	选择 BI Connector 的日志记录级别。接受的值为`Lowest` 、 `Medium` 、 `Highest` 。这些值分别对应于日志详细程度级别 `0`、`1` 和`2` 。
Log Rotation	切换到`ON`以启用。默认值为`OFF` 。如果切换为`ON` ，则在满足Size Threshold或Time Threshold时进行日志轮换。接下来的四个设置要求将Log Rotation设为`ON` 。
Size Threshold (MB)	（条件： Log Rotation = `ON` ）键入BI Connector自动轮换日志文件之前必须达到的大小（以 MB 为单位）。默认值为 `1000.0`（约 1 GB ）。
Time Threshold (Hours)	（条件： Log Rotation = `ON` ）键入BI Connector自动轮换日志文件之前必须涵盖的持续时间（以小时为单位）。默认值为`24`小时。
Max Uncompressed Files	（条件： Log Rotation = `ON` ）键入在存档和压缩之前，在日志目录中可以保持未压缩状态的轮换日志文件数量。（建议数字为`2` 。）
Max Percent of Disk	（条件： Log Rotation = `ON` ）键入在删除旧文件之前日志文件可能占用的托管磁盘空间百分比。（建议数字为`5` 。）

Schema （可选）

Max Length for varChar Fields	在`VARCHAR`字段中键入可以存在的最大字符数。
Refresh Interval (Seconds)	键入在经过多少时长（以秒为单位）后 BI Connector 会刷新模式。
Sample Size (# of Documents in Collection)	输入模式检查的每个样本中包含的 MongoDB 文档数量。要进一步了解 BI Connector 如何执行采样，请参阅缓存采样。
Allow Schema Alterations from SQL Client	决定用户能否使用 SQL 客户端更改模式。

单击 Create（保存并关闭）。

单击Review & Deploy 查看更改。

单击Confirm & Deploy 以部署更改。

否则，请单击 Cancel，您可以进行其他更改。