Editar

Compartilhar via


Conectar um aplicativo do MongoDB ao Azure Cosmos DB

APLICA-SE AO: MongoDB

Saiba como conectar seu aplicativo do MongoDB a um Azure Cosmos DB usando uma cadeia de conexão do MongoDB. Você pode usar um banco de dados do Azure Cosmos DB como o armazenamento de dados para seu aplicativo MongoDB.

Este tutorial fornece duas maneiras de recuperar informações da cadeia de conexão:

Pré-requisitos

Há dois itens necessários

Obter a cadeia de conexão do MongoDB usando o início rápido

Siga as etapas abaixo:

  1. Em um navegador da Internet, entre no Portal do Azure.

  2. No painel Azure Cosmos DB, selecione a API.

  3. No painel esquerdo do painel da conta, selecione Início rápido.

  4. Escolha sua plataforma (.NET, Node.js, MongoDB Shell, Java, Python). Caso não veja seu driver ou ferramenta na lista, não se preocupe, pois documentamos continuamente mais snippets de código de conexão. Envie um comentário sobre o que você gostaria de ver. Para saber como gostaria de ver sua conexão e leia Obter informações da cadeia de conexão da conta.

  5. Copie e cole o snippet de código no seu aplicativo MongoDB.

Obter a cadeia de conexão do MongoDB para personalização

Siga as etapas abaixo:

  1. Em um navegador da Internet, entre no Portal do Azure.

  2. No painel Azure Cosmos DB, selecione a API.

  3. No painel esquerdo do painel de conta, selecione Cadeias de conexão.

  4. O painel Cadeias de conexão se abre. Ela tem todas as informações necessárias para se conectar à conta usando um driver para MongoDB, incluindo uma cadeia de conexão pré-construída.

    Requisitos da cadeia de conexão

    Importante

    O Azure Cosmos DB tem padrões e requisitos de segurança rígidos. As contas do Azure Cosmos DB exigem autenticação e comunicação segura por TLS.

    O Azure Cosmos DB dá suporte ao formato de URI da cadeia de conexão padrão do MongoDB padrão, com alguns requisitos específicos: as contas do Azure Cosmos DB exigem autenticação e comunicação segura por TLS. O formato da cadeia de conexão é:

    mongodb://username:password@host:port/[database]?ssl=true

    Os valores dessa cadeia de caracteres são:

    • Nome de usuário (obrigatória): nome da conta do Azure Cosmos DB.
    • Senha (obrigatória): senha da conta do Azure Cosmos DB.
    • Host (obrigatório): o FQDN da conta do Azure Cosmos DB.
    • Porta (obrigatória): 10255.
    • Banco de dados (opcional): o banco de dados que a conexão usa. Se nenhum banco de dados for fornecido, o banco de dados padrão é "teste".
    • ssl=true (obrigatório).

    Por exemplo, considere a conta mostrada no painel Cadeias de conexão. Uma cadeia de conexão válida é:

    mongodb://contoso123:0Fc3IolnL12312asdfawejunASDF@asdfYXX2t8a97kghVcUzcDv98hawelufhawefafnoQRGwNj2nMPL1Y9qsIr9Srdw==@contoso123.documents.azure.com:10255/mydatabase?ssl=true

    Requisitos de driver

    Todos os drivers compatíveis com o protocolo de comunicação versão 3.4 ou posterior são compatíveis com o Azure Cosmos DB for MongoDB.

    • Os drivers cliente devem dar suporte à extensão do TLS de Indicação de Nome de Servidor (SNI) e/ou à opção de cadeia de conexão appName.
    • Se o parâmetro appName for fornecido, ele deverá ser incluído conforme está no valor da cadeia de conexão no portal do Azure.