Ligar uma aplicação MongoDB ao Azure Cosmos DB

APLICA A: Azure Cosmos DB API para MongoDB

Saiba como ligar a aplicação MongoDB a um Azure Cosmos DB com uma cadeia de ligação do MongoDB. Em seguida, pode utilizar uma base de dados Azure Cosmos como arquivo de dados para a aplicação MongoDB.

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

Pré-requisitos

Obtenha a cadeia de ligação MongoDB usando o arranque rápido

  1. Num navegador de Internet, inscreva-se no portal Azure.

  2. Na lâmina DB Azure Cosmos, selecione a API.

  3. No painel esquerdo da lâmina da conta, clique em Arranque Rápido.

  4. Escolha a sua plataforma (.NET, Node.js, MongoDB Shell, Java, Python). Se não vir o seu controlador ou ferramenta listado, não se preocupe- documentamos continuamente mais cortes de código de ligação. Por favor, comente abaixo o que gostaria de ver. Para aprender a criar a sua própria ligação, leia Obtenha a informação do string de ligação da conta.

  5. Copie e cole o código na sua aplicação MongoDB.

    Lâmina de arranque rápido

Obtenha a cadeia de conexão MongoDB para personalizar

  1. Num navegador de Internet, inscreva-se no portal Azure.

  2. Na lâmina DB Azure Cosmos, selecione a API.

  3. No painel esquerdo da lâmina da conta, clique em Connection String.

  4. A lâmina de ligação abre-se. Tem todas as informações necessárias para ligar à conta utilizando um controlador para o MongoDB, incluindo uma cadeia de ligação pré-reconstruída.

    Painel Cadeia de Ligação

Requisitos de cadeia de ligação

Importante

A Azure Cosmos DB tem rigorosos requisitos e padrões de segurança. As contas DB da Azure Cosmos requerem autenticação e comunicação segura via TLS.

A Azure Cosmos DB suporta o formato URI de cadeia de ligação padrão MongoDB, com alguns requisitos específicos: As contas DB do Azure Cosmos requerem autenticação e comunicação segura via TLS. Assim, o formato de cadeia de ligação é:

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

Os valores desta cadeia estão disponíveis na lâmina de corda de ligação mostrada anteriormente:

  • Nome de utilizador (obrigatório): Nome da conta Cosmos.
  • Palavra-passe (requerida): Senha de conta cosmos.
  • Anfitrião (obrigatório): FQDN da conta Cosmos.
  • Porto (obrigatório): 10255.
  • Base de dados (opcional): A base de dados que a ligação utiliza. Se não for fornecida nenhuma base de dados, a base de dados predefinida é "teste".
  • ssl=verdadeiro (obrigatório)

Por exemplo, considere a conta mostrada na lâmina de corda de ligação. Uma cadeia de ligação válida é:

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

Requisitos do condutor

Todos os controladores que suportam a versão 3.4 ou superior do protocolo de fio suportarão a Azure Cosmos DB API para o MongoDB.

Especificamente, os condutores de clientes devem apoiar a extensão de Identificação de Nome de Serviço (SNI) TLS e/ou a opção de cadeia de ligação appName. Se o appName parâmetro for fornecido, deve ser incluído como encontrado no valor da cadeia de ligação no portal Azure.

Passos seguintes