mongotranslate
MongoDB工具 >MongoDB BI连接器 > 创建系统DSN
以下步骤描述了如何为BI连接器的mongosqld
流程创建系统数据源名称(DSN)。DSN是保存的配置,描述了ODBC驱动程序要使用的数据库连接。为BI连接器创建DSN后,您可以配置各种SQL客户端和BI工具以使用DSN并从MongoDB导入数据。
在创建DSN之前,您应该:
选择适合您的系统和ODBC驱动程序版本的程序版本(64位或32位)。
System DSN
Add
按钮。¶选择MongoDB ODBC 1.1.0 ANSI驱动程序或 MongoDB ODBC 1.1.0 Unicode驱动程序,然后单击“ 确定”。
注意
ANSI ODBC驱动程序可提供最佳性能,但字符集有限。Unicode ODBC驱动程序支持较宽的字符集,但结果可能会稍微降低性能。
在--auth
启用时运行或连接到Atlas实例的BI Connector 时,以下字段必填
。
栏位名称 | 描述 | ||||||
---|---|---|---|---|---|---|---|
用户 | 经过验证可以使用您的目标数据库的MongoDB用户的用户名。 您可以在用户名后指定以下身份验证选项作为URI样式的查询参数:
例 要 例 要 例 要
使用Kerberos身份验证机制 有关Kerberos配置的更多信息,请参见 为BI Connector配置Kerberos。 |
||||||
密码 | 经过身份验证的用户密码。 | ||||||
认证方式 | 默认身份验证方法。当将 MongoDB ODBC驱动程序用于BI Connector时,此字段不是必需的。 要将身份验证插件与另一个ODBC驱动程序一起使用,请在此字段中输入字符串 |
通过单击详细信息>>,然后单击SSL选项卡来访问TLS / SSL表单字段。以下参数可用,并且可能是必需的,具体取决于您的 TLS / SSL配置:
栏位名称 | 描述 |
---|---|
SSL密钥 | 客户端/服务器密钥文件的位置。 |
SSL证书 | 客户端/服务器证书文件的位置。 |
SSL CA文件 | 包含受信任证书颁发机构列表的文件位置。 |
SSL密码 | 包含允许密码列表的文件位置。 |
SSL模式 | 设置为REQUIRED 需要加密通道。如果未提供加密通道,则连接失败。 |
RSA公钥 | 包含RSA公钥的PEM文件的位置。 |
注意
用于Atlas的BI连接器使用TLS / SSL,但不需要在系统DSN中配置任何TLS / SSL设置。
Test
按钮以测试ODBC连接。¶如果连接成功,请单击“ 确定”以添加 DSN。如果连接失败,请检查以确保对连接中命名的数据库的MongoDB用户进行了正确的身份验证。
以下示例配置假定以下内容:
mongosqld
在启用身份验证的localhost
端口
3307
上运行的实例。dbUser
,该用户针对admin
数据库进行身份验证并被授权使用该test
数据库。您输入的值可能不同。
注意
ODBC管理器包含在MongoDB ODBC驱动程序中。
重要
MongoDB ODBC驱动程序附带的ODBC管理器1.0.16版本与macOS Catalina不兼容。如果您在Catalina上,请下载并安装 最新版本(1.0.19)的ODBC管理器。
选择MongoDB ANSI ODBC驱动程序或 MongoDB Unicode ODBC驱动程序,然后单击OK。
注意
ANSI ODBC驱动程序可提供最佳性能,但字符集有限。Unicode ODBC驱动程序支持较宽的字符集,但结果可能会稍微降低性能。
使用上述过程,添加以下关键字:
关键词 | 值 |
---|---|
服务器 | MongoDB Connector for BI主机的主机名或IP地址。 重要 用于 |
港口 |
MongoDB Connector for BI 的IANA
端口号。默认值为3307 。 |
数据库 | 连接后要使用的数据库。 注意 与Microsoft Excel连接时必需。 |
有关ODBC参数的完整列表,请参见 连接器/ ODBC连接参数。
例如,您的用户DSN配置应类似于以下内容:
注意
不要关闭设置窗口。继续进行下一步。
使用上述过程,添加以下关键字:
关键词 | 值 | ||||||
---|---|---|---|---|---|---|---|
UID | 可以访问活动的MongoDB Connector for BI数据库的用户的用户名。 您可以在用户名后指定以下身份验证选项作为URI样式的查询参数:
例 要 例 要 例 要
使用Kerberos身份验证机制 有关Kerberos配置的更多信息,请参见 为BI Connector配置Kerberos。 |
||||||
残障人士 | 与UID关联的密码。 |
有关ODBC参数的完整列表,请参见 连接器/ ODBC连接参数。
例如,您的用户DSN配置应类似于以下内容:
注意
用于Atlas的BI连接器使用TLS / SSL,但不需要在系统DSN中配置任何TLS / SSL设置。
使用上述步骤,根据您的TLS / SSL配置添加以下关键字:
关键词 | 值 |
---|---|
SSLKEY |
.pem密钥文件的路径。 |
SSLCERT |
SSL证书的路径。 |
SSLMODE |
设为REQUIRED 。 |
SSLCA |
SSL证书颁发机构文件的路径。 |
SSLCIPHER |
包含允许密码列表的文件路径。 |
RSAKEY |
包含RSA公钥的PEM文件的路径。 |
ENABLE_CLEARTEXT_PLUGIN |
设置为1 启用明文身份验证。 |
注意
如果要连接Microsoft Excel,则证书必须位于/Library/ODBC/
目录中。
有关ODBC参数的完整列表,请参见 连接器/ ODBC连接参数。
例如,您的用户DSN配置应类似于以下内容:
以下过程已在Ubuntu和RHEL上进行了测试,并且在其他Linux发行版中应以类似的方式工作。
.so
文件¶MongoDB ODBC驱动程序文件的名称为libmdbodbca.so
和
libmdbodbcw.so
。下载MongoDB ODBC驱动程序后,将它们移动到您的/usr/local/lib
目录中。
odbc.ini
文件¶该文件/etc/odbc.ini
定义您的数据源名称。以下是一个示例odbc.ini
文件,该文件配置为使用带有DSN的MongoDB ODBC驱动程序MongoDBODBC
。将所有必需的占位符值替换为系统值。
命名的文件libmdbodbca.so
是ANSI驱动程序,而命名的文件libmdbodbcw.so
是Unicode驱动程序。通过Driver
在odbc.ini
文件中设置参数来
指定所需的驱动程序。
注意
ANSI ODBC驱动程序可提供最佳性能,但字符集有限。Unicode ODBC驱动程序支持较宽的字符集,但结果可能会稍微降低性能。
注意
所有odbc.ini
参数都不区分大小写。
上一个示例仅包含一个DSN,但是可以在一个odbc.ini
文件中包含多个DSN 。
下表描述了上一个示例中使用的参数。
参数 | 描述 |
---|---|
DESCRIPTION |
可选的。DSN的文字说明。 |
DRIVER |
ODBC驱动程序文件的路径。 |
TRACE |
On 或Off 。启用ODBC跟踪。 |
TRACEFILE |
如果启用了ODBC跟踪,则为存储跟踪输出的文件的路径。 |
READONLY |
yes 或no 。强制执行只读ODBC会话。 |
SERVER |
mongosqld 运行BI Connector 实例的服务器的地址
。 |
PORT |
mongosqld 实例的端口号。 |
USER |
具有连接到mongosqld 实例权限的MongoDB用户的用户名。 |
PASSWORD |
具有连接mongosqld 实例权限的MongoDB用户的密码。 |
DATABASE |
要使用的MongoDB数据库的名称。 |
SSLKEY |
SSL密钥文件的完整路径,用于建立安全连接。 |
SSLCERT |
用于建立安全连接的SSL证书文件的名称。 |
SSLMODE |
可接受的值为:
|
SSLCA |
具有信任SSL证书颁发机构列表的文件的完整路径。 |
SSLCAPATH |
包含PEM格式的受信任SSL CA证书的目录的完整路径。 |
SSLCIPHER |
包含允许密码列表的文件的完整路径。 |
RSAKEY |
包含RSA公钥的PEM文件的完整路径。 |
ENABLE_CLEARTEXT_PLUGIN |
设置为1 启用明文身份验证。 |
有关ODBC参数的完整列表,请参见 连接器/ ODBC连接参数。
注意
用于Atlas的BI连接器使用TLS / SSL,但不需要在系统DSN中配置任何TLS / SSL设置。
DSN现在可以使用了。如果您想测试您的DSN,请继续执行步骤3。
该unixODBC
软件包包括一个名为的SQL客户端iusql
。您可以使用它来测试您的DSN。
以下示例用于iusql
连接到
MongoDBODBC
DSN,然后在名为的数据库中查找表
test
: