Condividi tramite


Avvio rapido: creare un account Azure Cosmos DB for NoSQL usando il portale di Azure

SI APPLICA A: NoSQL

In questo avvio rapido viene creato un nuovo account Azure Cosmos DB for NoSQL nel portale di Azure. Si userà quindi l'esperienza Esplora dati all'interno del portale di Azure per creare un database e un contenitore, configurando tutte le impostazioni necessarie. Infine, si aggiungono dati campione al contenitore e si esegue una query di base.

Prerequisiti

Creare un account

Iniziare creando un nuovo account Azure Cosmos DB for NoSQL

  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 Azure Cosmos DB selezionata nel menu di ricerca.

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

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

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

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

    Valore
    Abbonamento Selezionare la sottoscrizione di Azure
    Gruppo di risorse Creare un nuovo gruppo di risorse o selezionarne uno esistente
    Account Name: Specificare un nome globalmente univoco
    Zone di disponibilità Disabilita
    Location Selezionare un'area di Azure supportata per la sottoscrizione

    Screenshot del riquadro

    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 attualmente in sospeso.

  8. Al termine della distribuzione, selezionare Vai alla risorsa per spostarsi al nuovo account Azure Cosmos DB for NoSQL.

    Screenshot di una risorsa completamente distribuita con l'opzione

Creare un database e un contenitore

Quindi, è possibile usare Esplora dati per creare un database e un contenitore nel portale.

  1. Nel riquadro delle risorse 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:

    Valore
    Database Crea nuovo
    ID database cosmicworks
    Produttività condivisa tra contenitori Non selezionare
    ID contenitore employees
    Chiave di partizione department/name
    Produttività del contenitore (scalabilità automatica) Scalabilità automatica
    Valore massimo di UR/sec del contenitore 1000

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

  4. Creare un nuovo file denominato demo.bicepparam o (demo.bicepparam).

  5. Osservare il database e il contenitore appena creati nella gerarchia di Esplora dati.

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

    Suggerimento

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

Aggiungere ed eseguire query sui dati campione

Infine, usare Esplora dati per creare un articolo campione e quindi eseguire una query di base per il contenitore.

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

    Screenshot dell'opzione

  2. Nel menu di Esplora dati, selezionare Nuovo articolo.

    Screenshot dell'opzione

  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 articolo all'interno di Esplora dati.

  4. Nel menu di Esplora dati, selezionare Nuova query SQL.

    Screenshot dell'opzione

  5. Ora, inserire la query NoSQL seguente per ottenere tutti gli articoli del 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 di Esplora dati.

  6. Osservare l'output della matrice JSON dalla query.

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

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