Desenho de custo da operação

Selo de estado: Preview (teto atual do produto) · Curso ACD-260 — Arquitetura de solução · Aula 7 de 8 · Atualizado em 2026-10-04.

Objetivo#

Ao final desta aula você vai estimar o mês de uma PME com os três bolsos e achar onde o custo foge — e vai saber a palavra certa para o número que você entrega: estimativa.

Vídeo#

Identificador: acd-260-07-desenho-de-custo-da-operacao · Duração-alvo: 9 min · Tela: /billing.

Roteiro (capítulos):

1. 0:00–1:10 — Três bolsos que todo mundo soma errado (/billing) — mensalidade, créditos de uso, teto de IA.
2. 1:10–2:40 — Franquia e recarga (/billing) — creditada uma vez por ciclo, idempotente, sem rollover.
3. 2:40–4:10 — Entitlements: o que o plano permite antes do dinheiro (/billing) — conexões, criadores, visualizadores, destinatários, modos.
4. 4:10–5:40 — O motor de custo (/query) — bytes lidos, mínimo de 10 MB, teto de 1 GiB por consulta.
5. 5:40–7:10 — Estimar o mês de uma PME (/costs) — os três vetores, a faixa P50–P90, a projeção de 6 meses.
6. 7:10–9:00 — Onde o custo foge, e a decisão da Aurora (/costs) — os seis vazamentos e o plano que se defende.

Conteúdo#

Três bolsos, e eles não se comunicam

O erro mais comum de uma proposta é somar tudo numa linha. São três controles distintos:

Essa terceira linha é a que derruba propostas: o teto de IA é outro controle. Ele zera na virada do mês, e zerado significa sem teto — não "bloqueado". Se a intenção do desenho é conter gasto de IA, o teto tem de ter um valor explícito.

A franquia é creditada exatamente uma vez por ciclo (YYYY-MM), é idempotente (reprocessar o mesmo ciclo não credita duas vezes) e não tem expiração nem rollover: ela soma ao saldo único. O extrato distingue franquia (franquia:<ws>:<ciclo>) de recarga e de storage. Enterprise/custom não tem franquia self-service — o contrato manda. E não há pro-rata de upgrade no meio do ciclo: mudar includedCredits vale para os próximos ciclos.

Entitlements: o limite que aparece antes do dinheiro

Boa parte do que parece "custo" é na verdade entitlement — e ele barra o desenho antes de qualquer crédito:

* "ilimitado" = teto muito alto (999) na prática. RLS começa no Growth; governança de PII, linhagem e auditoria no Business; SSO (Preview) e BYOC incluso no Scale+. Desenhar seis conexões num Starter não é caro: é impossível.

O motor de custo, em uma conta

O custo deriva dos bytes lidos, como o modelo on-demand do BigQuery: US$ 6,25/TiB, câmbio de estimativa configurável (5,2), e um mínimo faturado de 10 MB por consulta e 10 MB por tabela referenciada.

billed = max(bytesScanned; tableCount × 10MB; 10MB)

A regra de negócio do produto é diferente da do BigQuery: cobra-se toda consulta — não há franquia gratuita e nenhuma consulta custa R$ 0,00. Em cima disso, as guardas: maximumBytesBilled de 1 GiB por padrão (aborta antes de estourar), maxRows travado em 50.000, timeout padrão de 120 s. Em Import, 1 crédito por refresh; depois, abrir o painel não gera custo novo.

Estimar o mês de uma PME

Três vetores explicam quase todo o consumo. Estime cada um e some:

A tela de Custos e previsão (/costs) faz esse trabalho com os dados do workspace: mostra a assinatura, o consumo de infraestrutura previsto com faixa P50–P90, uma taxa de plataforma / spread opcional (só quando a operação de nuvem é intermediada), o total previsto/mês, a composição por componente e uma projeção de 6 meses com o consumo crescendo a ~8%/mês. É área do dono e custa R$ 0 para abrir, porque é simulação.

Onde o custo foge

Seis vazamentos, em ordem de frequência:

1. Full diário onde cabia incremental. O caso mais caro e o mais fácil de corrigir.
2. DirectQuery em painel muito aberto. Cada cache-miss cobra; dez leitores ao longo do dia pagam várias vezes.
3. Muitos widgets por painel. O refresh é por widget e sequencial, e cada refresh debita.
4. Três ambientes. Três workspaces = três mensalidades e três franquias (aula 3).
5. Relatórios com muitos destinatários. O entitlement limita, mas o que cabe no limite custa.
6. Teto de IA zerado. "Sem teto" não é contenção; é a ausência dela.

E dois que não são vazamento e sempre aparecem na conversa: abrir /costs, /linhagem e a tela de consumo custa R$ 0, e a verificação de assinatura existe justamente para conter custo quando a conta não está em dia — ação cara bloqueia (402), leitura de snapshot continua.

A decisão da Aurora

A Comércio Aurora está no Growth: R$ 999 de mensalidade e R$ 150 de franquia. O pedido na mesa é migrar para Business "porque o consumo vai crescer". O desenho que se defende:

• Fica no Growth. O crescimento previsto é de volume de ingestão, e o volume se resolve com incremental na fonte pesada e Import + incremental no painel executivo (aula 2) — não com mensalidade maior.
• Teto de IA explícito em vez de zerado, com ai.blocked acompanhado para saber se o time está batendo no limite.
• Recarga como plano de pico, não como rotina: um mês de fechamento mais pesado se resolve com Pix, e o extrato separa franquia de recarga.
• Business entra quando o requisito for governança, não custo: governança de PII, linhagem e auditoria começam ali. Esse é o gatilho honesto de upgrade.
• O número entregue é uma faixa, com P50 e P90 e a palavra "estimativa" escrita ao lado.
• O que é recusado: prometer "vai custar R$ X por mês". A frase: "esta é a estimativa P50–P90 do consumo; a mensalidade é fixa e certa, e o consumo de nuvem é projeção — vou conferir o real no consumo do primeiro ciclo e te trago o ajuste."

Erros comuns de desenho

• Somar os três bolsos numa linha. Mensalidade, créditos e teto de IA são controles diferentes.
• Achar que recarga levanta o teto de IA. Não levanta.
• Ler "teto zerado" como bloqueio. É o contrário.
• Contar com rollover de franquia. Não existe.
• Prometer custo faturado em BRL. É projeção; escala e latência não foram medidas.
• Confundir entitlement com custo. Seis conexões no Starter não são caras — não existem.

Faça você mesmo#

O produto desta aula é um artefato de decisão: uma estimativa de uma página com os três bolsos e dois cenários. Use /billing e /costs no workspace de treino para conferir plano, saldo e composição.

1. Escreva o bolso 1: plano e mensalidade, com os entitlements que o seu desenho consome (conexões, criadores, visualizadores, relatórios, destinatários).
2. Escreva o bolso 2: franquia do plano e a estimativa dos três vetores (ingestão, painéis, IA), cada um com a conta que você usou.
3. Escreva o bolso 3: o valor do teto mensal de IA que você está definindo — e por quê não é zero.
4. Marque, na sua estimativa, onde o mínimo de 10 MB por consulta e o teto de 1 GiB já estão protegendo o número.
5. Abra /costs, compare a sua estimativa com a faixa P50–P90 da tela e escreva a diferença e a razão dela.
6. Liste os seis vazamentos e marque quais existem no seu desenho; para cada um, escreva a correção.
7. Produza dois cenários (P50 e P90) e, abaixo, a frase de entrega com a palavra estimativa.
8. Escreva o gatilho de upgrade: qual requisito — não qual valor — fará o cliente mudar de plano.

Você terminou quando: a página mostra os três bolsos separados, uma conta por vetor, dois cenários, a palavra "estimativa" na entrega e um gatilho de upgrade escrito em forma de requisito.

Checagem rápida#

Três perguntas no final da aula, corrigidas no servidor. A aula só conta como concluída depois da checagem.

Documentação relacionada#

• administracao/planos
• administracao/consumo-e-quotas
• administracao/custos-e-previsao
• data/custo-limites-seguranca
• administracao/suspensao

Capacidades ensinadas#

C00.6 · C01.5 — o selo exibido na aula é sempre o estado mais conservador entre as capacidades citadas; nada aqui é "GA".