Come gestire un account Azure Cosmos DBHow to manage an Azure Cosmos DB account

Informazioni su come impostare la coerenza globale, usare le chiavi ed eliminare un account Azure Cosmos DB nel portale di Azure.Learn how to set global consistency, work with keys, and delete an Azure Cosmos DB account in the Azure portal.

Gestire le impostazioni di coerenza di Azure Cosmos DBManage Azure Cosmos DB consistency settings

La scelta del livello di coerenza giusto dipende dalla semantica dell'applicazione.Selecting the right consistency level depends on the semantics of your application. 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.Familiarize yourself with the available consistency levels in Azure Cosmos DB by reading Using consistency levels to maximize availability and performance in Azure Cosmos DB. Azure Cosmos DB offre garanzia su coerenza, disponibilità e prestazioni a ogni livello di coerenza disponibile per l'account di database.Azure Cosmos DB provides consistency, availability, and performance guarantees, at every consistency level available for your database account. 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.Configuring your database account with a consistency level of Strong requires that your data is confined to a single Azure region and not globally available. 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.On the other hand, the relaxed consistency levels - bounded staleness, session, or eventual enable you to associate any number of Azure regions with your database account. La semplice procedura seguente mostra come selezionare il livello di coerenza predefinito per l'account di database.The following simple steps show you how to select the default consistency level for your database account.

Per specificare la coerenza predefinita per un account Azure Cosmos DBTo specify the default consistency for an Azure Cosmos DB account

  1. Nel portale di Azure accedere all'account Azure Cosmos DB.In the Azure portal, access your Azure Cosmos DB account.
  2. Nella pagina dell'account fare clic su Coerenza predefinita.In the account page, click Default consistency.
  3. Nella pagina Coerenza predefinita selezionare il nuovo livello di coerenza e fare clic su Salva.In the Default Consistency page, select the new consistency level and click Save. Sessione coerenza predefinitaDefault consistency session

Visualizzare, copiare e rigenerare le chiavi di accesso e le passwordView, copy, and regenerate access keys and passwords

Quando si crea un account Azure Cosmos DB, il servizio genera due chiavi di accesso principali (o due password per gli account di API MongoDB) che possono essere usate per l'autenticazione quando si accede all'account di Azure Cosmos DB.When you create an Azure Cosmos DB account, the service generates two master access keys (or two passwords for MongoDB API accounts) that can be used for authentication when the Azure Cosmos DB account is accessed. Generando due chiavi di accesso, Azure Cosmos DB consente di rigenerare le chiavi senza interruzioni dell'account Azure Cosmos DB.By providing two access keys, Azure Cosmos DB enables you to regenerate the keys with no interruption to your Azure Cosmos DB account.

Nel Portale di Azure accedere alla pagina Chiavi dal menu delle risorse nella pagina Account Azure Cosmos DB per visualizzare, copiare e rigenerare le chiavi di accesso usate per accedere all'account Azure Cosmos DB.In the Azure portal, access the Keys page from the resource menu on the Azure Cosmos DB account page to view, copy, and regenerate the access keys that are used to access your Azure Cosmos DB account. Per gli account di API MongoDB, accedere alla pagina Stringa di connessione dal menu delle risorse per visualizzare, copiare e rigenerare le password usate per accedere all'account.For MongoDB API accounts, access the Connection String page from the resource menu to view, copy, and regenerate the passwords that are used to access your account.

Schermata del portale di Azure, pagina delle chiavi

Nota

La pagina Chiavi include anche le stringhe di connessione primaria e secondaria che possono essere usate per connettersi al proprio account dall' Utilità di migrazione dati.The Keys page also includes primary and secondary connection strings that can be used to connect to your account from the Data Migration Tool.

In questa pagina sono anche disponibili chiavi di sola lettura.Read-only keys are also available on this page. Lettura e query sono operazioni di sola lettura, a differenza di creazione, eliminazione e sostituzione.Reads and queries are read-only operations, while creates, deletes, and replaces are not.

Copiare una chiave di accesso o una password nel portale di AzureCopy an access key or password in the Azure portal

Nella pagina Chiavi (o nella pagina Stringa di connessione per gli account di API MongoDB) fare clic sul pulsante Copia a destra della chiave o della password da copiare.On the Keys page (or Connection string page for MongoDB API accounts), click the Copy button to the right of the key or password you wish to copy.

Visualizzare e copiare una chiave di accesso nella pagina Chiavi del portale di Azure

Rigenerare le chiavi di accesso e le passwordRegenerate access keys and passwords

