Come gestire un account Azure Cosmos DB

Informazioni su come impostare la coerenza globale, usare le chiavi ed eliminare un account Azure Cosmos DB nel portale di Azure.

Gestire le impostazioni di coerenza di Azure Cosmos DB

La scelta del livello di coerenza giusto dipende dalla semantica dell'applicazione. È consigliabile acquisire familiarità con i livelli di coerenza disponibili in Azure Cosmos DB leggendo Uso dei livelli di coerenza per ottimizzare la disponibilità e le prestazioni di Azure Cosmos DB. Azure Cosmos DB offre garanzia su coerenza, disponibilità e prestazioni a ogni livello di coerenza disponibile per l'account di database. La configurazione dell'account di database con un forte livello di coerenza richiede che i dati vengano limitati a una singola area di Azure, senza disponibilità globale. D'altra parte, i livelli di coerenza ampi (obsolescenza associata, sessione o finale) consentono di associare tutte le aree di Azure desiderate con l'account di database. La semplice procedura seguente mostra come selezionare il livello di coerenza predefinito per l'account di database.

Per specificare la coerenza predefinita per un account Azure Cosmos DB

  1. Nel portale di Azure accedere all'account Azure Cosmos DB.
  2. Nel pannello dell'account fare clic su Coerenza predefinita.
  3. Nel pannello Default Consistency (Uniformità predefinita) selezionare il nuovo livello di coerenza e fare clic su Salva. Sessione Coerenza predefinita

Visualizzare, copiare e rigenerare le chiavi di accesso

Quando si crea un account Azure Cosmos DB, il servizio genera due chiavi di accesso principali che possono essere usate per l'autenticazione quando si accede all'account Azure Cosmos DB. Generando due chiavi di accesso, Azure Cosmos DB consente di rigenerare le chiavi senza interruzioni dell'account Azure Cosmos DB.

Nel Portale di Azure accedere al pannello Chiavi dal menu delle risorse nel pannello Account Azure Cosmos DB per visualizzare, copiare e rigenerare le chiavi di accesso usate per accedere all'account Azure Cosmos DB.

Schermata del portale di Azure, pannello delle chiavi

Nota

Il pannello Chiavi include anche le stringhe di connessione primaria e secondaria che possono essere usate per connettersi al proprio account dall' Utilità di migrazione dati.

In questo pannello sono anche disponibili chiavi di sola lettura. Lettura e query sono operazioni di sola lettura, a differenza di creazione, eliminazione e sostituzione.

Copiare una chiave di accesso nel portale di Azure

Nel pannello Keys (Chiavi) fare clic sul pulsante Copy (Copia) a destra della chiave da copiare.

Visualizzare e copiare una chiave di accesso nel portale di Azure, pannello delle chiavi

Per rigenerare le chiavi di accesso

È consigliabile modificare periodicamente le chiavi di accesso all'account Azure Cosmos DB per mantenere più sicure le connessioni. Vengono assegnate due chiavi di accesso per consentire di mantenere le connessioni all'account Azure Cosmos DB con una delle due chiavi mentre si rigenera l'altra.

Avviso

La rigenerazione delle chiavi di accesso influisce su tutte le applicazioni che dipendono dalla chiave corrente. Per usare la nuova chiave è necessario aggiornare tutti i client che usano la chiave di accesso per accedere all'account Azure Cosmos DB.

Se si dispone di applicazioni o servizi cloud che usano l'account Azure Cosmos DB e si rigenerano le chiavi, si perderanno le connessioni, a meno che non si registrino le chiavi. I passaggi seguenti illustrano il processo necessario per la registrazione delle chiavi.

  1. Aggiornare la chiave di accesso nel codice dell'applicazione in modo che faccia riferimento alla chiave di accesso secondaria dell'account Azure Cosmos DB.
  2. Rigenerare la chiave di accesso primaria per l'account Azure Cosmos DB. Nel portale di Azure accedere all'account Azure Cosmos DB.
  3. Nel pannello Account Azure Cosmos DB fare clic su Chiavi.
  4. Nel pannello Keys (Chiavi) fare clic sul comando per rigenerare e quindi su OK per confermare che si vuole generare una nuova chiave. Per rigenerare le chiavi di accesso
  5. Dopo aver verificato che la nuova chiave sia disponibile per l'utilizzo (circa 5 minuti dopo la rigenerazione), aggiornare la chiave di accesso nel codice dell'applicazione in modo che faccia riferimento alla nuova chiave di accesso primaria.
  6. Rigenerare la chiave di accesso secondaria.

    Per rigenerare le chiavi di accesso

Nota

Potrebbero trascorrere diversi minuti prima che una chiave appena generata possa essere usata per accedere all'account Azure Cosmos DB.

Ottenere la stringa di connessione

Per recuperare la stringa di connessione, eseguire le operazioni seguenti:

  1. Nel portale di Azure accedere all'account Azure Cosmos DB.
  2. Nel menu delle risorse fare clic su Keys (Chiavi).
  3. Fare clic sul pulsante Copy (Copia) accanto alla casella Primary Connection String (Stringa di connessione primaria) o Secondary Connection String (stringa di connessione secondaria).

Se si usa la stringa di connessione nello strumento di migrazione del database di Azure Cosmos DB, aggiungere il nome del database alla fine della stringa di connessione. AccountEndpoint=< >;AccountKey=< >;Database=< >.

Eliminare un account Azure Cosmos DB

Per rimuovere un account Azure Cosmos DB non più usato dal portale di Azure, fare clic con il pulsante destro del mouse sul nome dell'account e quindi su Elimina account.

Come eliminare un account Azure Cosmos DB nel portale di Azure

  1. Nel portale di Azureaccedere all'account Azure Cosmos DB che si desidera eliminare.
  2. Nel pannello Account Azure Cosmos DB fare clic con il pulsante destro del mouse sull'account e quindi su Elimina account.
  3. Nel pannello di conferma risultante digitare il nome dell'account Azure Cosmos DB per confermarne l'eliminazione.
  4. Fare clic sul pulsante Elimina.

Come eliminare un account Azure Cosmos DB nel portale di Azure

Passaggi successivi

Informazioni su come iniziare a usare l'account Azure Cosmos DB.