将SQL工具（例如Tableau、Power BI或 DBeaver）连接到MongoDB Atlas或Enterprise Advanced (EA)数据库。
所有三个SQL接口部署选项都使用相同的 JDBC 和 ODBC 驱动程序，因此无论您是连接到Atlas专用集群、 Atlas联合数据库实例还是自管理的Enterprise Advanced (EA)部署，此页面上的步骤都是相同的。将部署部署为首先接受SQL连接。要学习；了解如何操作，请参阅SQL接口服务器设置。
注意
MongoDB及其 JDBC 和 ODBC 驱动程序正式支持Tableau （桌面、服务器或云）和 Power BI Desktop（桌面和服务）。您可以将 JDBC 和 ODBC 驱动程序与其他SQL-92 兼容工具一起使用，但MongoDB不能保证兼容性。测试特定的SQL接口功能以确认支持。
连接Tableau
使用适用于MongoDB的Tableau连接器，将Atlas专用集群、 Atlas联合数据库实例或自托管Enterprise Advanced (EA)数据库连接到Tableau （桌面版或服务器版）。
先决条件
为SQL接口配置的MongoDB 数据库：
步骤
以下步骤向您展示如何使用Tableau连接到MongoDB ：
下载适用于MongoDB的Tableau连接器。
注意
Tableau桌面和Tableau服务器版本 2025 及更高版本捆绑了适用于MongoDB的Tableau连接器。如果您的Tableau版本已包含Connector，请跳过此步骤。若要使用与Tableau捆绑版本不同的版本，请完成此步骤。
对于Tableau Desktop，您还可以从Tableau安装Connector。在Tableau Exchange 中搜索 MongoDB SQL interface by MongoDB，然后单击 Install and restart 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连接。
使用与MongoDB Java驾驶员兼容的连接字符串。要学习；了解详情，请参阅连接 URI。
选择身份验证方法。
从下拉列表中选择您的 Authentication Mechanism。
有关所有支持的身份验证机制的信息，请参阅SQL接口身份验证。
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 的连接对话框中不需要其他属性或字段。
配置Tableau日志记录
要更改MongoDB JDBC驾驶员的日志记录配置，请将日志记录属性添加到 mongodb_jdbc.properties文件。此文件的位置取决于您的平台：
平台 | 路径 |
|---|---|
macOS |
|
Windows |
|
Tableau Server (RHEL) |
将此文件复制到所有服务器节点。 |
要配置日志记录，请将以下属性添加到文件：
loglevel=INFO logdir=<path-to-log-directory>
loglevel属性设置驾驶员程序日志的详细程度。它按详细程度递增的顺序接受以下值：OFF、SEVERE、WARNING、INFO、FINE 和 FINER。默认值为 OFF。
logdir属性设置驾驶员写入日志文件的目录。该目录必须已经存在。如果省略 logdir 或将其设立为 console，驾驶员会将日志写入控制台，而不是文件。
重要
在生产环境中，从 SEVERE日志级别开始。仅在必须诊断问题时才提升级别，因为每个级别都会增加大量输出。在 FINER 级别，驾驶员会记录为每个结果设立的每个单元格检索数据的每次调用。
连接 Power BI
使用 Power BI Connector for MongoDB将Atlas专用集群、 Atlas联合数据库实例或自托管Enterprise Advanced (EA)数据库连接到 Power BI 。
先决条件
为SQL接口配置的MongoDB 数据库：
MongoDB ODBC驾驶员。要进行安装，请参阅SQL接口驱动程序安装程序。要使用 Direct Query，必须安装 1.2 或更高版本。
Power BI Desktop64 位。 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 是您在上一步中复制的连接字符串。
在 Native query字段中，您可以选择输入SQL查询。 Power BI使用SQL查询作为数据的直接来源。连接后，您还可以在 Power Query 编辑器中添加或更改SQL查询。
输入您的 Atlas User name 和 Password，然后点击 Connect。
默认下，用户可以访问权限其角色和连接 URI 允许的所有命名空间。如果使用自定义角色来限制访问权限，则可以在 Edit User 菜单中授予用户对其他命名空间的访问权限。要学习；了解更多信息，请参阅配置数据库用户。
有关其他支持的身份验证机制的信息，请参阅SQL接口身份验证。
直接查询
直接查询是 Power BI Connector for MongoDB 1.2 及更高版本提供的一种连接模式。要使用直接查询，必须安装MongoDB ODBC驱动程序版本 1.2 或更高版本。您无需配置 DSN。
直接查询是标准导入模式的替代方案，允许您直接查询数据库。这ACID 一致性保证数据是最新的，但可能需要更长的时间才能返回结果。
直接查询不支持某些操作。 如果您尝试执行不支持的动作，Power BI会提示您切换到导入模式。
连接 DBeaver
使用MongoDB JDBC驱动程序将Atlas专用集群、 Atlas联合数据库实例或自管理Enterprise Advanced (EA)部署连接到 DBeaver。
先决条件
为SQL接口配置的MongoDB 数据库：
步骤
要从 DBeaver 连接：
获取MongoDB 数据库连接信息。
选择与您的部署类型对应的标签页，获取有关如何获取连接信息的说明：
Go您项目的Atlas专用集群或联合数据库实例。
单击 Connect 按钮。
选择 Atlas SQL Interface 选项。
选择 Select your driver 下拉列表下的 JDBC Driver 选项。
从 Database 下拉列表中选择要连接的数据库。
复制连接字符串。
在后续步骤中，请使用此信息与 DBeaver 连接。
使用与MongoDB Java驾驶员兼容的连接字符串。要学习；了解详情，请参阅连接 URI。
打开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，则不是必需的。
后续步骤
将SQL工具连接到MongoDB 数据库后，您可以查询数据。要学习；了解详情，请参阅：