Connettersi a un account Azure Cosmos usando Studio 3TConnect to an Azure Cosmos account using Studio 3T

SI APPLICA A: API di Azure Cosmos DB per MongoDB

Per connettersi all'API di un Azure Cosmos DB per MongoDB usando Studio 3T, è necessario:To connect to an Azure Cosmos DB's API for MongoDB using Studio 3T, you must:

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

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

  1. Recuperare le informazioni di connessione per l'account dell'API Azure Cosmos DB per MongoDB usando le istruzioni nell'articolo connettere un'applicazione MongoDB a Azure Cosmos DB .Retrieve the connection information for your Azure Cosmos DB's API for MongoDB 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 della gestione connessione di studio 3T che evidenzia il pulsante nuova connessione.

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

    Screenshot della scheda server di 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 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 SSL di 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 connessione di test 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 della 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 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 di aggiunta della 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 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 delle query di Mongo chef

Passaggi successiviNext steps

  • Informazioni su come usare Robo 3T con l'API di Azure Cosmos DB per MongoDB.Learn how to use Robo 3T with Azure Cosmos DB's API for MongoDB.
  • Esplorare gli esempi di MongoDB con l'API di Azure Cosmos DB per MongoDB.Explore MongoDB samples with Azure Cosmos DB's API for MongoDB.