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

SI APPLICA A: NoSQL

• Portale di Azure
• Bicep
• Terraform
• Azure Resource Manager (JSON)

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

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.

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.

   

3. In Servizi, selezionare Azure Cosmos DB.

   

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

   

   

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

   

   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.

   

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

   

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

   

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.

   

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

   

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

   

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.

   

   Suggerimento

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

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.

   

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

   

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"
     }
   }
   

   

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

   

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)
   

   

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

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

   

Esplorare altre linee guida per la configurazione e l'ottimizzazione

Dopo aver creato ed eseguito query sui dati, usare la sezione Panoramica 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.

   

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.

Contenuto correlato

• Esplora dati
• Sintassi della query NoSQL
• Modello di risorsa