Guida introduttiva: Creare un account Azure Cosmos DB per NoSQL utilizzando il portale di Azure

In questa introduzione rapida, creerai un nuovo account Azure Cosmos DB per NoSQL nel portale di Azure. Si userà quindi l'esperienza di Esplora dati all'interno del portale di Azure per creare un database e un contenitore che configura tutte le impostazioni necessarie. Infine, si aggiungono dati campione al contenitore e si esegue una query di base.

Prerequisiti

Crea un account

Per iniziare, creare un nuovo Azure Cosmos DB per NoSQL account

  1. Accedere al portale di Azure (https://portal.azure.com).

  2. Immettere Azure Cosmos DB nella barra di ricerca globale.

    Screenshot della barra di ricerca globale nel portale di Azure.

  3. In Servizi selezionare Azure Cosmos DB.

    Screenshot dell'opzione di Azure Cosmos DB selezionata nel menu di ricerca.

  4. Nel riquadro Azure Cosmos DB selezionare Crea e quindi Azure Cosmos DB per NoSQL.

    Screenshot dell'opzione Crea nel riquadro di un servizio Azure.

    Screenshot del riquadro di selezione api di Azure Cosmos DB con l'API per NoSQL evidenziata.

  5. Nel riquadro Dati principali, configurare le opzioni seguenti e quindi selezionare Rivedi e crea:

    Value
    Abbonamento Selezionare la sottoscrizione di Azure
    Gruppo di risorse Creare un nuovo gruppo di risorse o selezionare un gruppo di risorse esistente
    Account Name: Specificare un nome univoco globale
    Zone di disponibilità Disabilitare
    Ubicazione Selezionare un'area di Azure supportata per la sottoscrizione

    Screenshot del pannello 'Base' di Azure Cosmos DB per NoSQL.

    Suggerimento

    È possibile lasciare le opzioni non specificate sui loro valori predefiniti. È anche possibile configurare l'account per limitare la produttività totale dell'account a 1.000 unità richiesta al secondo (UR/sec) e abilitare il livello gratuito per ridurre al minimo i costi.

  6. Nel riquadro Rivedi e crea attendere il completamento della convalida dell'account e quindi selezionare Crea.

    Screenshot del passaggio di convalida delle risorse nell'esperienza di creazione.

  7. Il portale si sposta automaticamente al riquadro Distribuzione. Attendere il completamento della distribuzione.

    Screenshot del riquadro di distribuzione con una distribuzione in attesa.

  8. Al termine della distribuzione, selezionare Go alla risorsa per passare al nuovo Azure Cosmos DB per NoSQL account.

    Screenshot di una risorsa completamente distribuita con l'opzione

Creare un database e un contenitore

Usare quindi il Esplora dati per creare un database e un contenitore nel portale.

  1. Nel riquadro della risorsa dell'account selezionare Esplora dati nel menu del servizio.

    Screenshot dell'opzione Esplora dati nel menu del servizio per l'account.

  2. Nel riquadro Esplora dati selezionare l'opzione Nuovo contenitore.

    Screenshot dell'opzione

  3. Nella finestra di dialogo Nuovo contenitore, configurare i valori seguenti, quindi selezionare OK:

    Value
    Banca dati Crea nuovo elemento
    ID database cosmicworks
    Produttività condivisa tra contenitori Non selezionare
    ID contenitore employees
    Chiave di partizione department/name
    Produttività del contenitore (scalabilità automatica) Autoscale
    Valore massimo di RU/sec del contenitore 1000

    Screenshot della finestra di dialogo per creare un nuovo database e un nuovo contenitore con le opzioni specificate compilate.

  4. Osservare il database e il contenitore appena creati nella gerarchia del Esplora dati.

    Screenshot della gerarchia di Esplora dati con un contenitore di database presente.

    Suggerimento

    Facoltativamente, è possibile espandere il nodo contenitore per osservare proprietà aggiuntive e impostazioni di configurazione.

Aggiungere e interrogare i dati campione

Usare infine il Esplora dati per creare un elemento di esempio e quindi eseguire una query di base per il contenitore.

  1. Espandere il nodo per il contenitore employees nell'albero del Esplora dati. Quindi, selezionare l'opzione Articoli.

    Screenshot dell'opzione 'Elementi' all'interno di un contenitore nella gerarchia di Esplora Dati.

  2. Nel menu del Esplora dati selezionare Nuovo elemento.

    Screenshot dell'opzione 'Nuovo elemento' all'interno del menu Esplora dati.

  3. Ora, inserire il JSON seguente per un nuovo articolo nel contenitore dipendenti e quindi selezionare Salva:

    {
      "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "name": {
        "first": "Kai",
        "last": "Carter"
      },
      "email": "<kai@adventure-works.com>",
      "department": {
        "name": "Logistics"
      }
    }
    

    Screenshot del contenuto JSON per un nuovo elemento all'interno del Esplora dati.

  4. Nel menu del Esplora dati selezionare Nuova query SQL.

    Screenshot dell'opzione

  5. Inserire ora la query di NoSQL seguente per ottenere tutti gli elementi per il reparto logistics usando una ricerca senza distinzione tra maiuscole e minuscole. La query formatta l'output come oggetto JSON strutturato. Eseguire la query selezionando Esegui query:

    SELECT VALUE {
        "name": CONCAT(e.name.last, " ", e.name.first),
        "department": e.department.name,
        "emailAddresses": [
            e.email
        ]
    }
    FROM
        employees e
    WHERE
        STRINGEQUALS(e.department.name, "logistics", true)
    

    Screenshot del testo della query NoSQL all'interno del Esplora dati.

  6. Osserva l'output dell'array JSON dalla query.

    [
      {
        "name": "Carter Kai",
        "department": "Logistics",
        "emailAddresses": [
          "kai@adventure-works.com"
        ]
      }
    ]
    

    Screenshot dei risultati dell'esecuzione della query NoSQL precedente nella Esplora dati.

Esplorare altre linee guida per la configurazione e l'ottimizzazione

Dopo aver creato ed eseguito query sui dati, usare la sezione Overview per provare diverse funzionalità di Azure Cosmos DB.

  1. Nel riquadro delle risorse dell'account selezionare Panoramica nel menu del servizio.

  2. Esaminare le risorse nel Centro di Panoramica, tra cui:

    • Guide introduttive per aiutarti a sviluppare e testare la tua applicazione.

    • Linee guida per l'installazione e l'ottimizzazione per supportare ogni fase del percorso dall'apprendimento alla produzione. Le sezioni includono partizionamento, indicizzazione, modellazione, controllo dei costi, configurazione del backup e ottimizzazione delle prestazioni.

    • Contenitori e accesso ai dati per l'esecuzione di query sui dati, la regolazione della velocità effettiva e l'apertura di contenitori in Esplora dati o Visual Studio Code.

    • Strumenti di monitoraggio come Informazioni dettagliate, Metriche, Avvisi e Impostazioni di diagnostica, oltre a una scorecard che visualizza le raccomandazioni relative a disponibilità, avvisi e Azure Advisor.

    • Risorse di apprendimento come esercitazioni video, app di esempio e documentazione.

    • Consigli attuabili personalizzati per migliorare l'affidabilità, la sicurezza e l'efficienza dei costi.

    Screenshot della sezione relativa all'installazione e all'ottimizzazione dell'hub di panoramica nel portale di Azure.

Suggerimento

Il contenuto mostrato nell'hub di panoramica si adatta al tipo di attività e di carico di lavoro per facilitare la ricerca delle informazioni più rilevanti.