Creare un account Azure Cosmos DB for NoSQL

SI APPLICA A: NoSQL

Un account Azure Cosmos DB for NoSQL contiene tutte le risorse di Azure Cosmos DB: database, contenitori ed elementi. L'account fornisce un endpoint univoco per vari strumenti e SDK per connettersi ad Azure Cosmos DB ed eseguire operazioni quotidiane. Per altre informazioni sulle risorse in Azure Cosmos DB, vedere Modello di risorsa Azure Cosmos DB.

Prerequisiti

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

Creare un account

Creare un singolo account Azure Cosmos DB usando l'API for NoSQL.

Interfaccia della riga di comando di Azure

1. Creare variabili della shell per accountName, resourceGroupNamee location.

   # Variable for resource group name
   resourceGroupName="msdocs-cosmos"
   
   # Variable for location
   location="westus"
   
   # Variable for account name with a randomnly generated suffix
   let suffix=$RANDOM*$RANDOM
   accountName="msdocs-$suffix"
   

2. Se non è già stato fatto, accedere all'interfaccia della riga di comando di Azure usando il comando az login.

3. Eseguire il comando az group create per creare un nuovo gruppo di risorse nella propria sottoscrizione.

   az group create \
       --name $resourceGroupName \
       --location $location
   

4. Eseguire il comando az cosmosdb create per creare un nuovo account Azure Cosmos DB for NoSQL con le impostazioni predefinite.

   az cosmosdb create \
       --resource-group $resourceGroupName \
       --name $accountName \
       --locations regionName=$location
   

PowerShell

1. Creare le variabili della shell per ACCOUNT_NAME, RESOURCE_GROUP_NAME e LOCATION.

   # Variable for resource group name
   $RESOURCE_GROUP_NAME = "msdocs-cosmos"
   
   # Variable for location
   $LOCATION = "West US"
   
   # Variable for account name with a randomnly generated suffix
   $SUFFIX = Get-Random
   $ACCOUNT_NAME = "msdocs-$SUFFIX"
   

2. Se non è già stato fatto, accedere ad Azure PowerShell usando il cmdlet Connect-AzAccount.

3. Eseguire il cmdlet New-AzResourceGroup per creare un nuovo gruppo di risorse nella sottoscrizione.

   $parameters = @{
       Name = $RESOURCE_GROUP_NAME
       Location = $LOCATION
   }
   New-AzResourceGroup @parameters    
   

4. Eseguire il cmdlet New-AzCosmosDBAccount per creare un nuovo account Azure Cosmos DB for NoSQL con le impostazioni predefinite.

   $parameters = @{
       ResourceGroupName = $RESOURCE_GROUP_NAME
       Name = $ACCOUNT_NAME
       Location = $LOCATION
   }
   New-AzCosmosDBAccount @parameters
   

Portale

Suggerimento

Per questa guida, si consiglia di utilizzare il nome del gruppo di risorse msdocs-cosmos.

1. Accedere al portale di Azure.

2. Nel menu del portale di Azure o dalla pagina Home selezionare Crea una risorsa.

3. Nella pagina Nuovo cercare e selezionare Azure Cosmos DB.

4. Nella pagina dell'opzione Seleziona API selezionare l'opzione Crea nella sezione NoSQL - Scelta consigliata. Azure Cosmos DB offre cinque API: SQL, MongoDB, Gremlin, Table e Cassandra. Altre informazioni sull'API for NoSQL.

   

5. Nella pagina Creare account Azure Cosmos DB immettere le informazioni seguenti:

   Impostazione	valore	Descrizione
   Abbonamento	Nome della sottoscrizione	Selezionare la sottoscrizione di Azure da usare per questo account Azure Cosmos DB.
   Gruppo di risorse	Nome gruppo di risorse	Selezionare un gruppo di risorse oppure fare clic su Crea nuovo, quindi immettere un nome univoco per il nuovo gruppo di risorse.
   Nome conto	Un nome univoco	Immettere un nome per identificare l'account Azure Cosmos DB. Il nome verrà usato come parte di un nome di dominio completo (FQDN) con suffisso documents.azure.com e, di conseguenza, il nome deve essere univoco a livello globale. Il nome può contenere solo lettere minuscole, numeri e il segno meno (-). Il nome deve avere una lunghezza compresa tra 3 e 44 caratteri.
   Ufficio	Area più vicina ai propri utenti	Selezionare una posizione geografica in cui ospitare l'account Azure Cosmos DB. Usare la località più vicina agli utenti per offrire loro la massima velocità di accesso ai dati.
   Modalità di capacità	Velocità effettiva con provisioning o Serverless	Selezionare Provisioning velocità effettiva per creare un account in modalità Provisioning velocità effettiva. Selezionare Serverless per creare un account in modalità Serverless.
   Applicare lo sconto del livello gratuito di Azure Cosmos DB	Applicare o non applicare	Il livello gratuito di Azure Cosmos DB offre i primi 1000 UR/sec e 25 GB di spazio di archiviazione gratuiti per account. Altre informazioni sul livello gratuito.

   Nota

   È possibile avere fino a un account Azure Cosmos DB del livello gratuito per ogni sottoscrizione di Azure ed è necessario acconsentire esplicitamente durante la creazione dell'account. Se l'opzione per l'applicazione dello sconto per il livello gratuito non è visualizzata, un altro account nella sottoscrizione è già stato abilitato per il livello gratuito.

   

6. Selezionare Rivedi e crea.

7. Rivedere le impostazioni specificate e quindi selezionare Crea. La creazione dell'account richiede alcuni minuti. Attendere che la pagina del portale visualizzi La distribuzione è stata completata prima di continuare.

8. Selezionare Vai alla risorsa per passare alla pagina dell'account Azure Cosmos DB.

   

Passaggi successivi

In questa guida si è appreso come creare un account Azure Cosmos DB for NoSQL. È ora possibile creare un'applicazione con l'account Azure Cosmos DB.

Creare un'applicazione console .NET con Azure Cosmos DB for NoSQL