对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

将您的 SQL 工具连接到 MongoDB

将 SQL 工具(例如 Tableau、Power BI 或 DBeaver)连接到 MongoDB Atlas 或 Enterprise Advanced (EA) 数据库。

所有三种 SQL Interface 部署选项都使用相同的 JDBC 和 ODBC 驱动程序,因此,无论连接到 Atlas 专用集群、Atlas 联合数据库实例还是自管理的 Enterprise Advanced (EA) 部署,本页面上的步骤都是相同的。首先配置您的部署以接受 SQL 连接。欲了解如何操作,请参阅 SQL 界面服务器设置。

注意

MongoDB officially supports Tableau (Desktop, Server, or Cloud) and Power BI Desktop (Desktop and Service) with its JDBC and ODBC drivers. You can use the JDBC and ODBC drivers with other SQL-92 compatible tools, but MongoDB cannot guarantee compatibility. Test your specific SQL Interface features to confirm support.

Grafana 和 Metabase 等工具提供了自己的 MongoDB 连接器和插件,但 MongoDB 并不正式支持这些集成。有关设置信息,请参阅 Grafana MongoDB 数据源 和 Metabase MongoDB 文档。

使用适用于 MongoDB 的 Tableau Connector,将 Atlas 专用集群、Atlas 联合数据库实例或自托管的 Enterprise Advanced (EA) 数据库连接到 Tableau(桌面版或服务器版)。

以下步骤向您展示如何使用Tableau连接到MongoDB :

1

注意

Tableau Desktop 和 Tableau 服务器 2025 及更高版本捆绑了适用于 MongoDB 的 Tableau Connector。如果您的 Tableau 版本已包含该连接器,请跳过此步骤。如需使用不同于 Tableau 捆绑版本的其他版本,请完成此步骤。

对于 Tableau Desktop,您也可以从 Tableau 安装连接器。在 Tableau Exchange 中搜索 MongoDB SQL interface by MongoDB,然后点击 Install and restart Tableau。

  1. 从MongoDB下载中心下载最新的Tableau Connector taco文件。

  2. 将 taco文件移至操作系统的相应目录中:

    • Windows: C:\Users\<user>\Documents\My Tableau Repository\Connectors

    • MacOS: ~/Documents/My Tableau Repository/Connectors

    • Linux: /opt/tableau/connectors

重要

如果您下载新版本的适用于MongoDB的Tableau Connector,请从 Connectors目录中删除上一个 taco文件,以确保Tableau使用最新版本。

2

选择与您的部署类型对应的标签页,获取有关如何获取连接信息的说明:

  1. Go 到项目的 Atlas 专用集群或联合数据库实例。

  2. 单击 Connect(连接)。

  3. 选择 Atlas SQL Interface 选项。

  4. 选择 Select your driver 下拉列表下的 Tableau Connector 选项。

  5. 从下拉列表中选择 Tableau。

  6. 从 Database 下拉列表中选择要连接的数据库。

  7. 复制连接字符串和连接参数。

    在后续步骤中,请使用此信息与Tableau连接。

3
4
5

显示连接模式。

6

输入您在上一步中保存的SQL接口连接字符串。

7

从下拉列表中选择您的 Authentication Mechanism。

有关所有支持的身份验证机制的信息,请参阅SQL接口身份验证。

  • Username:输入您的MongoDB用户名。

  • Password:输入您的MongoDB密码。

8

要更改 MongoDB JDBC 驱动程序的日志配置,请将日志属性添加到 mongodb_jdbc.properties 文件中。此文件的位置取决于您的平台:

平台
路径

macOS

~/Documents/My Tableau Repository/Datasources/mongodb_jdbc.properties
~/Documents/My Tableau Prep Repository/Datasources/mongodb_jdbc.properties

Windows

C:\Users\<username>\Documents\My Tableau Repository\Datasources\mongodb_jdbc.properties
C:\Users\<username>\Documents\My Tableau Prep Repository\Datasources\mongodb_jdbc.properties

Tableau 服务器 (RHEL)

/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/mongodb_jdbc.properties

将此文件复制到所有服务器节点。

要配置日志记录,请将以下属性添加到文件中:

loglevel=INFOlogdir=<path-to-log-directory>

loglevel 属性用于设置驱动程序日志的详细程度。它接受以下值,按详细程度递增排序:OFF、SEVERE、WARNING、INFO、FINE 和 FINER。默认值为 OFF。

logdir 属性设置驱动程序写入日志文件的目录。目录必须已经存在。如果您省略 logdir 或将其设置为 console,则驱动程序会将日志写入控制台,而不是写入文件。

重要

在生产环境中,请从 SEVERE 日志级别开始。仅在必须诊断问题时才提高级别,因为每个级别都会增加大量输出。在 FINER 级别,驱动程序会记录日志,记录每个结果集中每个单元格检索数据的每次调用。

要了解有关 Tableau 属性文件的更多信息,请参阅 Tableau 文档。

使用 Power BI Connector for MongoDB 将 Atlas 专用集群、Atlas 联合数据库实例或自托管 Enterprise Advanced (EA) 数据库连接到 Power BI。

  • MongoDB ODBC 驱动程序。要安装,请参阅 SQL 接口驱动程序设置。要使用 Direct Query,必须安装 1.2 或更高版本。

  • Power BI 桌面 64 位。Microsoft 每月会更新并发布一次 Power BI,Atlas 仅支持最新版本的 Power BI Desktop。

  • Windows操作系统。要学习;了解Power BI Desktop 支持的Windows操作系统版本,请参阅Microsoft文档。

以下步骤向您展示如何使用 Power BI连接到MongoDB :

1
  1. 从MongoDB下载中心下载最新的 Power BI Connector pqx文件。

    注意

    Power BI Connector for MongoDB随 Power BI Desktop 一起提供。如果您的 Power BI Desktop 版本已有MongoDB Atlas SQL Connector,请跳过此步骤。要使用与 Power BI Desktop 捆绑版本不同的版本,请完成此步骤。

  2. 将Connector文件移至以下目录路径:

    C:\Users\<user>\Documents\Power BI Desktop\Custom Connectors.

    如果这个文件夹不存在,请创建。

2

选择与您的部署类型对应的标签页,获取有关如何获取连接信息的说明:

  1. Go 到项目的 Atlas 专用集群或联合数据库实例。

  2. 单击 Connect 按钮。

  3. 选择 Atlas SQL Interface 选项。

  4. 选择 Select your driver 下拉列表下的 Power BI Connector 选项。

  5. 复制连接字符串。

    请使用此信息在后续步骤中连接到 Power BI。

3
  1. 打开 Power BI Desktop。

  2. 从 Home 菜单中选择 Get data。

  3. 查找并选择 MongoDB Atlas SQL 连接器。

    1. 在搜索栏中键入 mongo 以查找新 connector。

    2. 选择 MongoDB Atlas SQL 。

    3. 单击 Connect(连接)。

  4. 输入 URI 和数据库名称,然后单击 OK。

    MongoDB URI 是您在上一个步骤中复制的连接字符串。

    在 Native query 字段中,您可以选择输入 SQL 查询。Power BI 使用 SQL 查询作为数据的直接来源。连接后,您还可以在 Power Query 编辑器中添加或更改 SQL 查询。

  5. 输入您的 Atlas User name 和 Password,然后点击 Connect。

    默认情况下,用户可以访问其角色和连接 URI 允许的所有命名空间。如果您使用自定义角色来限制访问,则可以在 Edit User 菜单中授予用户对其他命名空间的访问权限。要了解更多信息,请参阅 配置数据库用户。

    有关其他支持的身份验证机制的信息,请参阅SQL接口身份验证。

Direct Query 是 MongoDB Power BI Connector 版本 1.2 及更高版本中提供的一种连接模式。要使用 Direct Query,必须安装 MongoDB ODBC 驱动程序 1.2 或更高版本。您不需要配置 DSN。

Direct Query 是标准导入模式的替代方案,允许您直接查询数据库。这 ACID 一致性保证数据是最新的,但可能需要更长的时间才能返回结果。

直接查询不支持某些操作。 如果您尝试执行不支持的动作,Power BI会提示您切换到导入模式。

Connect your Atlas dedicated cluster, Atlas federated database instance, or self-managed Enterprise Advanced (EA) deployment to DBeaver using the MongoDB JDBC Driver.

要从 DBeaver 连接:

1

选择与您的部署类型对应的标签页,获取有关如何获取连接信息的说明:

  1. Go 到项目的 Atlas 专用集群或联合数据库实例。

  2. 单击 Connect 按钮。

  3. 选择 Atlas SQL Interface 选项。

  4. 选择 Select your driver 下拉列表下的 JDBC Driver 选项。

  5. 从 Database 下拉列表中选择要连接的数据库。

  6. 复制连接字符串。

    请使用此信息在后续步骤中连接到 DBeaver。

2
3
  1. 在 DBeaver 中,单击 Database(数据库),然后从下拉菜单中选择 Driver Manager(驱动程序管理器)。

  2. 单击 New 打开 Create new driver 模式。

  3. 在 Settings标签页中,指定以下信息:

    驱动程序名称

    MongoSQL

    类名

    com.mongodb.jdbc.MongoDriver

  4. 在 Libraries 标签页中,单击 Add File 并添加 JDBC 驱动程序 all.jar 文件。

    单击 Find Class(连接)。

  5. 单击 OK(确定)。Create new driver 模式窗口将关闭。

4
  1. 在 DBeaver 中,单击 Database 并从下拉菜单中选择 New Database Connection,打开 Connect to a database 模式。

  2. 从数据库列表中,选择您在上一步中创建的 MongoDB 数据库驱动程序。

    如果没有看到 MongoDB,请在模式窗口中选择 All(全部)类别。

    单击 Next(连接)。

  3. 在 Main(设置)标签页中,输入以下信息:

    JDBC URL

    从上一步中获取的连接字符串。

    用户名

    已获得连接授权的MongoDB用户。

    密码

    与MongoDB用户关联的密码。

  4. 在 Driver properties(驱动程序属性)标签页中,展开 User Properties(用户属性)。添加以下键值属性:

    database

    虚拟数据库的名称。

    user

    用于连接的 MongoDB 用户。如果您在上一步中输入了 Username,则不是必需的。

将 SQL 工具连接到 MongoDB 数据库后,您就可以查询数据了。要了解详情,请参阅:

注意

要使用私有端点进行连接,请参阅使用私有端点连接到 MongoDB SQL 接口。