先决条件
将Tableau连接到 MongoDB Connector for BI需要满足以下条件：
将Tableau连接到MongoDB Connector for BI需要满足以下条件：
步骤
使用 TLS / SSL将 Tableau 连接到 MongoDB Connector for BI：
下载并安装MongoDB BI Connector ODBC驱动程序 。
下载 MongoDB BI Connector ODBC 驱动程序并运行 Windows 安装程序 (.msi)。
创建系统 DSN。
要将Tableau安全地连接到BI Connector，需要将系统 DSN配置为使用MongoDB BI Connector ODBC驱动程序。要创建系统 DSN，请按照以下步骤操作：
启动 Microsoft ODBC Data Sources 程序。
选择适合系统和 ODBC 驱动程序版本的 程序版本（64 位或 32 位）。
选择
System DSN标签页。单击
Add按钮。![Windows ODBC 管理器应用程序的屏幕截图]()
点击放大从可用驱动程序列表选择 MongoDB BI Connector ODBC 驱动程序。
选择 MongoDB ODBC ANSI Driver 或 MongoDB ODBC Unicode Driver，然后单击 OK。
注意
ANSI ODBC 驱动程序可以提供最高性能，但字符集有限。Unicode ODBC 驱动程序支持更广泛的字符集，但性能可能略有下降。
填写必需的表单字段。
单击 Details 按钮，显示表单的下半部分。
以下表单字段是必填字段：
字段名称说明Data Source Name
所选择的名称。
TCP/IP Server
运行
mongosqld进程的服务器的地址。如果您已在 MongoDB Atlas 上启用 BI Connector，则可以在集群的连接信息找到运行mongosqld的服务器的主机名。Port
mongosqld进程的端口号。Database
要连接的数据库的名称，例如
test。（可选）如果已启用身份验证，请提供连接信息。
在启用
--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（默认）
普通版 (LDAP SASL)
GSSAPI (Kerberos)
LDAP 和 Kerberos 需要 MongoDB Enterprise 。使用 LDAP 或 Kerberos 时，将源设置为
$external。如果在 MongoDB Connector for BI 配置文件中设置了
defaultMechanism，则无需配置该选项。不支持 X.509。
示例，要使用
admin数据库和挑战与响应 (SCRAM-SHA-1)身份验证机制以用户grace身份进行身份验证，请按以下格式写入用户名：grace?source=admin 示例，要使用LDAP (
PLAIN)身份验证机制以用户grace的身份进行身份验证，请按以下格式写入用户名：grace?mechanism=PLAIN&source=$external 示例，要使用Kerberos身份验证机制在
EXAMPLE.COMKerberos 域上以用户grace的身份进行身份验证，请按以下格式写入用户名：grace@EXAMPLE.COM?mechanism=GSSAPI&source=$external 有关 Kerberos 配置的更多信息，请参阅为 BI Connector 配置 Kerberos。
Password
经过身份验证的用户的密码。
您不能在数据库密码中使用花括号（
{ }），因为这些是 ODBC 驱动程序中的特殊字符。Authentication
默认身份验证方法。使用 MongoDB BI Connector ODBC 驱动程序时，不需要此字段。
要将身份验证插件与其他 ODBC 驱动程序结合使用，请在此字段中填写字符串
mongosql_auth。（可选）如果已启用 TLS/SSL，请填写 TLS/SSL 表单字段。
单击 Details >>，然后单击 SSL 标签页，访问 TLS/SSL 表单字段。根据 TLS/SSL 配置，以下参数可用且可能是必需的：
字段名称说明SSL Key
客户端/服务器密钥文件的位置。
SSL Cert
客户端/服务器证书文件的位置。
SSL CA File
包含受信任证书颁发机构列表的文件的位置。
SSL Cipher
包含允许密码套件列表的文件的位置。
SSL Mode
设置为
REQUIRED，要求加密通道。如果未提供加密通道，则连接失败。RSA Public Key
包含 RSA 公钥的 PEM 文件的位置。
注意
BI Connector for Atlas 使用 TLS/SSL，但不需要在系统 DSN 中 配置任何 TLS/SSL 设置。
单击
Test按钮，测试 ODBC 连接。如果连接成功，请单击 OK 以添加 DSN。如果连接失败，请检查，确保 MongoDB 用户对连接指定的数据库进行了正确的身份验证。
下载并安装MongoDB BI Connector ODBC驱动程序。
下载MongoDB BI Connector ODBC驱动程序并运行macOS 安装程序 (.dmg)。
创建系统 DSN。
要将Tableau安全地连接到BI Connector，需要将系统 DSN配置为使用MongoDB BI Connector ODBC驱动程序。要创建系统 DSN，请按照以下步骤操作：
启动 ODBC经理。
注意
ODBC Manager 包含在 MongoDB BI Connector ODBC 驱动程序中。
重要
1.0.16MongoDB BI Connector ODBC驱动程序附带的ODBC 经理版本与 macOS Catalina 或更高版本的 macOS 不兼容。如果您使用的是 Catalina 或更高版本的 macOS，下载并安装最新版本 (1.0.19) 的 ODBC 管理器。
单击 System DSN，然后单击 Add。
![ODBC Manager DSN 配置]()
从可用驱动程序列表选择 MongoDB BI Connector ODBC 驱动程序。
选择MongoDB ANSI ODBC驾驶员或MongoDB Unicode ODBC驾驶员，然后单击OK 。
注意
ANSI ODBC 驱动程序可以提供最高性能，但字符集有限。Unicode ODBC 驱动程序支持更广泛的字符集，但性能可能略有下降。
输入一个 Data Source Name (DSN)。
（可选）输入 Description。
注意
不要关闭设置窗口。 继续执行下一步。
添加必要的关键字。
单击 Add（添加）按钮添加关键字值对。
通过双击它，输入所需的关键字，然后按回车键来修改 Keyword。
通过双击它，输入所需的关键字，然后按回车键来修改 Value。
使用上述过程，添加以下关键字：
Keyword值服务器
MongoDB Connector for BI托管的主机名或IP解决。
重要提示：使用
127.0.0.1通过 TCP 连接到本地主机。 如果指定IP解决以外的值， BI Connector将尝试使用 Unix 套接字进行连接。端口
用于 MongoDB Connector for BI 的 IANA 端口号。默认为
3307。数据库
连接后使用的数据库。
连接 Microsoft Excel 时必须使用此关键字。
有关 ODBC 参数的完整列表，请参阅连接器/ODBC 连接参数。
示例，用户 DSN 配置应如下所示：
![ODBC Manager DSN 配置]()
注意
不要关闭设置窗口。 继续执行下一步。
添加身份验证关键字。
单击 Add（添加）按钮添加关键字值对。
通过双击它，输入所需的关键字，然后按回车键来修改 Keyword。
通过双击它，输入所需的关键字，然后按回车键来修改 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（默认）
普通版 (LDAP SASL)
GSSAPI (Kerberos)
LDAP 和 Kerberos 需要 MongoDB Enterprise 。使用 LDAP 或 Kerberos 时，将源设置为
$external。如果在 MongoDB Connector for BI 配置文件中设置了
defaultMechanism，则无需配置该选项。不支持 X.509。
示例，要使用
admin数据库和挑战与响应 (SCRAM-SHA-1)身份验证机制以用户grace身份进行身份验证，请按以下格式写入用户名：grace?source=admin 示例，要使用LDAP (
PLAIN)身份验证机制以用户grace的身份进行身份验证，请按以下格式写入用户名：grace?mechanism=PLAIN&source=$external 示例，要使用Kerberos身份验证机制在
EXAMPLE.COMKerberos 域上以用户grace的身份进行身份验证，请按以下格式写入用户名：grace@EXAMPLE.COM?mechanism=GSSAPI&source=$external 有关 Kerberos 配置的更多信息，请参阅为 BI Connector 配置 Kerberos。
PWD
与 UID 关联的密码。
您不能在数据库密码中使用花括号（
{ }），因为这些是 ODBC 驱动程序中的特殊字符。有关 ODBC 参数的完整列表，请参阅连接器/ODBC 连接参数。
示例，用户 DSN 配置应如下所示：
![ODBC Manager DSN 配置]()
添加 SSL 关键字。
单击 Add（添加）按钮添加关键字值对。
通过双击它，输入所需的关键字，然后按回车键来修改 Keyword。
通过双击它，输入所需的关键字，然后按回车键来修改 Value。
注意
BI Connector for Atlas 使用 TLS/SSL，但不需要在系统 DSN 中 配置任何 TLS/SSL 设置。
按照上述步骤，根据您的 TLS/SSL 配置添加以下关键字：
Keyword值SSLKEY.pem 文件的路径密钥文件。
SSLCERTSSL 证书的路径。
SSLMODE设置为
REQUIRED。SSLCASSL 证书颁发机构文件的路径。
SSLCIPHER包含允许的密码列表的文件的路径。
RSAKEY包含 RSA 公钥的 PEM 文件的路径。
ENABLE_CLEARTEXT_PLUGIN设置为
1以启用明文身份验证。注意
如果您正在连接 Microsoft Excel，则证书必须位于
/Library/ODBC/目录中。有关 ODBC 参数的完整列表，请参阅连接器/ODBC 连接参数。
示例，用户 DSN 配置应如下所示：
![ODBC Manager DSN 配置]()
单击 OK 以完成 DSN 创建。
