Editar

Conectar um aplicativo MongoDB ao Azure Cosmos DB

  • Procedimentos

APLICA-SE A: MongoDB

Saiba como ligar a aplicação MongoDB a um Azure Cosmos DB com uma cadeia de ligação do MongoDB. Em seguida, você pode usar um banco de dados do Azure Cosmos DB como o armazenamento de dados para seu aplicativo MongoDB.

Este tutorial fornece duas formas de recuperar informações da cadeia de ligação:

  • O método de início rápido, para uso com drivers .NET, Node.js, MongoDB Shell, Java e Python.
  • O método de cadeia de conexão personalizado, para uso com outros drivers.

Pré-requisitos

Há dois itens obrigatórios:

  • Uma conta do Azure. Se você não tiver uma conta do Azure, crie uma conta gratuita do Azure agora.

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

Siga os passos abaixo:

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

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

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

  4. Escolha sua plataforma (.NET, Node.js, MongoDB Shell, Java, Python). Se você não vir seu driver ou ferramenta listados, não se preocupe - nós documentamos continuamente mais trechos de código de conexão. Comente o que você gostaria de ver. Para saber como criar sua própria conexão, leia Obter as informações da cadeia de conexão da conta.

  5. Copie e cole o trecho de código em seu aplicativo MongoDB.

Obtenha a cadeia de conexão do MongoDB para personalizar

Siga os passos abaixo:

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

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

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

  4. O painel Cadeias de conexão é aberto. Ele 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 requisitos e padrões de segurança rigorosos. As contas do Azure Cosmos DB exigem autenticação e comunicação segura via TLS.

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

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

    Os valores desta cadeia de caracteres são:

    • Nome de usuário (obrigatório): nome da conta do Azure Cosmos DB.
    • Senha (obrigatório): senha da conta do Azure Cosmos DB.
    • Host (obrigatório): FQDN da conta do Azure Cosmos DB.
    • Porta (obrigatório): 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 será "test".
    • 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 do condutor

    Todos os drivers que oferecem suporte ao protocolo wire versão 3.4 ou superior oferecem suporte ao Azure Cosmos DB para MongoDB.

    • Os drivers de cliente devem suportar a extensão TLS de identificação de nome de serviço (SNI) e/ou a opção de cadeia de conexão appName.
    • Se o appName parâmetro for fornecido, ele deverá ser incluído conforme encontrado no valor da cadeia de conexão no portal do Azure.

Conteúdos relacionados