Condividi tramite


Gestire un account Azure Cosmos DB usando il portale di Azure

SI APPLICA A: NoSQL MongoDB Cassandra Folletto maligno Tabella

Questo articolo descrive come gestire varie attività relative a un account Azure Cosmos DB usando il portale di Azure. Azure Cosmos DB può essere gestito anche con altri client di gestione di Azure, tra cui Azure PowerShell, interfaccia della riga di comando di Azure, modelli di Azure Resource Manager, Bicep e Terraform.

Suggerimento

L'API di gestione per Azure Cosmos DB o il piano di controllo non è progettato per volumi di richieste elevate come il resto del servizio. Per altre informazioni, vedere Limiti del servizio del piano di controllo

Prerequisiti

None

Creare un account

Seguire questa procedura:

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

  2. Cercare Azure Cosmos DB. Selezionare Crea>Azure Cosmos DB.

  3. Nella pagina Creare un account Azure Cosmos DB, selezionare l'opzione Crea all'interno della sezione Azure Cosmos DB for NoSQL.

    Azure Cosmos DB offre diverse API:

    • NoSQL, per i dati del documento
    • PostgreSQL
    • MongoDB, per i dati del documento
    • Apache Cassandra
    • Tabella
    • Apache Gremlin, per i dati del grafo

    Per ulteriori informazioni sulla API per NoSQL, vedere Introduzione ad Azure Cosmos DB.

  4. Nella pagina Crea account Azure Cosmos DB, immettere le impostazioni base per il nuovo account Azure Cosmos DB.

    Impostazione valore Descrizione
    Abbonamento Nome della sottoscrizione Selezionare la sottoscrizione di Azure da usare per l'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 dell'account Un nome univoco Immettere un nome per identificare l'account Azure Cosmos DB. Dato che al nome specificato viene aggiunto documents.azure.com per creare l'URI, usare un nome univoco. Il nome può contenere solo lettere minuscole, numeri e il trattino (-). Deve essere di 3-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.
    Limitare la velocità effettiva totale dell'account Selezionato o non selezionato È possibile limitare la misura totale di velocità effettiva di provisioning in questo account. Questo limite impedisce addebiti imprevisti correlati alla velocità effettiva con provisioning. È possibile aggiornare o rimuovere questo limite dopo la creazione dell'account.

    È possibile avere al massimo un account Azure Cosmos DB di livello gratuito per ogni sottoscrizione di Azure ed è necessario acconsentire esplicitamente durante la creazione dell'account. Se l'opzione di applicare lo sconto per il livello gratuito non è visualizzata, significa che un altro account nella sottoscrizione è già stato abilitato per il livello gratuito.

    Screenshot che mostra la pagina Crea account Azure Cosmos DB.

    Nota

    Le opzioni seguenti non sono disponibili se si seleziona Serverless come modalità capacità:

    • Applica sconto livello gratuito
    • Limitare la velocità effettiva totale dell'account
  5. Nella scheda Distribuzione globale configurare i dettagli seguenti. Per questo avvio rapido è possibile lasciare i valori predefiniti:

    Impostazione valore Descrizione
    Ridondanza geografica Disabilita Abilitare o disabilitare la distribuzione globale nell'account associando la propria area a un'altra area. È possibile aggiungere altre aree al proprio account in un secondo momento.
    Scritture in più regioni Disabilita La funzionalità Scritture in più aree consente di sfruttare la velocità effettiva di cui è stato effettuato il provisioning per i database e i contenitori in tutto il mondo.
    Zone di disponibilità Disabilita Le zone di disponibilità consentono di migliorare ulteriormente la disponibilità e la resilienza dell'applicazione.

    Nota

    Le opzioni seguenti non sono disponibili se si seleziona Serverless come modalità capacità nella pagina Informazioni di base precedente:

    • Ridondanza geografica
    • Scritture in più regioni
  6. Facoltativamente, è possibile configurare altri dettagli nelle schede seguenti:

  7. Selezionare Rivedi e crea.

  8. Esaminare le impostazioni dell'account e quindi selezionare Crea. La creazione dell'account richiede alcuni minuti. Attendere che la pagina del portale visualizzi La distribuzione è stata completata.

    Screenshot che mostra che la distribuzione è stata completata.

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

    Screenshot che mostra la pagina dell'account Azure Cosmos DB.

