Provisione a taxa de transferência em um banco de dados no Azure Cosmos DBProvision throughput on a database in Azure Cosmos DB

Este artigo explica como provisionar a taxa de transferência em um banco de dados no Azure Cosmos DB.This article explains how to provision throughput on a database in Azure Cosmos DB. Pode aprovisionar débito para um único contentor ou para uma base de dados e partilhá-la entre os contentores na mesma.You can provision throughput for a single container, or for a database and share the throughput among the containers within it. Para saber quando usar a taxa de transferência no nível de contêiner e de banco de dados, consulte o artigo casos de uso para provisionar a taxa de transferência em contêineres e bancos de dados.To learn when to use container-level and database-level throughput, see the Use cases for provisioning throughput on containers and databases article. Você pode provisionar a taxa de transferência no nível do banco de dados usando o portal do Azure ou Azure Cosmos DB SDKs.You can provision database level throughput by using the Azure portal or Azure Cosmos DB SDKs.

Aprovisionar débito com o portal do AzureProvision throughput using Azure portal

API de SQL (Core)SQL (Core) API

  1. Inicie sessão no Portal do Azure.Sign in to the Azure portal.

  2. Crie uma nova conta do Azure Cosmosou selecione uma conta existente do Azure Cosmos.Create a new Azure Cosmos account, or select an existing Azure Cosmos account.

  3. Abra o painel Data Explorer e selecione novo banco de dados.Open the Data Explorer pane, and select New Database. Forneça os seguintes detalhes:Provide the following details:

    • Insira uma ID de banco de dados.Enter a database ID.
    • Selecione provisionar taxa de transferência.Select Provision throughput.
    • Insira uma taxa de transferência (por exemplo, 1000 RUs).Enter a throughput (for example, 1000 RUs).
    • Selecione OK.Select OK.

    Captura de tela da caixa de diálogo novo banco de dados

Provisionar taxa de transferência usando o CLI do Azure ou o PowerShellProvision throughput using Azure CLI or PowerShell

Para criar um banco de dados com taxa de transferência compartilhada, consulteTo create a database with shared throughput see,

Aprovisionar débito com o SDK do .NETProvision throughput using .NET SDK

Nota

Você pode usar SDKs do cosmos para a API do SQL para provisionar a taxa de transferência para todas as APIs.You can use Cosmos SDKs for SQL API to provision throughput for all APIs. Opcionalmente, você também pode usar o exemplo a seguir para API do Cassandra.You can optionally use the following example for Cassandra API as well.

Todas as APIsAll APIs

SDK do .net v2.Net V2 SDK

//set the throughput for the database
RequestOptions options = new RequestOptions
{
    OfferThroughput = 500
};

//create the database
await client.CreateDatabaseIfNotExistsAsync(
    new Database {Id = databaseName},  
    options);

SDK do .net v3.Net V3 SDK

//create the database with throughput
string databaseName = "MyDatabaseName";
await this.cosmosClient.CreateDatabaseIfNotExistsAsync(
        id: databaseName,
        throughput: 1000);

API para CassandraCassandra API

Um comando semelhante pode ser executado por meio de qualquer driver compatível com CQL.Similar command can be executed through any CQL compliant driver.

// Create a Cassandra keyspace and provision throughput of 400 RU/s
session.Execute("CREATE KEYSPACE IF NOT EXISTS myKeySpace WITH cosmosdb_provisioned_throughput=400");

Passos seguintesNext steps

Consulte os artigos a seguir para saber mais sobre a taxa de transferência provisionada no Azure Cosmos DB:See the following articles to learn about provisioned throughput in Azure Cosmos DB: