MongoDB之MongoDBConnectorBI安装与使用

MongoDB之MongoDBConnectorBI安装与使用

1. What is the MongoDB Connector for BI?

1. 官网

官网下载地址：https://www.mongodb.com/try/download/bi-connector

官网使用说明：https://docs.mongodb.com/bi-connector/master

2. 是什么？

1. MongoDB BI连接器允许您使用MongoDB作为BI和分析平台的数据源。无缝创建可视化和仪表板，帮助您提取多结构数据中的见解和隐藏价值。

2. MongoDB Connector for BI允许您使用自己选择的BI工具，使用标准SQL查询对MongoDB数据进行可视化、发现和报告。

3. MongoDB Connector for BI作为MongoDB Enterprise Advanced订阅的一部分提供，该订阅具有对MongoDB最全面的支持和最佳的SLA。

4. 传统的商业智能工具设计用于处理表格、行和列数据。MongoDB Connector for BI允许您使用Tableau、Power BI和Excel等工具使用SQL查询MongoDB数据。

5. MongoDB Connector for BI 是一个官方提供的工具，用于连接 MongoDB 数据库与商业智能（BI）工具，如Tableau、Power BI 或 Qlik。它的作用是使用户能够直接使用这些流行的 BI 工具来查询、分析和可视化 MongoDB 数据库中的数据，而无需进行复杂的数据迁移或转换。

3. 主要功能和作用

1. 提供 SQL 接口：该连接器允许用户使用 SQL 查询语言来查询 MongoDB 数据库，从而使使用传统的 SQL 查询方法的用户能够直接访问 MongoDB 数据。
2. 实时数据连接：连接器支持实时连接到 MongoDB 数据库，确保 BI 工具中的数据分析和可视化是基于最新的数据库数据。
3. 数据转换：连接器能够对 MongoDB 中的数据进行必要的转换和处理，以便更好地适应 BI 工具的数据模型和需求。
4. 轻量级查询：连接器使用聚合框架来执行轻量级查询，避免了在复杂查询中处理大量数据时的性能问题。

4. 应用用场景

应用场景包括如下但不限于此

1. 数据分析和可视化：通过连接 MongoDB 数据库与 BI 工具，用户可以进行数据分析并生成各种图表、报表和可视化结果，从而更好地理解和展示数据。
2. 实时监控和报警：连接 MongoDB 数据库与 BI 工具可以实现对数据的实时监控和分析，帮助用户即时发现数据中的趋势、异常或重要信息，并触发相应的报警机制。
3. 综合数据报告：将 MongoDB 数据库中的数据整合到 BI 工具中，可以生成更全面、综合的数据报告，帮助企业管理层做出更为准确的决策。

2. 安装及说明

1. 前提条件

1. 主机上必须安装Visual Studio 2015的Visual C ++运行库。
2. 需要先安装MongoDB数据库服务

2. 在Windows下的安装

1. 去官网下载 DB Connector BI
2. 笔者这里下载的时mongodb-bi-win32-x86_64-v2.14.0.msi
3. 直接点击mongodb-bi-win32-x86_64-v2.14.0.msi安装即可

3.启动与运行

有三种启动和运行mongosqld的方式

• Run mongosqld as a hosted service with MongoDB Atlas
• Start mongosqld from the command line
• Install mongosqld as a system service

1. 配置

生成DRDL文件(Document-Relational Definition Language)

1. 未开启Monogodb登录认证时生成DRDL文件

# 命令,进入到mongodb-bi安装的bin目录下
mongodrdl --host IP -d [数据库名] [-c 集合名] -o schema.drdl
# 如：mongodrdl --host 127.0.0.1 -d yuan -o schema.drdl
# 参数说明：
--host: 指定主机IP
-d:数据库名
-c:集合名，不指定则为所有集合
-o:drdl文件输出位置
# 如果MongoDB启用了密码，则在生成DRDL时，还需要加-u -p --authenticationDatabase这些认证选项，才能生成DRDL。

2. 开启Monogodb登录认证时生成DRDL文件

1.需要下载C Authentication Plugin，下载地址：https://github.com/mongodb/mongosql-auth-c/releases

2.将下载后的文件解压缩，拷贝lib目录下的mongosql_auth.so或mongosql_auth.dll到MySQL的插件目录中即可，如：xxx/mysql/lib/plugin目录

# 开启MongoDB认证时,生成DRDL文件的命令：
# mongodrdl --host 127.0.0.1 -d yuandb -o yuandb_schema.drdl -u admin -p admin123 --authenticationDatabase admin 
# 注：--authenticationDatabase 后面必须为admin数据库
# 具体用法如下：
D:\Program Files\MongoDB\Connector for BI\2.14\bin>mongodrdl --host 127.0.0.1 -d yuandb -o yuandb_schema.drdl -u admin -p admin123 --authenticationDatabase admin

3. 将生成的xxx.drdl路径配置到 example-mongosqld-config.yml文件中的path属性中，如下：

schema:
  # 这里配置生成的xxx.drdl文件
  path: "D:\Program Files\MongoDB\Connector for BI\2.14\bin\yuandb_schema.drdl"
  refreshIntervalSecs: 0
  stored:
    mode: "custom" # "auto"|"custom"
    source: "mongosqld_data" # the database where schemas are stored in stored-schema modes
    name: "mySchema" # the named schema to read/write to in stored-schema modes
  sample:
    size: 1000 # The amount of random documents we sample from each collection.
    namespaces: ["*.*"]

2. 启动mongosqld

使用mongodrdl生成的DRDL文件，可以直接启动mongosqld

# 使用命令 mongosqld --schema schema.drdl 启动
D:\Program Files\MongoDB\Connector for BI\2.14\bin>mongosqld --schema schema.drdl

4. 通过MySQL访问Mongodb

1. 无认证的连接

# 本地执行命令：mysql --protocol tcp --port 3307
C:\Users\Administrator>mysql --protocol tcp --port 3307

2. 有认证的连接

C:\Users\Administrator>mysql mysql '--user=admin?source=admin' --default-auth=mongosql_auth -p

注意：这一步输入的用户名--user为MongoDB的用户名，source=指定认证数据库(如admin),而非MySQL Server的用户名密码，也即与MySQL Server无关了