Limitare la velocità effettiva totale di cui è stato effettuato il provisioning nell'account Azure Cosmos DB

SI APPLICA A: NoSQL MongoDB Cassandra Gremlin Tabella

Quando si usa un account Azure Cosmos DB in modalità velocità effettiva con provisioning, la maggior parte dei costi in genere proviene dalla quantità di velocità effettiva di cui è stato effettuato il provisioning nell'account. In particolare, questi costi sono direttamente influenzati da:

• Numero di database con velocità effettiva condivisa.
• Numero di contenitori con velocità effettiva dedicata.
• Quantità di velocità effettiva di cui è stato effettuato il provisioning in ognuna di queste risorse.
• Numero di aree in cui è disponibile l'account.

Può essere difficile tenere traccia della quantità totale di velocità effettiva di cui è stato effettuato il provisioning nell'account, soprattutto quando si inizia a usare Azure Cosmos DB. Questo può causare addebiti imprevisti quando questo importo finisce per superare un determinato budget che non si prevede di superare. Per semplificare il controllo dei costi, Azure Cosmos DB consente di limitare la velocità effettiva totale di cui è stato effettuato il provisioning nell'account.

Nota

Questa funzionalità non è disponibile sugli account serverless .

Dopo aver impostato un limite alla velocità effettiva totale dell'account, una delle operazioni seguenti che comporta il superamento di questo limite viene bloccata e avrà esito negativo in modo esplicito:

• Creazione di un nuovo database con velocità effettiva condivisa.
• Creazione di un nuovo contenitore con velocità effettiva dedicata.
• Aumento della velocità effettiva con provisioning in una risorsa configurata in modalità standard (manuale).
• Aumento della velocità effettiva massima con provisioning in una risorsa configurata in modalità di scalabilità automatica.
• Aggiunta di una nuova area all'account.

Nota

Per le risorse configurate in modalità di scalabilità automatica, è la velocità effettiva massima configurata nella risorsa che conta per la velocità effettiva totale dell'account.

Importante

Dopo aver abilitato un limite di velocità effettiva totale nell'account, è necessario passare un valore di velocità effettiva esplicito durante la creazione di nuovi contenitori. Se si tenta di creare un contenitore senza velocità effettiva esplicita, verrà visualizzato un errore.

Impostare il limite totale di velocità effettiva dal portale di Azure

Nuovo account

Quando si crea un nuovo account Azure Cosmos DB dal portale, è possibile limitare la velocità effettiva totale dell'account:

Se si seleziona questa opzione, la velocità effettiva totale dell'account verrà limitata a 1.000 UR/sec per un account di livello gratuito e 4.000 UR/sec per un account di livello normale e non gratuito. È possibile modificare questo valore dopo la creazione dell'account.

Account esistente

Dal portale di Azure passare all'account Azure Cosmos DB e selezionare Gestione costi dal menu a sinistra.

Questa sezione mostra un riepilogo della velocità effettiva totale di cui è stato effettuato il provisioning nell'account e consente di configurare il limite totale di velocità effettiva. Sono disponibili le tre opzioni seguenti:

• Limitare la velocità effettiva totale con provisioning dell'account all'importo incluso nello sconto del livello gratuito. Questa opzione è disponibile solo per gli account di livello gratuito e limita la velocità effettiva totale dell'account a 1.000 UR/sec. Quando si seleziona questa opzione, assicurarsi che non vengano addebitati costi per la velocità effettiva con provisioning.
• Consentire il provisioning della velocità effettiva totale dell'account fino a un importo personalizzato. Questa opzione consente di immettere la velocità effettiva totale con provisioning che non si vuole superare. Una stima dei costi mensili corrispondente all'input viene visualizzata come riferimento.

  Nota

  Questo limite personalizzato non può essere inferiore alla velocità effettiva totale di cui è attualmente stato effettuato il provisioning nell'account.

• Nessun limite, consentire il provisioning della velocità effettiva totale dell'account a qualsiasi importo. Questa opzione disabilita il limite.

Impostare il limite totale di velocità effettiva a livello di codice

Uso di modelli di Azure Resource Manager

Quando si crea o si aggiorna l'account Azure Cosmos DB con Azure Resource Manager, è possibile configurare il limite di velocità effettiva totale impostando la properties.capacity.totalThroughputLimit proprietà :

{
  "location": "West US",
  "kind": "DocumentDB",
  "properties": {
    "locations": [
      {
        "locationName": "West US",
        "failoverPriority": 0,
        "isZoneRedundant": false
      }
    ],
    "databaseAccountOfferType": "Standard",
    "capacity": {
        "totalThroughputLimit": 2000
    }
  }
}

Impostare questa proprietà su -1 per disabilitare il limite.

Domande frequenti

In situazioni in cui la velocità effettiva totale con provisioning può superare il limite?

Azure Cosmos DB applica una velocità effettiva minima di 1 UR/sec per GB di dati archiviati. Se si inseriscono dati mentre sono già al minimo, la velocità effettiva di cui è stato effettuato il provisioning sulle risorse aumenterà automaticamente per rispettare 1 UR/s per GB. In questo caso, e solo in questo caso, la velocità effettiva totale con provisioning può superare il limite impostato.

Passaggi successivi

• Introduzione alla pianificazione e alla gestione dei costi in Azure Cosmos DB.
• Altre informazioni sulla velocità effettiva di cui è stato effettuato il provisioning.
• Informazioni su come ottimizzare i costi di velocità effettiva con provisioning.