È consigliabile modificare periodicamente le chiavi di accesso (e le password per gli account di API MongoDB) all'account Azure Cosmos DB per mantenere più sicure le connessioni.You should change the access keys (and passwords for MongoDB API accounts) to your Azure Cosmos DB account periodically to help keep your connections more secure. Vengono assegnate due chiavi di accesso o password per consentire di mantenere le connessioni all'account Azure Cosmos DB con una delle due chiavi mentre si rigenera l'altra.Two access keys/passwords are assigned to enable you to maintain connections to the Azure Cosmos DB account using one access key while you regenerate the other access key.

Avviso

La rigenerazione delle chiavi di accesso influisce su tutte le applicazioni che dipendono dalla chiave corrente.Regenerating your access keys affects any applications that are dependent on the current key. Per usare la nuova chiave è necessario aggiornare tutti i client che usano la chiave di accesso per accedere all'account Azure Cosmos DB.All clients that use the access key to access the Azure Cosmos DB account must be updated to use the new key.

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.If you have applications or cloud services using the Azure Cosmos DB account, you will lose the connections if you regenerate keys, unless you roll your keys. I passaggi seguenti illustrano il processo necessario per la registrazione delle chiavi o delle password.The following steps outline the process involved in rolling your keys/passwords.

  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.Update the access key in your application code to reference the secondary access key of the Azure Cosmos DB account.
  2. Rigenerare la chiave di accesso primaria per l'account Azure Cosmos DB.Regenerate the primary access key for your Azure Cosmos DB account. Nel portale di Azure accedere all'account Azure Cosmos DB.In the Azure portal, access your Azure Cosmos DB account.
  3. Nella pagina Account Azure Cosmos DB fare clic su Chiavi (o Stringa di connessione per gli account MongoDB**).In the Azure Cosmos DB Account page, click Keys (or Connection String for MongoDB accounts**).
  4. Nella pagina Chiavi/Stringa di connessione fare clic sul comando per rigenerare e quindi su OK per confermare che si vuole generare una nuova chiave.On the Keys/Connection String page, click the regenerate button, then click Ok to confirm that you want to generate a new key. Per rigenerare le chiavi di accessoRegenerate access keys
  5. Dopo aver verificato che la nuova chiave sia disponibile per l'utilizzo (circa cinque minuti dopo la rigenerazione), aggiornare la chiave di accesso nel codice dell'applicazione in modo che faccia riferimento alla nuova chiave di accesso primaria.Once you have verified that the new key is available for use (approximately five minutes after regeneration), update the access key in your application code to reference the new primary access key.
  6. Rigenerare la chiave di accesso secondaria.Regenerate the secondary access key.

    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.It can take several minutes before a newly generated key can be used to access your Azure Cosmos DB account.

Ottenere la stringa di connessioneGet the connection string

Per recuperare la stringa di connessione, eseguire le operazioni seguenti:To retrieve your connection string, do the following:

  1. Nel portale di Azure accedere all'account Azure Cosmos DB.In the Azure portal, access your Azure Cosmos DB account.
  2. Nel menu delle risorse fare clic su Chiavi (o Stringa di connessione per gli account di API MongoDB).In the resource menu, click Keys (or Connection String for MongoDB API accounts).
  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).Click the Copy button next to the Primary Connection String or Secondary Connection String box.

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.If you are using the connection string in the Azure Cosmos DB Database Migration Tool, append the database name to the end of the connection string. AccountEndpoint=< >;AccountKey=< >;Database=< >.AccountEndpoint=< >;AccountKey=< >;Database=< >.

Eliminare un account Azure Cosmos DBDelete an Azure Cosmos DB account

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.To remove an Azure Cosmos DB account from the Azure portal that you are no longer using, right-click the account name, and click Delete 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.In the Azure portal, access the Azure Cosmos DB account you wish to delete.
  2. Nella pagina Account Azure Cosmos DB fare clic con il pulsante destro del mouse sull'account e quindi su Elimina account.On the Azure Cosmos DB account page, right-click the account, and then click Delete Account.
  3. Nella pagina di conferma risultante digitare il nome dell'account Azure Cosmos DB per confermarne l'eliminazione.On the resulting confirmation page, type the Azure Cosmos DB account name to confirm that you want to delete the account.
  4. Fare clic sul pulsante Elimina.Click the Delete button.

Come eliminare un account Azure Cosmos DB nel portale di Azure

Passaggi successiviNext steps

Informazioni su come iniziare a usare l'account Azure Cosmos DB.Learn how to get started with your Azure Cosmos DB account.