/ /

连接至 MongoDB

本页介绍如何从 Connections标签页保存新的MongoDB连接。可以将已保存的连接用于任何需要连接到数据库的任务。

注意

Relational Migrator不支持MongoDB到MongoDB 的迁移。有关支持的数据库的信息，请参阅支持的数据库和版本。

有关在MongoDB集群之间迁移的信息，请参阅MongoDB Cluster-to-Cluster Sync。

关于此任务

要在Relational Migrator中保存MongoDB连接，您必须：

确定数据库连接字符串或数据库信息。
Connect to MongoDB.

重要

要规划迁移并将关系模式映射到MongoDB模式，您必须使用具有正确 read 权限的帐户进行连接。

要迁移数据，必须使用具有 readWrite角色的服务帐户连接到MongoDB 。有关创建具有所需权限的MongoDB用户的信息，请参阅在MongoDB中创建Relational Migrator用户。

步骤

数据库连接字符串

Relational Migrator supports all MongoDB connection string options except appName. It overrides appName when connecting to your MongoDB deployment.

Atlas连接 URI

mongodb+srv://username:password@clusterurl.mongodb.net/database

示例，要使用名为 migrator-service、密码为 hunter2 的帐户连接到 MongoEnterprises数据库：

mongodb+srv://migrator-service:hunter2@cluster1.abc123.mongodb.net/MongoEnterprises

本地连接 URI

mongodb://username:password@host:port/database

示例，要使用名为 migrator-service、密码为 hunter2 的帐户连接到 MongoEnterprises数据库：

mongodb://migrator-service:hunter2@localhost:27017/MongoEnterprises

使用 X.509 身份验证

要使用 X.509身份验证连接到MongoDB ，请省略用户名和密码。相反，请指定本地部署托管和端口或Atlas 集群URL、数据库名称以及以下选项：

<mongodb:// or mongodb+srv://><on-premises host:port or clusterurl.mongodb.net>/<database>?authSource=$external&authMechanism=MONGODB-X509&tls=true&tlsCertificateKeyFile=</path/to/cert/client.p12>&tlsCertificateKeyFilePassword=<certpassword>

选项

值

authSource

$external

authMechanism

MONGODB-X509

tls

true. Required if using a standard connection string that starts with mongodb://. Implicitly true if using an SRV connection string that starts with mongodb+srv://.

tlsCertificateKeyFile

.p12文件的路径，该文件包含要提供给 mongod 或 mongos实例的证书和密钥。

重要提示：与其他MongoDB产品不同， Relational Migrator需要.p12 文件的路径，而不是.pem 文件的路径。如果您的证书另存为.pem 文件，则可以使用 OpenSSL 的 PKCS12 命令等工具将其转换：

openssl pkcs12 -export -inkey cert_key_pem.txt -in cert_key.pem -out
cert_key.p12

tlsCertificateKeyFilePassword

用于解密 .p12文件的密码。

示例，要连接到 cluster1.abc123.mongodb.net 上的 MongoEnterprises数据库，请使用证书文件/etc/ssl/caToValidateServerCertificates.p12 和密码 verysecure：

mongodb+srv://cluster1.abc123.mongodb.net/MongoEnterprises?authSource=$external&authMechanism=MONGODB-X509&tlsCertificateKeyFile=/etc/ssl/caToValidateServerCertificates.p12&tlsCertificateKeyFilePassword=verysecure

有关连接字符串组件的更多信息，请参阅《MongoDB数据库手册》。

连接至 MongoDB

要从 Connections 页面保存新连接，请执行以下操作：

添加新连接

在 MongoDB 连接列表中，单击 + Add connection。

输入MongoDB连接字符串

在MongoDB connection string (URI) 中，输入您的MongoDB URI。
如果您使用的是 X.509 身份验证， Relational Migrator会验证连接字符串语法和证书文件格式。
如果连接字符串中未包含此名称，请输入要连接到的 Database。
如果它们未包含在连接字符串中，并且您未使用 X.509 UsernamePassword身份验证，请输入您的Relational Migrator MongoDB用户的和。
选中 Save password 会将密码安全地保存在计算机上，因此在使用保存的连接时，无需再次输入 Username 和 Password。

如果将 Database、Username 或 Password 留空， Relational Migrator将使用 URI 中的值。

（可选）单击 Test connection

Relational Migrator尝试进行身份验证并连接到数据库。

单击 Save

保存的连接可用于所有作业和项目。