Limitare la velocità effettiva totale con provisioning nell'account Azure Cosmos DB

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

• Il numero di database con velocità effettiva condivisa.
• Il numero di contenitori con velocità effettiva dedicata.
• La quantità di velocità effettiva con provisioning in ognuna di queste risorse.
• Il numero di aree in cui è disponibile l'account.

Può essere difficile tenere traccia della quantità totale di velocità effettiva con provisioning nell'account, soprattutto quando si inizia a usare Azure Cosmos DB. Ciò può causare addebiti imprevisti quando tale quantità 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 con provisioning nell'account.

Note

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.

Note

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. Al momento viene visualizzato un errore se si tenta di creare un contenitore senza velocità effettiva esplicita.

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 a 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 Velocità effettiva account, in precedenza Gestione dei costi, dalle impostazioni nel menu a sinistra.

Questa sezione mostra un riepilogo della velocità effettiva totale con 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 alla quantità inclusa 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 una quantità personalizzata. 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.

  Note

  Questo limite personalizzato non può essere inferiore alla velocità effettiva totale attualmente con provisioning nell'account.

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

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

Uso dei modelli di Gestione risorse di Azure

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 proprietà properties.capacity.totalThroughputLimit:

{
  "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

Ci sono 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 si è già al minimo, la velocità effettiva con 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 con provisioning.
• Informazioni su come ottimizzare i costi della velocità effettiva con provisioning.