Azure Cosmos DB: usare Studio 3T con un account API di MongoDBAzure Cosmos DB: Use Studio 3T with a MongoDB API account

Per connettersi a un account API di MongoDB in Azure Cosmos DB è necessario:To connect to an Azure Cosmos DB MongoDB API account, you must:

  • Scaricare e installare Studio 3T, precedentemente noto come MongoChefDownload and install Studio 3T (formerly known as MongoChef)
  • Verificare che siano disponibili le informazioni sulla stringa di connessione di Azure Cosmos DB per l'account di MongoDBHave your Azure Cosmos DB connection string information for your MongoDB account

Creare la connessione in Studio 3TCreate the connection in Studio 3T

Per aggiungere l'account di Azure Cosmos DB alla gestione connessione di Studio 3T, seguire questa procedura:To add your Azure Cosmos DB account to the Studio 3T connection manager, perform the following steps:

  1. Recuperare le informazioni di connessione di Azure Cosmos DB per l'account API di MongoDB usando le istruzioni nell'articolo Connettere un'applicazione MongoDB ad Azure Cosmos DB.Retrieve the Azure Cosmos DB connection information for your MongoDB API account using the instructions in the Connect a MongoDB application to Azure Cosmos DB article.

    Screenshot della pagina della stringa di connessione

  2. Fare clic su Connect (Connetti) per aprire la gestione connessioni, quindi fare clic su New Connection (Nuova connessione)Click Connect to open the Connection Manager, then click New Connection

    Screenshot di gestione connessione di Studio 3T

  3. Nella finestra New Connection (Nuova connessione) della scheda Server, specificare l'host, ovvero l'FQDN, dell'account Azure Cosmos DB e la porta.In the New Connection window, on the Server tab, enter the HOST (FQDN) of the Azure Cosmos DB account and the PORT.

    Screenshot della scheda relativa al server della gestione connessione di Studio 3T

  4. Nella finestra New Connection (Nuova connessione) della scheda Authentication (Autenticazione) scegliere la modalità di autenticazione Basic (MONGODB-CR or SCARM-SHA-1) (Base - MONGODB-CR o SCARM-SHA-1) e immettere il nome utente e la password.In the New Connection window, on the Authentication tab, choose Authentication Mode Basic (MONGODB-CR or SCARM-SHA-1) and enter the USERNAME and PASSWORD. Accettare il database di autenticazione predefinito (admin) o specificare un valore personalizzato.Accept the default authentication db (admin) or provide your own value.

    Screenshot della scheda relativa all'autenticazione della gestione connessione di Studio 3T

  5. Nella finestra New Connection (Nuova connessione) nella scheda SSL selezionare la casella di controllo Use SSL protocol to connect (Usa protocollo SSL per la connessione) e quindi selezionare il pulsante di opzione Accept server self-signed SSL certificates (Accetta certificati SSL autofirmati server).In the New Connection window, on the SSL tab, check the Use SSL protocol to connect check box and the Accept server self-signed SSL certificates radio button.

    Screenshot della scheda relativa all'SSL della gestione connessione di Studio 3T

  6. Fare clic sul pulsante Test Connection (Test connessione) per convalidare le informazioni di connessione, quindi fare clic su OK per tornare alla finestra New Connection (Nuova connessione) e infine su Save (Salva).Click the Test Connection button to validate the connection information, click OK to return to the New Connection window, and then click Save.

    Screenshot della finestra di test della connessione di Studio 3T

Usare Studio 3T per creare un database, una raccolta e documentiUse Studio 3T to create a database, collection, and documents

Per creare un database, una raccolta e documenti usando Studio 3T, seguire la procedura seguente:To create a database, collection, and documents using Studio 3T, perform the following steps:

  1. In Connection Manager (Gestione connessioni) evidenziare la connessione e fare clic su Connect (Connetti).In Connection Manager, highlight the connection and click Connect.

    Screenshot di gestione connessione di Studio 3T

  2. Fare clic con il pulsante destro del mouse sull'host, quindi scegliere Add Database (Aggiungi database).Right-click the host and choose Add Database. Specificare un nome per il database e fare clic su OK.Provide a database name and click OK.

    Screenshot dell'opzione Add Database (Aggiungi database) di Studio 3T

  3. Fare clic con il pulsante destro del mouse sul database, quindi scegliere Add Collection (Aggiungi raccolta).Right-click the database and choose Add Collection. Specificare un nome per la raccolta, quindi fare clic su Create(Crea).Provide a collection name and click Create.

    Screenshot dell'opzione Add Collection (Aggiungi raccolta) di Studio 3T

  4. Selezionare la voce di menu Collection (Raccolta), quindi fare clic su Add Document (Aggiungi documento).Click the Collection menu item, then click Add Document.

    Screenshot della voce di menu Add Document (Aggiungi documento) di Studio 3T

  5. Nella finestra di dialogo Add Document (Aggiungi documento) incollare quanto segue, quindi fare clic su Add Document(Aggiungi documento).In the Add Document dialog, paste the following and then click Add Document.

     {
     "_id": "AndersenFamily",
     "lastName": "Andersen",
     "parents": [
            { "firstName": "Thomas" },
            { "firstName": "Mary Kay"}
     ],
     "children": [
        {
            "firstName": "Henriette Thaulow", "gender": "female", "grade": 5,
            "pets": [{ "givenName": "Fluffy" }]
        }
     ],
     "address": { "state": "WA", "county": "King", "city": "seattle" },
     "isRegistered": true
     }
    
  6. Aggiungere un altro documento, questa volta con il contenuto seguente:Add another document, this time with the following content:

     {
     "_id": "WakefieldFamily",
     "parents": [
         { "familyName": "Wakefield", "givenName": "Robin" },
         { "familyName": "Miller", "givenName": "Ben" }
     ],
     "children": [
         {
             "familyName": "Merriam",
              "givenName": "Jesse",
             "gender": "female", "grade": 1,
             "pets": [
                 { "givenName": "Goofy" },
                 { "givenName": "Shadow" }
             ]
         },
         {
             "familyName": "Miller",
              "givenName": "Lisa",
              "gender": "female",
              "grade": 8 }
     ],
     "address": { "state": "NY", "county": "Manhattan", "city": "NY" },
     "isRegistered": false
     }
    
  7. Eseguire una query di esempio.Execute a sample query. Cercare ad esempio famiglie con cognome 'Andersen' e restituire i campi relativi a genitori e stato.For example, search for families with the last name 'Andersen' and return the parents and state fields.

    Screenshot dei risultati della query di MongoChef

Passaggi successiviNext steps

  • Esaminare gli esempi di API di MongoDB in Azure Cosmos DB.Explore Azure Cosmos DB MongoDB API samples.