Limite a taxa de transferência total provisionada em sua conta do Azure Cosmos DB

APLICA-SE AO: NoSQL MongoDB Cassandra Gremlin Table

Ao usar uma conta do Azure Cosmos DB no modo de taxa de transferência provisionada, a maioria dos custos geralmente vem da quantidade de produtividade provisionada em sua conta. Em particular, esses custos são diretamente influenciados por:

  • O número de bancos de dados que compartilharam a taxa de transferência.
  • O número de contêineres que têm uma taxa de transferência dedicada.
  • A quantidade de taxa de transferência provisionada em cada um desses recursos.
  • O número de regiões em que sua conta está disponível.

Pode ser um desafio manter o controle da quantidade total de taxa de transferência provisionada em sua conta, especialmente quando você está começando a usar o Azure Cosmos DB. Isso pode levar a encargos inesperados quando esse valor acaba ultrapassando um determinado orçamento que você não esperava exceder. Para ajudá-lo a controlar melhor seus custos, o Azure Cosmos DB permite limitar a taxa de transferência total provisionada em sua conta.

Observação

Esse recurso não está disponível em contas sem servidor.

Depois de definir um limite para a taxa de transferência total da sua conta, qualquer uma das seguintes operações que resulta em exceder esse limite será bloqueada e falhará explicitamente:

  • Criando um novo banco de dados com a taxa de transferência compartilhada.
  • Criação de um novo contêiner com taxa de transferência dedicada.
  • Aumentar a taxa de transferência provisionada em um recurso configurado no modo padrão (manual).
  • Aumentar a taxa de transferência máxima provisionada em um recurso configurado no modo de autoescala.
  • Adicionar uma nova região à sua conta.

Observação

Para recursos configurados no modo de autoescala, é a taxa de transferência máxima configurada no recurso que conta para a produtividade total da sua conta.

Importante

Depois que um limite de taxa de transferência total é habilitado em sua conta, você deve passar um valor de taxa de transferência explícito ao criar novos contêineres. No momento, você receberá um erro se tentar criar um contêiner sem taxa de transferência explícita.

Definir o limite de taxa de transferência total do portal do Azure

Nova conta

Ao criar uma nova conta Cosmos banco de dados do Azure no portal, você tem a opção de limitar a taxa de transferência total da conta:

Captura de tela da portal do Azure mostrando como limitar a taxa de transferência total da conta ao criar uma nova conta

Marcar essa opção limitará a taxa de transferência total da sua conta a 1.000 RU/s para uma conta de camada gratuita e 4.000 RU/s para uma conta de camada regular e não gratuita. Você pode alterar esse valor depois que sua conta tiver sido criada.

Conta existente

No portal do Azure, navegue até sua conta do Azure Cosmos DB e selecione Gerenciamento de custos no menu à esquerda.

Captura de tela da portal do Azure mostrando como atualizar a taxa de transferência total da conta em uma conta existente

Esta seção mostra um resumo da taxa de transferência total provisionada em sua conta e permite configurar o limite de taxa de transferência total. As seguintes opções estão disponíveis:

  • Limite a taxa de transferência total provisionada da conta ao valor incluído no desconto por nível gratuito. Essa opção só está disponível em contas de camada gratuita e limitará a taxa de transferência total da sua conta a 1.000 RU/s. Ao verificar essa opção, você garante que não incorre em encargos de taxa de transferência provisionada.
  • Permitir que a taxa de transferência total da conta seja provisionada até um valor personalizado. Essa opção permite que você insira a taxa de transferência total provisionada que você não deseja exceder. Uma estimativa de custo mensal correspondente à sua entrada é mostrada como uma referência.

    Observação

    Esse limite personalizado não pode ser inferior à taxa de transferência total provisionada atualmente na conta.

  • Sem limite, permite que a taxa de transferência total da conta seja provisionada em qualquer valor. Essa opção desabilita o limite.

Definir o limite de a taxa de transferência total programaticamente

Usar modelos do Azure Resource Manager

Ao criar ou atualizar sua conta do Azure Cosmos DB com Azure Resource Manager, você pode configurar o limite de a taxa de transferência total definindo a propriedade properties.capacity.totalThroughputLimit:

{
  "location": "West US",
  "kind": "DocumentDB",
  "properties": {
    "locations": [
      {
        "locationName": "West US",
        "failoverPriority": 0,
        "isZoneRedundant": false
      }
    ],
    "databaseAccountOfferType": "Standard",
    "capacity": {
        "totalThroughputLimit": 2000
    }
  }
}

Definir essa propriedade como -1 para desabilitar o limite.

Perguntas frequentes

Há situações em que a taxa de transferência total provisionada pode exceder o limite?

O Azure Cosmos DB aplica uma taxa de transferência mínima de 1 RU/s por GB de dados armazenados. Se você estiver ingerindo dados enquanto já estiver no mínimo, a taxa de transferência provisionada em seus recursos aumentará automaticamente para atender a 1 RU/s por GB. Nesse caso, e somente nesse caso, a taxa de transferência total provisionada pode exceder o limite definido.

Próximas etapas