Docs 菜单
Docs 主页
/
BI Connector

启动 BI Connector

在此页面上

  • Overview
  • 先决条件
  • 正在启动 mongosqld
  • 后续步骤

Overview

mongosqld是将 MongoDB 实例连接到 BI 工具的 BI Connector 程序。mongosqld 需要映射到 MongoDB 集合和数据库的数据模式。您有多个选项可用于创建模式和启动 mongosqld。本指南将帮助您选择最符合需求的选项。

默认情况下，mongosqld 会生成默认数据模式并将其存储在内存中。或者，如果您想创建自定义模式并手动编辑，可使用以下两种方法之一：

  • 使用 mongodrdl 程序创建自定义 .drdl 模式文件，然后使用 --schema 选项启动 mongosqld，指向此文件。

  • 如果您以前使用 upload 命令上传了自定义模式，则必须使用 name-schema 命令，以提供的自定义名称在内部存储模式。然后，您可以使用 --schemaSource、--schemaMode 和 --schemaName 选项启动 mongosqld。

要了解有关创建模式和数据采样的更多信息，请参阅将关系模式映射到 MongoDB。

先决条件

正在启动 mongosqld

可以通过三个选项启动并运行 mongosqld。您可以：

  • 使用 MongoDB Atlas将mongosqld作为托管服务运行

  • 从命令行启动 mongosqld

  • 将 mongosqld 作为一项系统服务进行安装

使用 MongoDB Atlas 将 BI Connector 作为一项托管服务运行

您可以在 MongoDB Atlas 中托管 MongoDB Connector for Business Intelligence。要了解如何启用和连接到 Atlas 托管的 BI Connector，请参阅通过 BI Connector for Atlas 连接。

mongosqld从命令行启动

您可以使用命令行选项，指定要采样的集合和数据库、用户凭证以及其他配置选项。有关命令行选项的完整列表，请参阅命令行选项。

要从命令行启动 mongosqld，请使用任何必要的命令行选项运行 BI Connector 程序目录中的 mongosqld 可执行文件。

以下示例使用 --sampleNamespaces 选项，指定 test 数据库中的 books 集合。

"C:\Program Files\MongoDB\Connector for BI\2.4\bin\mongosqld.exe" --sampleNamespaces test.books

以下示例使用 --sampleNamespaces 选项，指定 test 数据库中的 books 集合。

mongosqld --sampleNamespaces test.books

以下示例使用 --sampleNamespaces 选项，指定 test 数据库中的 books 集合。

mongosqld --sampleNamespaces test.books

以下示例使用 --sampleNamespaces 选项，指定 test 数据库中的 books 集合。

mongosqld --sampleNamespaces test.books

注意

mongosqld 默认为端口 3307。您可以通过为 --addr 选项提供主机地址和端口，手动设置端口号。

mongosqld （带有配置文件）

您可以使用一个配置文件保存所有 mongosqld 配置选项。使用 --config 选项启动 mongosqld，以指定一个配置文件。

"C:\Program Files\MongoDB\Connector for BI\2.4\bin\mongosqld.exe" --config <pathToConfigFile>\mongosqld.conf
mongosqld --config <pathToConfigFile>/mongosqld.conf
mongosqld --config <pathToConfigFile>/mongosqld.conf
mongosqld --config <pathToConfigFile>/mongosqld.conf

将mongosqld 安装为系统服务

BI Connector 作为系统服务运行时，需要指定 mongosqld.systemLog.path 设置的配置文件。使用首选文本编辑器，创建 mongosqld.conf 文件。要查看配置文件选项，请参阅配置文件。例如：

systemLog:
  path: 'C:\logs\mongosqld.log'
net:
  bindIp: '127.0.0.1'
  port: 3307

注意

所有配置文件的文件路径都必须是绝对路径， 并用单引号括起来。例如：

systemLog:
  path: 'C:\logs\mongosqld.log'

要将 mongosqld 作为系统服务安装并运行，请运行以下命令：

"C:\Program Files\MongoDB\Connector for BI\2.4\bin\mongosqld.exe" install --config "<pathToConfigFile>\mongosqld.conf"
net start mongosql

如果安装成功，Windows 将返回 mongosql service installed。

systemLog:
  path: '/logs/mongosqld.log'
net:
  bindIp: '127.0.0.1'
  port: 3307

要将 mongosqld 作为系统服务安装并运行，请运行以下命令：

mongosqld install --config <pathToConfigFile>/mongosqld.conf
launchctl load -w /Library/LaunchDaemons/mongosql.plist
systemLog:
  path: '/logs/mongosqld.log'
net:
  bindIp: '127.0.0.1'
  port: 3307

要将 mongosqld 作为系统服务安装并运行，请运行以下命令：

sudo mongosqld install --config <pathToConfigFile>/mongosqld.conf
sudo systemctl start mongosql.service

要启用该服务以使其在启动时自动启动，请运行以下命令：

systemctl enable mongosql.service
systemLog:
  path: '/logs/mongosqld.log'
net:
  bindIp: '127.0.0.1'
  port: 3307

要将 mongosqld 作为系统服务安装并运行，请运行以下命令：

sudo mongosqld install --config <pathToConfigFile>/mongosqld.conf
sudo systemctl start mongosql.service

要启用该服务以使其在启动时自动启动，请运行以下命令：

systemctl enable mongosql.service

后续步骤

BI Connector 启动并运行后，您可以将 BI Connector 与首选的 BI 工具一起使用。有关连接教程的选定列表，请参阅连接 BI 工具。