Analítica controlada

Fixe o contrato de dados. Governe a execução. Explique o resultado.

A analítica controlada liga um relatório a DatasetVersion exatos, valida o Query Context no servidor e conserva as permissões, o RLS, os filtros, as ligações e o contexto dos artefactos subjacentes a um resultado suportado.

A analítica controlada liga um relatório a DatasetVersion exatos, valida o Query Context no servidor e conserva as permissões, o RLS, os filtros, as ligações e o contexto dos artefactos subjacentes a um resultado suportado.
Fixe o contrato de dados. Governe a execução. Explique o resultado. A analítica controlada liga um relatório a DatasetVersion exatos, valida o Query Context no servidor e conserva as permissões, o RLS, os filtros, as ligações e o contexto dos artefactos subjacentes a um resultado suportado.
ReportVersion captura intenção analítica.

Dimensões, métricas, agregação, gráfico, filtros persistentes, interações e ligações DatasetVersion pertencem a um ReportVersion imutável. Os filtros de tempo de execução criam um novo contexto de execução em vez de alterar silenciosamente essa definição guardada.

O servidor possui compilação e RLS.

O contexto de consulta do navegador referencia colunas e métricas autorizadas. O servidor valida-o e compila SQL só de leitura. Os filtros do ambiente de execução não podem fazer-se passar por metadados protegidos de origem RLS.

Todas as visualizações partilham um contrato.

Gráficos de barras verticais e horizontais, linhas, áreas, dispersão com tamanho opcional, gráficos circulares, anéis, tabelas, KPI e séries múltiplas usam um contrato versionado e independente do motor de apresentação. Os primeiros N valores com «Outros» determinístico, granularidade temporal, comparação, exploração de detalhe, linhas de referência e alternativa acessível integram a mesma especificação.

As execuções preservam resultados parciais.

AnalyticsRun regista ligações de versão, estado, filtros, permissões e âmbito RLS, contagem de linhas, diagnósticos e artefactos. A execução com múltiplas ligações processa-as sequencialmente e mostra sucesso parcial por ligação; sobreposição, união e fusão continuam a ser configurações explícitas do relatório, não junções inferidas.

Os painéis não apagam as falhas do widget.

As execuções do painel e dos widgets mantêm a ligação às identidades do relatório e do AnalyticsRun subjacentes. Um widget falhado não oculta widgets bem-sucedidos nem transforma o conjunto num falso sucesso total.

Artefactos e cache preservam a identidade de governação.

Amostras, perfis, payloads de gráficos, resultados delimitados e diagnósticos retêm SHA-256, tamanho, retenção e linhagem. Leituras locais ou S3 são limitadas e verificadas; os localizadores públicos permanecem opacos. A cache incorpora versões de relatório e Dataset, permissões e RLS, contratos de gráfico e configuração, política de execução, limites e parâmetros SQL com hash.

ReportVersion captura intenção analítica.

Dimensões, métricas, agregação, gráfico, filtros persistentes, interações e ligações DatasetVersion pertencem a um ReportVersion imutável. Os filtros de tempo de execução criam um novo contexto de execução em vez de alterar silenciosamente essa definição guardada.

O servidor possui compilação e RLS.

O contexto de consulta do navegador referencia colunas e métricas autorizadas. O servidor valida-o e compila SQL só de leitura. Os filtros do ambiente de execução não podem fazer-se passar por metadados protegidos de origem RLS.

Todas as visualizações partilham um contrato.

Gráficos de barras verticais e horizontais, linhas, áreas, dispersão com tamanho opcional, gráficos circulares, anéis, tabelas, KPI e séries múltiplas usam um contrato versionado e independente do motor de apresentação. Os primeiros N valores com «Outros» determinístico, granularidade temporal, comparação, exploração de detalhe, linhas de referência e alternativa acessível integram a mesma especificação.

Os filtros tipados do ambiente de execução derivam operadores e indicadores de preenchimento válidos do contrato da coluna selecionada.

Inspecionar dados suporta paginação delimitada, ordenação e projeção de colunas sem redefinir o relatório guardado.

O CSV, o JSON e as exportações de imagens mantêm os metadados de truncamento e linhagem.

A atualização automática cria um novo contexto de execução; ele não modifica o ReportVersion imutável.

As execuções preservam resultados parciais.

AnalyticsRun regista ligações de versão, estado, filtros, permissões e âmbito RLS, contagem de linhas, diagnósticos e artefactos. A execução com múltiplas ligações processa-as sequencialmente e mostra sucesso parcial por ligação; sobreposição, união e fusão continuam a ser configurações explícitas do relatório, não junções inferidas.

A execução durável usa idempotência, tentativas limitadas, timeouts, cancelamento, arrendamentos e recuperação em tempo hábil.

Os eventos da execução suportam reprodução em tempo real, com consulta periódica quando a transmissão contínua não está disponível.

Uma ligação falhada mantém o respetivo diagnóstico seguro; uma ligação bem-sucedida não converte a execução num falso sucesso total.

Os painéis não apagam as falhas do widget.

As execuções do painel e dos widgets mantêm a ligação às identidades do relatório e do AnalyticsRun subjacentes. Um widget falhado não oculta widgets bem-sucedidos nem transforma o conjunto num falso sucesso total.

Artefactos e cache preservam a identidade de governação.

Amostras, perfis, payloads de gráficos, resultados delimitados e diagnósticos retêm SHA-256, tamanho, retenção e linhagem. Leituras locais ou S3 são limitadas e verificadas; os localizadores públicos permanecem opacos. A cache incorpora versões de relatório e Dataset, permissões e RLS, contratos de gráfico e configuração, política de execução, limites e parâmetros SQL com hash.

O âmbito atual da compilação permanece explícito.

O compilador governado e sensível ao Dataset tem atualmente o PostgreSQL como alvo. Outras famílias de origens precisam de um adaptador de materialização ou de dialeto aceite; a presença do conector, por si só, não disponibiliza esse percurso.

Próximo passo

Comece com o fluxo que não pode permitir a ambiguidade.

Apresente os sistemas, responsáveis, regras, obrigações de entrega e requisitos de evidência relevantes.

Analisar um fluxo crítico