Connettere un'applicazione MongoDB ad Azure Cosmos DBConnect a MongoDB application to Azure Cosmos DB

Informazioni su come connettere l'app MongoDB a un account Azure Cosmos DB usando una stringa di connessione MongoDB.Learn how to connect your MongoDB app to an Azure Cosmos DB account by using a MongoDB connection string. È quindi possibile usare un database di Azure Cosmos DB come archivio dati per l'app MongoDB.You can then use an Azure Cosmos DB database as the data store for your MongoDB app.

Questa esercitazione illustra due modi per recuperare le informazioni della stringa di connessione:This tutorial provides two ways to retrieve connection string information:

PrerequisitiPrerequisites

Ottenere la stringa di connessione MongoDB usando il metodo di avvio rapidoGet the MongoDB connection string by using the quick start

  1. In un browser Internet accedere al portale di Azure.In an Internet browser, sign in to the Azure portal.
  2. Nel pannello Azure Cosmos DB selezionare l'API per l'account MongoDB.In the Azure Cosmos DB blade, select the API for MongoDB account.
  3. Nel riquadro sinistro del pannello dell'account fare clic su Avvio rapido.In the left pane of the account blade, click Quick start.
  4. Scegliere la piattaforma (.NET, Node.js, MongoDB Shell, Java, Python).Choose your platform (.NET, Node.js, MongoDB Shell, Java, Python). Se il driver o lo strumento non compare nell'elenco, ricordare che altri frammenti di codice di connessione vengono continuamente documentati.If you don't see your driver or tool listed, don't worry--we continuously document more connection code snippets. Commentare di seguito ciò che si vorrebbe vedere.Please comment below on what you'd like to see. Per informazioni su come realizzare la propria connessione, leggere Ottenere informazioni sulla stringa di connessione dell'account.To learn how to craft your own connection, read Get the account's connection string information.
  5. Copiare e incollare il frammento di codice nell'app MongoDB.Copy and paste the code snippet into your MongoDB app.

    Pannello di avvio rapido

Ottenere la stringa di connessione MongoDB da personalizzareGet the MongoDB connection string to customize

  1. In un browser Internet accedere al portale di Azure.In an Internet browser, sign in to the Azure portal.
  2. Nel pannello Azure Cosmos DB selezionare l'API per l'account MongoDB.In the Azure Cosmos DB blade, select the API for MongoDB account.
  3. Nel riquadro sinistro del pannello dell'account, fare clic su Stringa di connessione.In the left pane of the account blade, click Connection String.
  4. Viene aperto il pannello Stringa di connessione.The Connection String blade opens. Contiene tutte le informazioni necessarie per connettersi all'account usando un driver per MongoDB, inclusa una stringa di connessione precostruita.It has all the information necessary to connect to the account by using a driver for MongoDB, including a preconstructed connection string.

    Pannello Stringa di connessione

Requisiti della stringa di connessioneConnection string requirements

Importante

Azure Cosmos DB presenta standard e requisiti di sicurezza restrittivi.Azure Cosmos DB has strict security requirements and standards. Gli account Azure Cosmos DB richiedono l'autenticazione e la comunicazione sicura tramite SSL.Azure Cosmos DB accounts require authentication and secure communication via SSL.

Azure Cosmos DB supporta il formato URI della stringa di connessione di MongoDB standard, con un paio di requisiti specifici: gli account Azure Cosmos DB richiedono l'autenticazione e la comunicazione sicura tramite SSL.Azure Cosmos DB supports the standard MongoDB connection string URI format, with a couple of specific requirements: Azure Cosmos DB accounts require authentication and secure communication via SSL. Il formato della stringa di connessione sarà quindi:So, the connection string format is:

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

I valori di questa stringa sono disponibili nel pannello Stringa di connessione mostrato in precedenza:The values of this string are available in the Connection String blade shown earlier:

  • Nome utente (obbligatorio): nome dell'account Azure Cosmos DB.Username (required): Azure Cosmos DB account name.
  • Password (obbligatorio): password dell'account Azure Cosmos DB.Password (required): Azure Cosmos DB account password.
  • Host (obbligatorio): nome di dominio completo dell'account Azure Cosmos DB.Host (required): FQDN of the Azure Cosmos DB account.
  • Porta (obbligatorio): 10255.Port (required): 10255.
  • Database (facoltativo): il database utilizzato dalla connessione.Database (optional): The database that the connection uses. Se viene specificato alcun database, il database predefinito è "test".If no database is provided, the default database is "test."
  • ssl=true (obbligatorio)ssl=true (required)

Si consideri l'account mostrato nel pannello Stringa di connessione.For example, consider the account shown in the Connection String blade. Una stringa di connessione valida è la seguente:A valid connection string is:

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

Passaggi successiviNext steps

  • Informazioni su come utilizzare MongoChef con un'API di Azure Cosmos DB per l'account MongoDB.Learn how to use MongoChef with an Azure Cosmos DB API for MongoDB account.
  • Esaminare l'API di Azure Cosmos DB per MongoDB visualizzando gli esempi.Explore the Azure Cosmos DB API for MongoDB by viewing samples.