Esta página mostra como salvar uma nova conexão MongoDB na guia Connections. Você pode usar uma conexão salva para qualquer tarefa que exija conexão com um banco de dados.
Observação
O Relational Migrator não suporta migrações de MongoDB para MongoDB . Para obter informações sobre bancos de dados compatíveis, consulte Bancos de dados e versões compatíveis.
Para obter informações sobre a migração entre clusters MongoDB, consulte Cluster-to-Cluster Sync do MongoDB.
Sobre esta tarefa
Para salvar uma conexão MongoDB no Relational Migrator, você deve:
Identifique a string de conexão do banco de dados ou as informações do banco de dados .
Conecte-se ao MongoDB.
Importante
Para planejar sua migração e mapear seu esquema relacional para um esquema MongoDB , você deve se conectar usando uma conta com as permissões read corretas.
Para migrar dados, você deve conectar ao MongoDB utilizando uma conta de serviço com o readWrite papel. Para obter informações sobre como criar um usuário do MongoDB com as permissões necessárias, consulte Criar um usuário do Relational Migrator no MongoDB.
Antes de começar
Para salvar uma conexão com um cluster do MongoDB Atlas, você deve estar conectado com o MongoDB Atlas.
Passos
Connection string do banco de dados
O Relational Migrator é compatível com todas as opções de string de conexão do MongoDB, exceto appName. Ele substitui appName ao se conectar à sua implantação do MongoDB .
URI de conexão do Atlas
mongodb+srv://username:password@clusterurl.mongodb.net/database
Por exemplo, para usar uma conta denominada migrator-service com senha hunter2 para se conectar ao banco de dados MongoEnterprises:
mongodb+srv://migrator-service:hunter2@cluster1.abc123.mongodb.net/MongoEnterprises
URI de conexão local
mongodb://username:password@host:port/database
Por exemplo, para usar uma conta denominada migrator-service com senha hunter2 para se conectar ao banco de dados MongoEnterprises:
mongodb://migrator-service:hunter2@localhost:27017/MongoEnterprises
Usando X.509 Authentication
Para se conectar ao MongoDB usando a autenticação X.509, omita um nome de usuário e uma senha. Em vez disso, especifique o host on-premises e a porta ou a URL do Atlas cluster, o nome do banco de dados e as seguintes opções:
<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>
Opção | Valor | ||
|---|---|---|---|
| |||
| |||
| |||
Caminho para o arquivo IMPORTANTE: ao contrário de outros produtos MongoDB , o Relational Migrator exige um caminho para um | |||
Senha para descriptografar o arquivo |
Por exemplo, para se conectar ao banco de dados MongoEnterprises no cluster1.abc123.mongodb.net, usando o arquivo de certificado /etc/ssl/caToValidateServerCertificates.p12 com a senha verysecure:
mongodb+srv://cluster1.abc123.mongodb.net/MongoEnterprises?authSource=$external&authMechanism=MONGODB-X509&tlsCertificateKeyFile=/etc/ssl/caToValidateServerCertificates.p12&tlsCertificateKeyFilePassword=verysecure
Para obter mais informações sobre os componentes de string de conexão , consulte o Manual do banco de dados MongoDB .
Conecte-se ao MongoDB
Para salvar uma nova conexão da página Connections:
Insira a string de conexão do MongoDB
MongoDB connection string (URI)No,insira seu URI MongoDB .
Se você estiver usando a autenticação X.509 , o Relational Migrator verificará a sintaxe da string de conexão e o formato do arquivo do certificado.
Se não estiver incluído na string de conexão, insira o Database para se conectar.
Se eles não estiverem incluídos na string de conexão e você não estiver usando a509 autenticação X., insira o Username e o Password do seu usuário Relational Migrator MongoDB .
Marcar Save password salva a senha com segurança em sua máquina, para que você não precise inserir Username e Password novamente ao usar a conexão salva.
Se você deixar o Database, Username ou Password em branco, o Relational Migrator utilizará os valores do URI.