Provisionar taxa de transferência padrão (manual) em um banco de dados no Azure Cosmos DB - API para NoSQL

APLICA-SE A: NoSQL

Este artigo explica como provisionar a taxa de transferência padrão (manual) em um banco de dados no Azure Cosmos DB for NoSQL. Você pode provisionar a taxa de transferência para um único contêiner ou para um banco de dados e compartilhá-la entre os contêineres dentro dele. Para saber quando usar taxa de transferência no nível de banco de dados e de contêiner, consulte o artigo Casos de uso para provisionar taxa de transferência em contêineres e bancos de dados. É possível provisionar a taxa de transferência no nível do banco de dados usando o portal do Azure ou os SDKs do Azure Cosmos DB.

Se você estiver usando uma API diferente, confira os artigos API do MongoDB, API do Cassandra e API do Gremlin para provisionar a taxa de transferência.

Provisionar a taxa de transferência usando o portal do Azure

1. Entre no portal do Azure.

2. Crie uma conta do Azure Cosmos DB ou selecione uma existente.

3. Abra o painel Data Explorer e selecione Novo Banco de Dados. Forneça os seguintes detalhes:

   • Insira uma ID do banco de dados.
   • Selecione a opção Compartilhar a taxa de transferência entre contêineres.
   • Selecione Autoescala ou taxa de transferência manual e insira a taxa de transferência necessária do banco de dados(por exemplo, 1000 RU/s).
   • Insira um nome para o contêiner em ID do Contêiner
   • Insira uma chave de partição
   • Selecione OK.

   

Provisionar taxa de transferência com a CLI do Azure ou o PowerShell

Para criar um banco de dados com taxa de transferência compartilhada, consulte:

• Criar um banco de dados usando a CLI do Azure
• Criar um banco de dados usando o PowerShell

Provisionar a taxa de transferência usando o SDK .NET

Observação

Você pode usar os SDKs do Azure Cosmos DB para a API para NoSQL para provisionar a taxa de transferência de todas as APIs. Opcionalmente, você pode usar o exemplo a seguir para a API para Cassandra também.

.NET SDK V2

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

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

.NET SDK V3

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

Próximas etapas

Consulte os seguintes artigos para saber mais sobre taxa de transferência provisionada no Azure Cosmos DB:

• Taxa de transferência provisionada para dimensionamento global
• Provisionar a taxa de transferência para contêineres e bancos de dados
• Como provisionar a taxa de transferência padrão (manual) para um contêiner
• Como provisionar a taxa de transferência de dimensionamento automático para um contêiner
• Unidades de solicitação e taxa de transferência no Azure Cosmos DB