创建系统 DSN

• 安装 BI Connector 并进行配置以连接到副本集。

  注意

  如果您使用 BI Connector for Atlas，则此先决条件不适用。

• 下载并安装 Visual C++ Redistributable for Visual Studio 2015

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

• 安装 BI Connector 并进行配置以连接到副本集。

  注意

  如果您使用 BI Connector for Atlas，则此先决条件不适用。

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

• 在基于 Red Hat Enterprise 的 Linux 或 基于 Debian 的 Linux 上安装 BI Connector，并进行配置以连接到副本集。

  注意

  如果您使用 BI Connector for Atlas，则此先决条件不适用。

• 下载并解压适用于您平台的 MongoDB BI Connector ODBC 驱动程序。

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 示例，要在 Kerberos 域 上以用户 的身份进行身份验证grace EXAMPLE.COM使用Kerberos身份验证机制时，请按以下格式写入用户名： grace@EXAMPLE.COM?mechanism=GSSAPI&source=$external 有关 Kerberos 配置的更多信息，请参阅为 BI Connector 配置 Kerberos。
   Password	经过身份验证的用户的密码。 您不能在数据库密码中使用花括号（{ }），因为这些是 ODBC 驱动程序中的特殊字符。
   Authentication	默认身份验证方法。使用 MongoDB BI Connector ODBC 驱动程序时，不需要此字段。 要将身份验证插件与其他 ODBC 驱动程序结合使用，请在此字段中填写字符串 mongosql_auth。

7. （可选）如果已启用 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 设置。

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

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

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解决以外的值， BI Connector将尝试使用 Unix 套接字进行连接。
   端口	用于 MongoDB Connector for BI 的 IANA 端口号。默认为 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 示例，要在 Kerberos 域 上以用户 的身份进行身份验证grace EXAMPLE.COM使用Kerberos身份验证机制时，请按以下格式写入用户名： grace@EXAMPLE.COM?mechanism=GSSAPI&source=$external 有关 Kerberos 配置的更多信息，请参阅为 BI Connector 配置 Kerberos。
   PWD	与 UID 关联的密码。 您不能在数据库密码中使用花括号（{ }），因为这些是 ODBC 驱动程序中的特殊字符。

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

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

   

7. （可选）如果已启用 TLS/SSL，请添加 TLS/SSL 关键字。

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

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

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

   注意

   BI Connector for Atlas 使用 TLS/SSL，但不需要在系统 DSN 中 配置任何 TLS/SSL 设置。

   按照上述步骤，根据您的 TLS/SSL 配置添加以下关键字：

   Keyword	值
   SSLKEY	.pem 文件的路径密钥文件。
   SSLCERT	SSL 证书的路径。
   SSLMODE	设置为 REQUIRED。
   SSLCA	SSL 证书颁发机构文件的路径。
   SSLCIPHER	包含允许的密码列表的文件的路径。
   RSAKEY	包含 RSA 公钥的 PEM 文件的路径。
   ENABLE_CLEARTEXT_PLUGIN	设置为 1 以启用明文身份验证。

   注意

   如果您正在连接 Microsoft Excel，则证书必须位于 /Library/ODBC/ 目录中。

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

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

   

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

以下过程已在 Ubuntu 和 RHEL 上进行了测试，并且应该以类似的方式与其他 Linux 发行版一起工作。

[MongoDBODBC]
DESCRIPTION = ODBC for MongoDB BI Connector
DRIVER      = /usr/local/lib/libmdbodbcw.so
TRACE       = Off
TRACEFILE   = stderr
READONLY    = yes
SERVER      = <server address>
PORT        = <port number>
USER        = <username>
PASSWORD    = <password>
DATABASE    = <dbname>
; optional SSL configuration
SSLKEY      = </path/to/.pem-key-file>
SSLCERT     = </path/to/ssl-certificate>
SSLMODE     = DISABLED|PREFERRED|REQUIRED
SSLCA       = </path/to/ssl-ca-list-file>
SSLCAPATH   = </path/to/ssl-ca-file-directory>
SSLCIPHER   = </path/to/ssl-cipher-file>
RSAKEY      = </path/to/rsa-public-key-file>

sudo apt-get install unixodbc

sudo yum install unixODBC

iusql -v MongoDBODBC

SQL> use test;
SQL> show tables;