Connettere un'applicazione MongoDB ad Azure Cosmos DB

SI APPLICA A: MongoDB

Informazioni su come connettere un'app MongoDB ad Azure Cosmos DB usando una stringa di connessione MongoDB. È quindi possibile usare un database di Azure Cosmos DB come archivio dati per l'app MongoDB.

Questa esercitazione illustra due modi per recuperare le informazioni della stringa di connessione:

Prerequisiti

Sono necessari due elementi

Ottenere il stringa di connessione MongoDB usando la guida introduttiva

Segui i passaggi riportati di seguito:

  1. In un browser Internet accedere al portale di Azure.

  2. Nel riquadro Azure Cosmos DB selezionare l'API.

  3. Nel riquadro sinistro del riquadro dell'account selezionare Avvio rapido.

  4. Scegliere la piattaforma (.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. Commentare ciò che si vorrebbe vedere. Per informazioni su come realizzare la propria connessione, leggere Ottenere informazioni sulla stringa di connessione dell'account.

  5. Copiare e incollare il frammento di codice nell'app MongoDB.

Ottenere il stringa di connessione MongoDB da personalizzare

Segui i passaggi riportati di seguito:

  1. In un browser Internet accedere al portale di Azure.

  2. Nel riquadro Azure Cosmos DB selezionare l'API.

  3. Nel riquadro sinistro del riquadro dell'account selezionare Stringhe di connessione.

  4. Verrà visualizzato il riquadro Stringhe di connessione. Contiene tutte le informazioni necessarie per connettersi all'account usando un driver per MongoDB, inclusa una stringa di connessione precostruita.

    Requisiti della stringa di connessione

    Importante

    Azure Cosmos DB presenta standard e requisiti di sicurezza restrittivi. gli account Azure Cosmos DB richiedono l'autenticazione e la comunicazione sicura tramite TLS.

    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 TLS. Il formato della stringa di connessione è:

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

    I valori di questa stringa sono:

    • Nome utente (obbligatorio): nome dell'account Azure Cosmos DB.
    • Password (obbligatorio): password dell'account Azure Cosmos DB.
    • Host (obbligatorio): nome di dominio completo dell'account Azure Cosmos DB.
    • Porta (obbligatorio): 10255.
    • Database (facoltativo): il database utilizzato dalla connessione. Se viene specificato alcun database, il database predefinito è "test".
    • ssl=true (obbligatorio).

    Si consideri l'account mostrato nel riquadro Stringhe di connessione. Una stringa di connessione valida è la seguente:

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

    Requisiti del driver

    Tutti i driver che supportano il protocollo Wire versione 3.4 o successiva supportano Azure Cosmos DB for MongoDB.

    • I driver client devono supportare l'estensione TLS Service Name Identification (SNI) e/o l'opzione appName stringa di connessione.
    • Se viene specificato il parametro appName, deve essere incluso come indicato nel valore della stringa di connessione nel portale di Azure.