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 para NoSQL. Pode aprovisionar débito para um único contentor, ou para uma base de dados e partilhar o débito entre os contentores dentro dela. Para saber quando usar a largura de banda a nível de container e a nível de base de dados, consulte o artigo Casos de uso para provisionamento de largura de banda em containers e bases de dados. Você pode 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 estiver a usar uma API diferente, consulte os artigos API para MongoDB, API para Cassandra e API para Gremlin para provisionar a taxa de transferência.

Configurar largura de banda com o portal do Azure

1. Inicie sessão no portal do Azure.

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

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

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

   

Provisionar largura de banda usando a CLI do Azure ou PowerShell

Para criar uma base de dados com largura de banda partilhada, veja,

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

Configurar largura de banda utilizando o .NET SDK

Nota

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

SDK do .NET V2

//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

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

Próximos passos

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

• Dimensione globalmente a taxa de transferência provisionada
• Provisionar a taxa de transferência em contentores e bases de dados
• Como atribuir largura de banda padrão (manual) a um contentor
• Como configurar largura de banda para dimensionamento automático de um contentor
• Unidades de pedido e largura de banda no Azure Cosmos DB