Selo de estado:
Preview— o limite atual do produto éPreview: nada é anunciado como GA disponível. Atualizado em 2026-09-06.
O que está disponível, em que estado, e o que não fazemos hoje — dito de forma honesta. Foco nas superfícies de desenvolvedor/integração e suporte.
Disponibilidade#
- Região: Brasil (São Paulo).
- Limite atual do produto:
Preview— sem SLA, sem promessa de uptime/latência.
O que cada estado significa#
Preview— funciona e é documentado, sem SLA; sujeito a ajustes.- Fora de GA — existe no código, não liberado para uso externo hoje.
Roadmap— planejado, ainda não disponível.
Estado das superfícies de integração#
| Superfície | Estado | Observação |
|---|---|---|
| Autenticação por chave de API | Preview | escopo de nível workspace; só o dono cria/revoga |
API de consulta REST (/api/v1/query, /api/v1/tables) | Fora de GA | rate-limit/proteção de custo em endurecimento; use OData |
| OData v4 (feed) | Preview | subset OData; ver limitações abaixo |
| Kit Power BI / Excel | Preview | folding + refresh incremental; conexão real sob validação contínua |
| Embed SDK (painel embutido) | Preview | allowlist de origem global hoje |
| Assinatura de webhooks (eventos → seu endpoint) | Roadmap | não disponível; use polling/OData |
API de escrita (INSERT/UPDATE/…) | Roadmap | a plataforma é somente leitura hoje |
| Chave de API por membro (com segurança por linha) | Roadmap | hoje a chave é de nível workspace |
Limitações conhecidas (honestidade primeiro)#
Escopo e credenciais
- A chave de API lê todos os marts publicados do workspace; não há recorte por membro/grupo neste canal. Colunas PII nunca saem pela API.
- Só o dono cria/revoga chaves.
OData / Power BI / Excel
- Subset OData: sem
$expand,$apply,$search,$compute, lambdas (any/all) e aritmética em filtro; texto sócontains/startswith/endswith. Fora do subset =501explícito.$format: apenas JSON. - Colunas
STRUCT/RECORDnão são publicadas; arrays chegam como string JSON — evite colunas repeated nos marts. - Paginação: página de até 1.000 linhas; profundidade máxima 1.000.000 de
linhas/consulta (acima →
400, filtre). DATETIMEé tratado como UTC (o datalake não guarda fuso).
Embed
- Allowlist de origens é global da instância (por-workspace =
Roadmap). aplicarFiltrosnão-vazio recarrega o iframe; eventos de cross-filter ainda não são emitidos (Roadmap).
Custo e limites
- Valores em BRL (
x-ingestia-cost-brl) são projeção, não preço faturado garantido hoje. - Rate limit: leitura 120/min por chave (240/min por workspace); SQL livre 60/min por chave (120/min por workspace).
O que NÃO prometemos hoje
- Sem SLA, sem número de uptime/latência/throughput como garantia.
- Sem RPO/RTO como promessa contratual.
- Sem "paridade total com o Power BI".
- Isolamento entre clientes é fail-closed por desenho; a certificação "provado em produção" em nuvem ainda é pendente atuais.
Validação#
- O estado de cada capacidade é derivado da matriz de estados do produto e atualizado junto com o código; mudança de estado = mudança de doc no mesmo release.
- Operadores checam a saúde profunda por
GET /api/health?deep=1.
Custo#
- Consultar esta página: R$ 0.
Segurança#
- Nenhuma informação sensível (segredos, dados de cliente, detalhes internos de infraestrutura) é publicada aqui. Relatos de segurança: ver Suporte (trate suspeita de vazamento como Crítica).
Limites#
- Esta página resume estados; o comportamento detalhado vive em cada guia de Desenvolvedores.
Troubleshooting#
| Sintoma | Causa | O que fazer |
|---|---|---|
| "A doc diz X mas o app faz Y" | possível divergência de estado | abra chamado citando a página e a URL |
Recurso listado como Roadmap/Fora de GA | ainda não disponível | acompanhe atualizações; não construa integração crítica sobre ele |
Próximos passos: Central de Suporte · Desenvolvedores · Troubleshooting.
Estado & evidência: limite atual do produto = Preview (nada GA); /api/v1 REST fora de
GA; OData e Embed = Preview. Fonte: matriz de estados do produto.