Impostare la velocità effettiva per i contenitori di Azure Cosmos DBSet throughput for Azure Cosmos DB containers

È possibile impostare la velocità effettiva per i contenitori di Azure Cosmos DB nel portale di Azure oppure usando gli SDK client.You can set throughput for your Azure Cosmos DB containers in the Azure portal or by using the client SDKs.

La tabella seguente elenca la velocità effettiva disponibile per i contenitori:The following table lists the throughput available for containers:

Contenitore a partizione singolaSingle Partition Container

Contenitore partizionatoPartitioned Container

Velocità effettiva minimaMinimum Throughput

400 unità richiesta al secondo400 request units per second

2.500 unità richiesta al secondo2,500 request units per second

Velocità effettiva massimaMaximum Throughput

10.000 unità richiesta al secondo10,000 request units per second

Senza limitiUnlimited

Per impostare la velocità effettiva tramite il Portale di AzureTo set the throughput by using the Azure portal

  1. In una nuova finestra accedere al Portale di Azure.In a new window, open the Azure portal.
  2. Fare clic su Azure Cosmos DB nella barra a sinistra oppure fare clic su Altri servizi nella parte inferiore, scorrere fino a Database, quindi fare clic su Azure Cosmos DB.On the left bar, click Azure Cosmos DB, or click More Services at the bottom, then scroll to Databases, and then click Azure Cosmos DB.
  3. Selezionare l'account Cosmos DB.Select your Cosmos DB account.
  4. Nella nuova finestra fare clic su Esplora dati (anteprima) dal menu di spostamento.In the new window, click Data Explorer (Preview) in the navigation menu.
  5. Nella nuova finestra espandere il database e il contenitore e quindi fare clic su Scale & Settings (Scalabilità e impostazioni).In the new window, expand your database and container and then click Scale & Settings.
  6. Nella nuova finestra digitare il nuovo valore per la velocità effettiva nella casella Velocità effettiva e quindi fare clic su Salva.In the new window, type the new throughput value in the Throughput box, and then click Save.

Per configurare la velocità effettiva usando l'API DocumentDB per .NETTo set the throughput by using the DocumentDB API for .NET

//Fetch the resource to be updated
Offer offer = client.CreateOfferQuery()
    .Where(r => r.ResourceLink == collection.SelfLink)    
    .AsEnumerable()
    .SingleOrDefault();

// Set the throughput to the new value, for example 12,000 request units per second
offer = new OfferV2(offer, 12000);

//Now persist these changes to the database by replacing the original resource
await client.ReplaceOfferAsync(offer);

Domande frequenti sulla velocità effettivaThroughput FAQ

È possibile impostare la velocità effettiva a meno di 400 UR/sec?Can I set my throughput to less than 400 RU/s?

Il valore di 400 UR/sec è la velocità effettiva minima disponibile nelle raccolte di partizioni singole di Cosmos DB. 2500 UR/sec è il valore minimo per le raccolte partizionate.400 RU/s is the minimum throughput available on Cosmos DB single partition collections (2500 RU/s is the minimum for partitioned collections). Le unità richieste sono impostate in intervalli di 100 UR/sec, ma la velocità effettiva non può essere impostata su 100 UR/sec o su qualsiasi valore inferiore a 400 UR/sec.Request units are set in 100 RU/s intervals, but throughput cannot be set to 100 RU/s or any value smaller than 400 RU/s. Se si cerca un metodo conveniente per sviluppare e testare Cosmos DB, è possibile usare la versione gratuita dell'emulatore di Azure Cosmos DB, distribuibile in locale senza alcun costo aggiuntivo.If you're looking for a cost effective method to develop and test Cosmos DB, you can use the free Azure Cosmos DB Emulator, which you can deploy locally at no cost.

Come configurare la velocità effettiva tramite l'API MongoDBHow do I set througput using the MongoDB API?

Non è disponibile alcuna estensione dell'API MongoDB per la configurazione della velocità effettiva.There's no MongoDB API extension to set throughput. È consigliabile usare l'API DocumentDB, come mostrato in Per configurare la velocità effettiva usando l'API DocumentDB per .NET.The recommendation is to use the DocumentDB API, as shown in To set the throughput by using the DocumentDB API for .NET.

Passaggi successiviNext steps

Per altre informazioni sul provisioning e sulla diffusione su scala globale di Cosmos DB, vedere Partizionamento e scalabilità con Cosmos DB.To learn more about provisioning and going planet-scale with Cosmos DB, see Partitioning and scaling with Cosmos DB.