将 BI 工具(例如Tableau、Power BI或 DBeaver)连接到MongoDB Atlas或 Enterprise Advanced (EA) 数据库。
注意
MongoDB officially supports Tableau (桌面或服务器) and Power BI Desktop (桌面和服务) with its JDBC and ODBC 驱动程序.您可以将 JDBC 和 ODBC 驱动程序与其他SQL-92 BI工具一起使用,但MongoDB不能保证兼容性。测试特定的SQL接口功能以确认支持。
连接Tableau
使用适用于MongoDB的Tableau连接器,将Atlas联合数据库实例或自托管Enterprise Advanced (EA)数据库连接到Tableau (桌面版或服务器版)。
先决条件
MongoDB 数据库,为SQL接口配置。
MongoDB JDBC 驱动程序。要进行安装,请参阅安装 JDBC驱动程序。
步骤
以下步骤向您展示如何使用Tableau连接到MongoDB :
下载适用于MongoDB的Tableau连接器。
从MongoDB下载中心下载最新的Tableau Connector
taco文件。将
taco文件移至操作系统的相应目录中:Windows:
C:\Users\<user>\Documents\My Tableau Repository\ConnectorsMacOS:
~/Documents/My Tableau Repository/ConnectorsLinux:
/opt/tableau/connectors
重要
如果您下载新版本的适用于MongoDB的Tableau Connector,请从 Connectors目录中删除上一个 taco文件,以确保Tableau使用最新版本。
获取MongoDB 数据库连接信息。
选择与您的部署类型对应的标签页,获取有关如何获取连接信息的说明:
Go您项目的Atlas联合数据库实例。
单击 Connect 按钮。
选择 Atlas SQL Interface 选项。
选择 Select your driver 下拉列表下的 Tableau Connector 选项。
从下拉列表中选择 Tableau。
从 Database 下拉列表中选择要连接的数据库。
复制连接字符串和连接参数。
在后续步骤中,请使用此信息与Tableau连接。
使用 mongosh 的连接字符串。
选择身份验证方法。
从下拉列表中选择您的 Authentication Mechanism。
Username:输入您的MongoDB用户名。
Password:输入您的MongoDB密码。
使用以下方法之一配置 PEM 证书:
使用 PEM 文件路径:
在
mongodb_jdbc.properties文件中,将x509pempath属性设立为 PEM 文件的路径。示例,x509pempath=/certs/client-cert.pem。如果您的 PEM 文件是未加密的,请勿选择 Provide PEM Contents。无需采取进一步操作。
如果您的 PEM 文件已加密,请选择 Provide PEM Contents 并在 Password 字段中输入文件的密码。
提供 PEM 内容:
选中 Provide PEM Contents 旁边的复选框,然后在 Password字段中输入您的证书数据:
未加密内容:将完整的证书内容直接粘贴到字段。
加密内容:粘贴包含以下内容和密码的JSON对象:
{ "pem": "<PEM-CONTENT>", "passphrase": "<PEM-PASSPHRASE>" }
在 Username字段中输入Kerberos主体名称。示例,user@EXAMPLE.COM。
OIDC 的连接对话框中不需要其他属性或字段。
连接 Power BI
使用 Power BI Connector for MongoDB将Atlas联合数据库实例或自托管Enterprise Advanced (EA)数据库连接到 Power BI 。
先决条件
为SQL接口配置的MongoDB 数据库。
MongoDB ODBC 驱动程序。要进行安装,请参阅安装 ODBC驱动程序。要使用About direct query,必须安装 1.2 或更高版本。
Power BI 桌面 64 位。Microsoft 每月会更新并发布一次 Power BI,Atlas 仅支持最新版本的 Power BI Desktop。
Windows操作系统。要学习;了解Power BI Desktop 支持的Windows操作系统版本,请参阅Microsoft文档。
步骤
以下步骤向您展示如何使用 Power BI连接到MongoDB :
下载适用于MongoDB的 Power BI Connector 。
从MongoDB下载中心下载最新的 Power BI Connector
pqx文件。注意
Power BI Connector for MongoDB随 Power BI Desktop 一起提供。如果您的 Power BI Desktop 版本已有MongoDB Atlas SQL Connector,请跳过此步骤。要使用与 Power BI Desktop 捆绑版本不同的版本,请完成此步骤。
将Connector文件移至以下目录路径:
C:\Users\<user>\Documents\Power BI Desktop\Custom Connectors.如果这个文件夹不存在,请创建。
从 Power BI Desktop 连接。
打开 Power BI Desktop。
从 Home 菜单中选择 Get data。
查找并选择 MongoDB Atlas SQL 连接器。
在搜索栏中键入
mongo以查找新 connector。选择 MongoDB Atlas SQL 。
单击 Connect(连接)。
输入 URI 和数据库名称,然后单击 OK。
MongoDB URI 是上一步骤中的 URL。
您还可以在 Native query 字段中输入 SQL 查询。Power BI 使用 SQL 查询作为数据的直接来源。
输入您的 Atlas User name 和 Password,然后点击 Connect。
默认下,用户可以访问权限他们有权访问权限的项目中的所有集群和联合数据库实例。如果限制了对特定集群和联合数据库实例的访问权限,则可以在 Edit User 菜单中授予对新联合数据库实例的访问权限。要学习;了解更多信息,请参阅配置数据库用户。
关于直接查询
direct query 是 Power BI BI Connector for MongoDB 1.2 及更高版本提供的一种连接模式。要使用直接查询,必须安装MongoDB ODBC驱动程序版本 1.2 或更高版本。
直接查询是标准导入模式的替代方案,允许您直接查询数据库。 这ACID 一致性保证数据是最新的,但可能需要更长的时间才能返回结果。
直接查询不支持某些操作。 如果您尝试执行不支持的动作,Power BI会提示您切换到导入模式。
连接 DBeaver
使用 MongoDB JDBC 驱动程序将 Atlas 联合数据库实例连接到 DBeaver 。
先决条件
映射到一个或多个数据存储的Atlas联合数据库实例。要学习;了解更多信息,请参阅部署联合数据库实例。
注意
如果您的部分或全部数据来自Atlas 集群,则必须为该集群使用MongoDB 5.0 或更高版本才能利用 MongoSQL。
MongoDB JDBC 驱动程序。要进行安装,请参阅安装 JDBC驱动程序。
步骤
要从 DBeaver 连接到联合数据库实例,请执行以下操作:
在 Atlas 中,转到项目的联合数据库实例。
如果尚未显示,请从导航栏上的 Organizations 菜单中选择包含项目的组织。
如果尚未显示,请从导航栏的 Projects 菜单中选择您的项目。
在侧边栏中,单击 Services 标题下的 Data Federation。
显示Data Federation 页面。
打开DBeaver应用程序。
创建一个数据库连接。
在 DBeaver 中,单击 Database 并从下拉菜单中选择 New Database Connection,打开 Connect to a database 模式。
从数据库列表中,选择您在上一步中创建的
MongoDB数据库驱动程序。如果没有看到
MongoDB,请在模式窗口中选择 All(全部)类别。单击 Next(连接)。
在 Main(设置)标签页中,输入以下信息:
JDBC URL
从上一步中获取的连接字符串。
用户名
已获得连接授权的MongoDB用户。
密码
与MongoDB用户关联的密码。
在 Driver properties(驱动程序属性)标签页中,展开 User Properties(用户属性)。添加以下键值属性:
database
虚拟数据库的名称。
user
用于连接的 MongoDB 用户。如果您在上一步中输入了
Username,则不是必需的。
后续步骤
将BI工具连接MongoDB 数据库后,您可以查询数据。要学习;了解详情,请参阅:
注意
要使用私有端点进行连接,请参阅使用联合数据库实例私有端点连接到 MongoSQL。要使用MongoDB Shell进行连接,请参阅从MongoDB Shell进行连接。