Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

Conecte-se ao MongoDB

Esta página mostra como salvar uma nova conexão MongoDB da 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 suportados, consulte Bancos de dados e versões compatíveis.

Para obter informações sobre a migração entre clusters do MongoDB, consulte Cluster-to-Cluster Sync do MongoDB.

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 papel readWrite. 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.

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

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
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

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

$external

MONGODB-X509

Caminho para o arquivo .p12 que contém o certificado e a chave para apresentar à instância mongod ou mongos.

IMPORTANTE: ao contrário de outros produtos MongoDB , o Relational Migrator exige um caminho para um .p12 arquivo, não um .pem arquivo. Se seu certificado for salvo como um .pem arquivo, você poderá convertê-lo usando uma ferramenta como o comando PKCS do OpenSSL:12

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

Senha para descriptografar o arquivo .p12.

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.

Para salvar uma nova conexão da página Connections:

1

Na lista de conexões do MongoDB, clique em + Add connection.

2
  1. MongoDB connection string (URI)No,insira seu URI MongoDB .

    Se você estiver usando a 509 autenticação X., o Relational Migrator verificará a sintaxe da string de conexão e o formato do arquivo do certificado.

  2. Se não estiver incluído na string de conexão, insira o Database para se conectar.

  3. 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.

3

O Relational Migrator tenta autenticar e se conectar ao banco de dados.

4

A conexão salva está disponível para uso em todas as tarefas e projetos.