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

APLICA-SE A: NoSQL MongoDB Cassandra Gremlin Tabela

Ao usar uma conta do Azure Cosmos DB no modo de taxa de transferência provisionada, a maioria dos seus custos geralmente vem da quantidade de taxa de transferência que você provisionou em sua conta. Em particular, estes 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 taxa de transferência dedicada.
• A quantidade de taxa de transferência provisionada em cada um desses recursos.
• O número de regiões onde a sua conta está disponível.

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

Nota

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 resultem em exceder esse limite é bloqueada e falhará explicitamente:

• Criação de um novo banco de dados com 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 dimensionamento automático.
• Adicionar uma nova região à sua conta.

Nota

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

Importante

Depois que um limite de taxa de transferência total estiver habilitado em sua conta, você deverá 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 do Azure Cosmos DB a partir do portal, você tem a opção de limitar a taxa de transferência total da conta:

Marcar essa opção limitará a taxa de transferência total da sua conta a 1.000 RU/s para uma conta de nível gratuita e 4.000 RU/s para uma conta de nível regular e não gratuita. Pode alterar este valor depois de a sua conta ter sido criada.

Conta existente

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

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. Estão disponíveis as três opções seguintes:

• Limite a taxa de transferência total provisionada da conta ao valor incluído no desconto de nível gratuito. Esta opção só está disponível em contas de nível gratuito e limitará a taxa de transferência total da sua conta a 1.000 RU/s. Ao marcar essa opção, você garante que não incorrerá em nenhuma cobrança pela taxa de transferência provisionada.
• Permita que a taxa de transferência total da conta seja provisionada até um valor personalizado. Essa opção permite inserir a taxa de transferência total provisionada que você não deseja exceder. Uma estimativa de custo mensal correspondente à sua entrada é mostrada como referência.

  Nota

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

• Sem limite, permita que a taxa de transferência total da conta seja provisionada para qualquer montante. Esta opção desativa o limite.

Definir o limite de taxa de transferência total programaticamente

Utilizar modelos do Azure Resource Manager

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

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

Defina esta propriedade como -1 para desativar o limite.

Perguntas mais frequentes

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

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

Próximos passos

• Comece a planejar e gerenciar seus custos no Azure Cosmos DB.
• Saiba mais sobre a taxa de transferência provisionada.
• Saiba como otimizar os custos de throughput provisionado.