Aggiungere/rimuovere aree dall'account del database

Suggerimento

Quando viene aggiunta una nuova area, occorre eseguire la replica completa e il commit di tutti i dati nella nuova area prima che l'area venga contrassegnata come disponibile. La quantità di tempo necessaria per questa operazione dipende dalla quantità di dati archiviati nell'account. Se è in corso un'operazione di ridimensionamento della velocità effettiva asincrona, l'operazione di aumento della velocità effettiva viene sospesa e riprende automaticamente al termine dell'operazione di aggiunta/rimozione dell'area.

  1. Accedi al portale di Azure.

  2. Passare all'account Azure Cosmos DB e selezionare Replica i dati a livello globale nel menu delle risorse.

  3. Per aggiungere aree, selezionare gli esagoni sulla mappa con l'etichetta + corrispondente alle aree desiderate. In alternativa, per aggiungere un'area, selezionare l'opzione + Aggiungi area e scegliere un'area dal menu a discesa.

  4. Per rimuovere aree, deselezionare una o più aree nella mappa selezionando gli esagoni blu con segni di spunta. È anche possibile selezionare l'icona del cestino di rifiuti (🗑) accanto all'area a destra.

  5. Selezionare OK per salvare le modifiche.

    Screenshot del menu Replica dati a livello globale, evidenziando un'area.

    In modalità scrittura a una singola area non è possibile rimuovere l'area di scrittura. È necessario eseguire il failover in un'area diversa prima di poter eliminare l'area di scrittura corrente.

    In modalità di scrittura in più aree è possibile aggiungere o rimuovere qualsiasi area, purché resti almeno un'area.

    Configurare più aree di scrittura

    Aprire la scheda Replica i dati a livello globale e selezionare Abilita per abilitare le operazioni di scrittura in più aree. Dopo aver abilitato tali operazioni, tutte le aree di lettura di cui si dispone attualmente nell'account diventeranno aree di lettura e scrittura.

    Screenshot del menu Replica i dati a livello globale, evidenziando Configura aree e Salva.

Abilitare il failover gestito dal servizio per l'account Azure Cosmos DB

L'opzione di failover gestito dal servizio consente ad Azure Cosmos DB di eseguire il failover nell'area con la priorità di failover più alta senza che un'azione dell'utente diventi non disponibile. Quando il failover gestito dal servizio è abilitato, è possibile modificare la priorità delle aree. Per abilitare il failover gestito dal servizio, è necessario che l'account abbia almeno due aree.

  1. Dall'account Azure Cosmos DB aprire il riquadro Replica i dati a livello globale.

  2. Nella parte superiore del riquadro selezionare Failover gestito dal servizio.

    Screenshot che mostra il menu replica dei dati a livello globale.

  3. Nel riquadro Failover gestito dal servizio verificare che l'opzione Abilita failover gestito dal servizio sia impostata su ON.

  4. Seleziona Salva.

    Screenshot del menu del portale di failover gestito dal servizio.

Eseguire il failover forzato per l'account Azure Cosmos DB

Un failover forzato (area offline) consente agli utenti di affrontare tempestivamente prestazioni ridotte, interruzioni parziali o interruzioni a livello di area in un account Cosmos DB. Un failover gestito dal servizio dipende dalla conferma del servizio e che potrebbe richiedere tempo per l'attivazione in base all'avanzamento dell'interruzione. Un failover forzato consente agli amministratori di ripristinare rapidamente la disponibilità per l'area interessata senza attendere il failover gestito dal servizio.

  1. Dall'account Azure Cosmos DB aprire il riquadro Replica i dati a livello globale.

  2. Nella parte superiore del riquadro selezionare Area offline.

    Screenshot che mostra il menu del portale dell'area offline.

  3. Esaminare il messaggio di avviso che indica la possibilità di perdita di dati a causa di scritture non replicate non disponibili nell'area che verrà promossa alla nuova area di scrittura in base alla priorità di failover.

  4. Selezionare l'area da contrassegnare offline, selezionare la casella denominata Capisco e accettare la modalità offline dell'area attualmente selezionata e fare clic sul pulsante Area offline.

    Screenshot che mostra l'avviso dell'area offline.

  5. Al termine, l'area con la priorità di failover più alta viene alzata di livello alla nuova area di scrittura, mentre l'area di scrittura originale è contrassegnata come offline.

    Screenshot che mostra l'area offline completata.

    Il team del servizio Azure Cosmos DB gestisce il ripristino online dell'area. Se l'area è offline durante un'interruzione, potrebbero essere necessari più di tre giorni per ripristinarla online, a seconda della gravità dell'impatto. Per un'esercitazione sul ripristino di emergenza in cui un'area viene portata offline, creare una richiesta di ticket di supporto per riportare online l'area.

    Nel caso di un'area a scrittura singola, se l'area di scrittura è offline durante l'esercitazione o un'interruzione, il ripristino dell'area viene ripristinato come 'area di lettura'. Successivamente, è possibile eseguire l'operazione di modifica dell'area di scrittura per alzare di livello l'area a un'area di scrittura.

    Azure Cosmos DB offre metriche Offline e Region Online per gli utenti che vogliono creare l'automazione in base a queste metriche. Ad esempio, dopo che l'area è di nuovo online, potrebbe essere necessario attivare un processo di automazione per modificare l'area di scrittura. L'elenco delle metriche dell'account di database supportate è disponibile qui.

Impostare le priorità di failover per l'account Azure Cosmos DB

Dopo aver configurato un account Azure Cosmos DB per il failover gestito dal servizio, è possibile modificare la priorità di failover per le aree.

Importante

Se l'account è configurato per il failover gestito dal servizio, non è possibile modificare l'area di scrittura (priorità di failover zero). Per cambiare l'area di scrittura, è necessario disabilitare il failover gestito dal servizio ed eseguire un failover manuale.

  1. Dall'account Azure Cosmos DB aprire il riquadro Replica i dati a livello globale.

  2. Nella parte superiore del riquadro selezionare Failover gestito dal servizio.

    Screenshot che mostra il menu Replica dati a livello globale.

  3. Nel riquadro Failover gestito dal servizio verificare che l'opzione Abilita failover gestito dal servizio sia impostata su ON.

  4. Per modificare la priorità di failover, trascinare le aree di lettura tramite i tre puntini a sinistra nella riga, visualizzati al passaggio del mouse.

  5. Seleziona Salva.

    Screenshot del menu del portale di failover gestito dal servizio.

Modificare l'area di scrittura per l'account Azure Cosmos DB

Importante

L'account Azure Cosmos DB deve essere configurato con più aree per l'operazione change-write region.

Nota

Se si esegue un'operazione manuale sull'area di scrittura delle modifiche mentre è in corso un'operazione di ridimensionamento della velocità effettiva asincrona, l'operazione di aumento delle prestazioni della velocità effettiva viene sospesa. Riprende automaticamente al termine dell'operazione di failover. Per altre informazioni, vedere Procedure consigliate per il dimensionamento del provisioning di velocità effettiva (UR/sec)

Avviso

In caso di interruzione dell'area di scrittura, non usare l'area di scrittura. Per gli scenari di interruzione, vedere la sezione failover forzato.

  1. Passare all'account Azure Cosmos DB e aprire il menu Replica i dati a livello globale.

  2. Nella parte superiore del menu selezionare Cambia area di scrittura.

    Screenshot del menu modifica area di scrittura.

  3. Il pannello Modifica area di scrittura fornisce informazioni dettagliate per assicurarsi che questa operazione non venga eseguita durante gli scenari di interruzione. Selezionare e confermare che questa operazione non viene eseguita durante le interruzioni a livello di area.

    Screenshot dei dettagli dell'area di scrittura delle modifiche.

  4. Selezionare una nuova area di scrittura e la casella di controllo per confermare la conferma dell'operazione. Fare clic su OK per eseguire l'operazione.

    Screenshot della conferma dell'area di scrittura delle modifiche.