Esaminare le operazioni di base

  • 5 minuti

Esistono alcune operazioni di base che è necessario eseguire ogni volta che si crea una risorsa dell'account Azure Cosmos DB per NoSQL in Azure.

Creazione di un nuovo account

Il primo passaggio per iniziare a usare Azure Cosmos DB consiste nel creare un nuovo account.

Quando si crea un nuovo account nel portale, è prima necessario selezionare un'API per il carico di lavoro. La selezione dell'API non può essere modificata dopo la creazione dell'account. Per la parte restante di questa sezione, si presuppone che l'API NoSQL sia stata selezionata.

Screenshot che mostra l'opzione select API nel portale con un elenco di tutte le API correnti, tra cui SQL, MongoDB, Graph, Table e Cassandra.

Il portale di Azure userà quindi una procedura guidata dettagliata con schede per le varie opzioni di configurazione. Qui è possibile configurare opzioni come:

  • Nome univoco globale dell'account
  • Località (area di Azure) per l'account
  • Modalità di capacità (velocità effettiva con provisioning o serverless)

Screenshot che mostra la procedura guidata con varie schede e opzioni per la creazione di un nuovo account Azure Cosmos DB per NoSQL.

Nota

Per creare un account Azure Cosmos DB sono necessarie solo le opzioni disponibili nella scheda Informazioni di base .

Creazione di un nuovo database

I database sono unità logiche di gestione in Azure Cosmos DB per NoSQL e non richiedono molto da creare. Per creare un nuovo database, è necessario solo un nome di database univoco all'interno dell'account.

Nota

Tuttavia, se si sceglie di effettuare il provisioning della velocità effettiva a livello di database, la configurazione del database potrebbe richiedere passaggi aggiuntivi. Questo argomento viene esaminato più in dettaglio in altri argomenti di Azure Cosmos DB per NoSQL.

Creazione di un nuovo contenitore

I contenitori sono l'unità principale di scalabilità in Azure Cosmos DB per NoSQL. Durante la creazione di un contenitore è necessario specificare:

  • Database padre
  • Nome univoco per il contenitore con il database
  • Percorso del valore della chiave di partizione
  • Facoltativo: velocità effettiva con provisioning se non si usa un account serverless.

Il servizio Azure Cosmos DB partizionerà in modo automatico e trasparente i dati in base al valore della chiave di partizione per ogni singolo elemento.

Creazione di elementi semplici

Dopo aver creato le risorse del database e del contenitore, è possibile creare il primo elemento. In Azure Cosmos DB per NoSQL un elemento è un documento JSON.

Nota

JavaScript Object Notation (JSON) è un formato di file standard aperto e un formato di interscambio dati che usa testo leggibile per archiviare e trasmettere oggetti dati costituiti da coppie attributo-valore e tipi di dati di matrice (o qualsiasi altro valore serializzabile)

JSON è un formato di dati indipendente dal linguaggio con tipi di dati ben definiti e supporto quasi universale in un'ampia gamma di servizi e linguaggi di programmazione. Ecco un esempio di documento JSON che può essere usato come elemento in un account Azure Cosmos DB:

{
  "id": "0012D555-C7DE",
  "type": "customer",
  "fullName": "Franklin Ye",
  "title": null,
  "emailAddress": "fye@cosmic.works",
  "creationDate": "2014-02-05",
  "addresses": [
    {
      "addressLine": "1796 Westbury Drive",
      "cityStateZip": "Melton, VIC 3337 AU"
    },
    {
      "addressLine": "9505 Hargate Court",
      "cityStateZip": "Bellflower, CA 90706 US"
    }
  ],
  "password": {
    "hash": "GQF7qjEgMk=",
    "salt": "12C0F5A5"
  },
  "salesOrderCount": 2
}