Dimensiones, métricas, agregación, gráfico, filtros persistentes, interacciones y vinculaciones de DatasetVersion pertenecen a un ReportVersion inmutable. Los filtros de ejecución crean un nuevo contexto de ejecución, en lugar de cambiar silenciosamente la definición guardada.
Analítica controlada
Fije el contrato de datos. Gobierne la ejecución. Explique el resultado.
La analítica controlada vincula un Report con DatasetVersion exactas, valida el contexto de consulta en el servidor y conserva los permisos, RLS, filtros, vinculaciones y artefactos que explican un resultado admitido.
QueryContext del navegador referencia columnas y métricas autorizadas. El servidor valida y compila SQL de solo lectura. Los filtros de ejecución no pueden suplantar el origen RLS protegido ni sus metadatos.
Gráficos de barras verticales y horizontales, líneas, áreas, dispersión con tamaño opcional, sectores, anillos, tablas, KPI y gráficos multiserie utilizan un contrato versionado e independiente del renderizador. Top N con una categoría «Otros» determinista, grano temporal, comparación, desglose interactivo, líneas de referencia y alternativa accesible forman parte de la misma especificación.
AnalyticsRun registra vinculaciones de versiones, estado, filtros, ámbito de permisos y RLS, recuentos de filas, diagnósticos y artefactos. Una ejecución con varias vinculaciones procesa las vinculaciones guardadas secuencialmente y muestra el éxito parcial de cada una; superposición, unión y combinación siguen siendo configuraciones explícitas de Report, no una unión de tablas inferida.
Las ejecuciones de panel y componente conservan su vínculo con las identidades Report y AnalyticsRun subyacentes. Un componente fallido no tiene que ocultar componentes correctos ni convertirse en un falso éxito completo.
Muestras, perfiles, cargas de gráficos, resultados acotados y diagnósticos conservan SHA-256, tamaño, retención y linaje. Las lecturas locales o S3 están acotadas y verifican integridad; los localizadores públicos son opacos. La identidad de caché incluye versiones Report y Dataset, ámbito de permisos y RLS, contratos de gráfico y configuración, política, límites y parámetros SQL con hash.
ReportVersion captura la intención analítica.
Dimensiones, métricas, agregación, gráfico, filtros persistentes, interacciones y vinculaciones de DatasetVersion pertenecen a un ReportVersion inmutable. Los filtros de ejecución crean un nuevo contexto de ejecución, en lugar de cambiar silenciosamente la definición guardada.
El servidor controla la compilación y RLS.
QueryContext del navegador referencia columnas y métricas autorizadas. El servidor valida y compila SQL de solo lectura. Los filtros de ejecución no pueden suplantar el origen RLS protegido ni sus metadatos.
La visualización comparte un único contrato.
Gráficos de barras verticales y horizontales, líneas, áreas, dispersión con tamaño opcional, sectores, anillos, tablas, KPI y gráficos multiserie utilizan un contrato versionado e independiente del renderizador. Top N con una categoría «Otros» determinista, grano temporal, comparación, desglose interactivo, líneas de referencia y alternativa accesible forman parte de la misma especificación.
Los filtros de ejecución tipados derivan operadores y placeholders válidos del contrato de columna seleccionado.
Inspect Data admite paginación, ordenación y proyección de columnas acotadas sin redefinir el Report guardado.
Las exportaciones acotadas CSV, JSON e imagen conservan metadatos de truncamiento y linaje.
Auto-refresh crea un nuevo contexto de ejecución; no muta el ReportVersion inmutable.
Las ejecuciones preservan resultados parciales.
AnalyticsRun registra vinculaciones de versiones, estado, filtros, ámbito de permisos y RLS, recuentos de filas, diagnósticos y artefactos. Una ejecución con varias vinculaciones procesa las vinculaciones guardadas secuencialmente y muestra el éxito parcial de cada una; superposición, unión y combinación siguen siendo configuraciones explícitas de Report, no una unión de tablas inferida.
La ejecución duradera utiliza idempotencia, reintentos acotados, límites de tiempo, cancelación, arrendamientos y recuperación de ejecuciones obsoletas.
Los eventos de ejecución permiten repetición en vivo, con consulta periódica como alternativa cuando la transmisión no está disponible.
Una vinculación fallida conserva su diagnóstico seguro; una correcta no convierte la ejecución en un falso éxito completo.
Los artefactos y la caché preservan la identidad de gobernanza.
Muestras, perfiles, cargas de gráficos, resultados acotados y diagnósticos conservan SHA-256, tamaño, retención y linaje. Las lecturas locales o S3 están acotadas y verifican integridad; los localizadores públicos son opacos. La identidad de caché incluye versiones Report y Dataset, ámbito de permisos y RLS, contratos de gráfico y configuración, política, límites y parámetros SQL con hash.
El ámbito de compilación actual permanece explícito.
El compilador gobernado y consciente de Dataset se dirige actualmente a PostgreSQL. Otras familias Source necesitan una materialización aceptada o un adaptador de dialecto; la presencia del conector por sí sola no proporciona esa ruta.
Siguiente paso
Empiece por el flujo que no puede permitirse ambigüedades.
Incluya los sistemas, responsables, reglas, obligaciones de entrega y requisitos de evidencia relevantes.
Analizar un flujo crítico