使用身份验证从 Tableau Desktop 进行连接

下载并安装 MongoDB BI Connector ODBC 驱动程序 。

下载 MongoDB BI Connector ODBC 驱动程序并运行 Windows 安装程序 (.msi)。

创建系统 DSN。

为了将 Tableau 安全地连接到 BI Connector，系统 DSN 配置为使用 MongoDB BI Connector ODBC 驱动程序 为必填项。要创建系统 DSN，请按照以下步骤操作：

1. 启动 Microsoft ODBC Data Sources 程序。

   选择适合系统和 ODBC 驱动程序版本的 程序版本（64 位或 32 位）。

2. 选择 System DSN 标签页。

3. 单击 Add 按钮。

   

   点击放大

4. 从可用驱动程序列表选择 MongoDB BI Connector ODBC 驱动程序。

   选择 MongoDB ODBC ANSI Driver或MongoDB ODBC Unicode Driver ，然后单击OK 。

   注意

   ANSI ODBC 驱动程序可以提供最高性能，但字符集有限。Unicode ODBC 驱动程序支持更广泛的字符集，但性能可能略有下降。

5. 填写必需的表单字段。

   单击 Details 按钮，显示表单的下半部分。

   以下表单字段是必填字段：

   字段名称	说明
   Data Source Name	所选择的名称。
   TCP/IP Server	运行 mongosqld 进程的服务器的地址。如果您已在 MongoDB Atlas 上启用 BI Connector，则可以在集群的连接信息找到运行 mongosqld 的服务器的主机名。
   Port	mongosqld 进程的端口号。
   Database	要连接的数据库的名称，例如test。

6. 提供连接信息。

   在启用 --auth 的情况下运行或连接 BI Connector for Atlas 实例时，需要以下字段。

   字段名称	说明
   User	已通过身份验证可使用目标数据库的 MongoDB 用户的用户名。 您可以在用户名后指定以下身份验证选项，作为 URI 形式的查询参数： 连接选项 说明 source 指定存储该用户凭证的数据库名称。如果不指定此选项，MongoDB Connector for BI 将默认使用当前与 MySQL 连接关联的数据库。 对于将凭证存储委托给其他服务的身份验证机制，例如 PLAIN (LDAP) 或 GSSAPI (Kerberos)，请将 source 值设置为 $external。 如果在 MongoDB Connector for BI 配置文件中设置了 defaultSource，则无需配置该选项。 mechanism 指定 MongoDB Connector for BI 应使用的机制来验证连接。可被接受的值包括： SCRAM-SHA-1（默认） SCRAM-SHA-256 普通版 (LDAP SASL) GSSAPI (Kerberos) LDAP 和 Kerberos 需要 MongoDB Enterprise 。使用 LDAP 或 Kerberos 时，将源设置为 $external。 如果在 MongoDB Connector for BI 配置文件中设置了 defaultMechanism，则无需配置该选项。 不支持 X.509。 用户名和密码 LDAP Kerberos 例如，要使用admin数据库和挑战与响应 ( SCRAM-SHA-1 ) 身份验证机制以用户grace身份进行身份验证，请按以下格式写入用户名： grace?source=admin 例如，要使用LDAP ( PLAIN ) 身份验证机制以用户grace的身份进行身份验证，请按以下格式写入用户名： grace?mechanism=PLAIN&source=$external 例如，要在grace EXAMPLE.COMKerberos Realm 上以用户 的身份进行身份验证 使用 Kerberos 身份验证机制时，请按以下格式写入用户名： grace@EXAMPLE.COM?mechanism=GSSAPI&source=$external 有关 Kerberos 配置的更多信息，请参阅为 BI Connector 配置 Kerberos。
   Password	经过身份验证的用户的密码。 不能在数据库密码中使用大括号 ( { } )，因为这些是ODBC驱动程序中的特殊字符。
   Authentication	默认身份验证方法。使用 MongoDB BI Connector ODBC 驱动程序 时 ，此字段不是必填字段。 要将身份验证插件与其他 ODBC 驱动程序结合使用，请在此字段中填写字符串 mongosql_auth。

7. 单击 Test 按钮，测试 ODBC 连接。

   如果连接成功，请单击 OK 以添加 DSN。如果连接失败，请检查，确保 MongoDB 用户对连接指定的数据库进行了正确的身份验证。

启动 Tableau。

启动 Tableau Desktop 应用程序，如果它已在运行，请重新启动它。

使用 Tableau 进行连接。

1. 在左侧导航栏中的To a server下，单击More... ，然后单击Other Databases (ODBC) 。

2. 在 Other Databases (ODBC) 对话框中，从下拉列表中选择您的 DSN，然后单击 Connect。

3. 连接测试完成后，点击 Sign In。

下载并安装 MongoDB BI Connector ODBC 驱动程序 。

下载 MongoDB BI Connector ODBC 驱动程序 并运行 macOS 安装程序 (.dmg )。

创建系统 DSN。

要将 Tableau 安全地连接到 BI Connector，系统 DSN 配置为使用 MongoDB BI Connector ODBC 驱动程序 为必填项。要创建系统 DSN，请按照以下步骤操作：

