Provisionar a taxa de transferência em um contêiner Cosmos do AzureProvision throughput on an Azure Cosmos container

Este artigo explica como provisionar a taxa de transferência em um contêiner (coleção, gráfico ou tabela) no Azure Cosmos DB.This article explains how to provision throughput on a container (collection, graph, or table) in Azure Cosmos DB. Você pode provisionar a produtividade em um único contêiner ou provisionar a taxa de transferência em um banco de dados e compartilhá-lo entre os contêineres no banco de dados.You can provision throughput on a single container, or provision throughput on a database and share it among the containers within the database. Você pode provisionar a taxa de transferência em um contêiner usando os SDKs portal do Azure, CLI do Azure ou Azure Cosmos DB.You can provision throughput on a container using Azure portal, Azure CLI, or Azure Cosmos DB SDKs.

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

  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 nova coleção.Open the Data Explorer pane, and select New Collection. Em seguida, forneça os seguintes detalhes:Next, provide the following details:

    • Indique se você está criando um novo banco de dados ou usando um existente.Indicate whether you are creating a new database or using an existing one.
    • Insira uma ID de contêiner (ou tabela ou gráfico).Enter a Container (or Table or Graph) ID.
    • Insira um valor de chave de partição (por exemplo, /userid).Enter a partition key value (for example, /userid).
    • Insira uma taxa de transferência que você deseja provisionar (por exemplo, 1000 RUs).Enter a throughput that you want to provision (for example, 1000 RUs).
    • Selecione OK.Select OK.

    Captura de tela de Data Explorer, com a nova coleção realçada

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

Para criar um contêiner com taxa de transferência dedicada, consulteTo create a container with dedicated throughput see,

Nota

Se você estiver Provisionando a taxa de transferência em um contêiner em uma conta do Azure Cosmos configurada com a API do Azure Cosmos DB para MongoDB, use /myShardKey para o caminho da chave de partição.If you are provisioning throughput on a container in an Azure Cosmos account configured with the Azure Cosmos DB API for MongoDB, use /myShardKey for the partition key path. Se você estiver Provisionando a taxa de transferência em um contêiner em uma conta do Azure Cosmos configurada com API do Cassandra, use /myPrimaryKey para o caminho da chave de partição.If you are provisioning throughput on a container in an Azure Cosmos account configured with Cassandra API, use /myPrimaryKey for the partition key path.

Provisionar taxa de transferência usando o SDK do .NETProvision throughput by using .NET SDK

Nota

Use os SDKs do cosmos para a API do SQL para provisionar a taxa de transferência para todas as APIs de Cosmos DB, exceto API do Cassandra.Use the Cosmos SDKs for SQL API to provision throughput for all Cosmos DB APIs, except Cassandra API.

SQL, MongoDB, Gremlin e APIs de TabelaSQL, MongoDB, Gremlin, and Table APIs

SDK do .net v2.Net V2 SDK

// Create a container with a partition key and provision throughput of 400 RU/s
DocumentCollection myCollection = new DocumentCollection();
myCollection.Id = "myContainerName";
myCollection.PartitionKey.Paths.Add("/myPartitionKey");

await client.CreateDocumentCollectionAsync(
    UriFactory.CreateDatabaseUri("myDatabaseName"),
    myCollection,
    new RequestOptions { OfferThroughput = 400 });

SDK do .net v3.Net V3 SDK

// Create a container with a partition key and provision throughput of 1000 RU/s
string containerName = "myContainerName";
string partitionKeyPath = "/myPartitionKey";

await this.cosmosClient.GetDatabase("myDatabase").CreateContainerAsync(
    id: containerName,
    partitionKeyPath: partitionKeyPath,
    throughput: 1000);

API para CassandraCassandra API

Comandos semelhantes podem ser emitidos por meio de qualquer driver compatível com CQL.Similar commands can be issued through any CQL-compliant driver.

// Create a Cassandra table with a partition (primary) key and provision throughput of 400 RU/s
session.Execute("CREATE TABLE myKeySpace.myTable(
    user_id int PRIMARY KEY,
    firstName text,
    lastName text) WITH cosmosdb_provisioned_throughput=400");

Alterar ou alterar a taxa de transferência para a tabela CassandraAlter or change throughput for Cassandra table

// Altering the throughput too can be done through code by issuing following command
session.Execute("ALTER TABLE myKeySpace.myTable WITH cosmosdb_provisioned_throughput=5000");

Passos seguintesNext steps

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