1. 启动 ODBC 经理。

   注意

   ODBC Manager 包含在 MongoDB BI Connector ODBC 驱动程序中。

   重要

   MongoDB BI Connector ODBC Driver 附带的 ODBC Manager 1.0.16 版本与 macOS Catalina 或更高版本的 macOS 不兼容。如果您使用的是 Catalina 或更高版本的 macOS，请下载并安装最新版本的 ODBC Manager (1.0.19)。

2. 单击 System DSN，然后单击 Add。

   

3. 从可用驱动程序列表选择 MongoDB BI Connector ODBC 驱动程序。

   选择MongoDB ANSI ODBC驱动程序或MongoDB Unicode ODBC驱动程序，然后单击OK 。

   注意

   ANSI ODBC 驱动程序可以提供最高性能，但字符集有限。Unicode ODBC 驱动程序支持更广泛的字符集，但性能可能略有下降。

4. 输入一个 Data Source Name (DSN)。

   （可选）输入Description 。

   注意

   不要关闭设置窗口。继续执行下一步。

5. 添加必要的关键字。

   1. 单击Add按钮添加关键字值对。

   2. 通过双击它，输入所需的关键字，然后按回车键来修改 Keyword。

   3. 通过双击它，输入所需的关键字，然后按回车键来修改 Value。

   使用上述过程，添加以下关键字：

   Keyword	值
   服务器	MongoDB Connector for BI 主机的主机名或 IP 地址。 重要 使用127.0.0.1通过 TCP 连接到本地主机。指定 IP 地址以外的值将尝试通过 Unix 套接字进行连接。
   端口	IANA 端口号 用于 MongoDB Connector for BI。默认值为3307 。
   数据库	连接后使用的数据库。 连接 Microsoft Excel 时必须使用此关键字。

   有关 ODBC 参数的完整列表，请参阅连接器/ODBC 连接参数。

   例如，用户 DSN 配置应如下所示：

   

   注意

   不要关闭设置窗口。继续执行下一步。

6. 添加身份验证关键字。

   1. 单击Add按钮添加关键字值对。

   2. 通过双击它，输入所需的关键字，然后按回车键来修改 Keyword。

   3. 通过双击它，输入所需的关键字，然后按回车键来修改 Value。

   使用上述过程，添加以下关键字：

   Keyword	值
   UID	可以访问活动的 MongoDB Connector for BI 数据库的用户的用户名。 您可以在用户名后指定以下身份验证选项，作为 URI 形式的查询参数： 连接选项 说明 source 指定存储该用户凭证的数据库名称。如果不指定此选项，MongoDB Connector for BI 将默认使用当前与 MySQL 连接关联的数据库。 对于将凭证存储委托给其他服务的身份验证机制，例如 PLAIN (LDAP) 或 GSSAPI (Kerberos)，请将 source 值设置为 $external。 如果在 MongoDB Connector for BI 配置文件中设置了 defaultSource，则无需配置该选项。 mechanism 指定 MongoDB Connector for BI 应使用的机制来验证连接。可被接受的值包括： SCRAM-SHA-1（默认） SCRAM-SHA-256 普通版 (LDAP SASL) GSSAPI (Kerberos) LDAP 和 Kerberos 需要 MongoDB Enterprise 。使用 LDAP 或 Kerberos 时，将源设置为 $external。 如果在 MongoDB Connector for BI 配置文件中设置了 defaultMechanism，则无需配置该选项。 不支持 X.509。 用户名和密码 LDAP Kerberos 例如，要使用admin数据库和挑战与响应 ( SCRAM-SHA-1 ) 身份验证机制以用户grace身份进行身份验证，请按以下格式写入用户名： grace?source=admin 例如，要使用LDAP ( PLAIN ) 身份验证机制以用户grace的身份进行身份验证，请按以下格式写入用户名： grace?mechanism=PLAIN&source=$external 例如，要在grace EXAMPLE.COMKerberos Realm 上以用户 的身份进行身份验证 使用 Kerberos 身份验证机制时，请按以下格式写入用户名： grace@EXAMPLE.COM?mechanism=GSSAPI&source=$external 有关 Kerberos 配置的更多信息，请参阅为 BI Connector 配置 Kerberos。
   PWD	与 UID 关联的密码。 不能在数据库密码中使用大括号 ( { } )，因为这些是ODBC驱动程序中的特殊字符。

   有关 ODBC 参数的完整列表，请参阅连接器/ODBC 连接参数。

   例如，用户 DSN 配置应如下所示：

   

7. 单击 OK 以完成 DSN 创建。

启动 Tableau。

启动 Tableau Desktop 应用程序，如果它已在运行，请重新启动它。

使用 Tableau 进行连接。

1. 在左侧导航栏中的To a server下，单击More... ，然后单击Other Databases (ODBC) 。

2. 在 Other Databases (ODBC) 对话框中，从下拉列表中选择您的 DSN，然后单击 Connect。

3. 连接测试完成后，点击 Sign In。