SQL asistido por IA: generar, revisar y validar consultas
Telemetry puede utilizar una pregunta en lenguaje sencillo y metadatos de tabla para generar una primera consulta o plan de visualización DataFusion SQL. El SQL permanece visible y editable en el espacio de trabajo Consulta. Esto puede reducir el tiempo de páginas en blanco, pero no convierte una pregunta comercial ambigua en una métrica autorizada.
Utilice la asistencia de IA para acelerar. Mantenga la propiedad de los contratos de eventos, las reglas de conteo, las decisiones de privacidad y los umbrales de producción con personas que puedan revisar el sistema subyacente.
Escribir un mensaje acotado
Un mensaje útil identifica la tabla, el grano de eventos, la métrica, el rango de tiempo, los filtros, la agrupación y el resultado esperado. Por ejemplo:
Using api_request_completed, calculate hourly error rate for production
over the last seven complete days. A failed request has outcome = 'error'.
Return request_count, failed_count, and error_rate. Split by route_template,
exclude incomplete current-hour data, and order newest hour first.
Esto es más seguro que "mostrar el estado del API" porque el denominador, la definición del resultado, el límite de tiempo y la agrupación son explícitos.
No pegue secretos, contenido sin procesar del cliente, tokens de acceso, mensajes privados o datos personales no revisados en la instrucción. Prefiere nombres de esquemas, categorías limitadas y ejemplos sintéticos.
Revisar la consulta generada
Antes de ejecutar o guardar el SQL generado, inspeccione estas suposiciones:
| Área de revisión | Pregunta |
|---|---|
| Tabla y grano | ¿Una fila representa la unidad que se está contando? |
| Nombres y tipos de campos | ¿Existen los campos referenciados con tipos compatibles? |
| tiempo | ¿Se filtra la marca de tiempo UTC prevista y se manejan los depósitos incompletos? |
| denominador | ¿La tasa se divide entre todos los resultados elegibles y no solo entre los éxitos? |
| Nulos | ¿Los valores faltantes están excluidos, agrupados o predeterminados deliberadamente? |
| Se une | ¿Se preagregó cada tabla en un grano seguro antes de unirse? |
| Duplicados | ¿Los reintentos o la entrega repetida pueden contar el mismo resultado comercial dos veces? |
| Dimensiones | ¿Los campos de agrupación están lo suficientemente delimitados como para devolver un resultado útil? |
| Unidades | ¿La duración, los bytes, los tokens, la moneda y los porcentajes se convierten de manera consistente? |
DataFusion SQL se diferencia de PostgreSQL, BigQuery, Snowflake y otros motores. Una función sintácticamente familiar puede necesitar un equivalente compatible. Utilice DataFusion SQL referencia cuando una expresión generada no esté planificada.
Validar el resultado
La ejecución exitosa solo prueba que la consulta se ejecutó. Validar significado con un elemento fijo o una pequeña ventana conocida:
- Inspeccione las filas sin procesar para detectar un grupo esperado.
- Calcule un recuento, suma o tasa manualmente.
- Compare el resultado con el agregado generado.
- Pruebe un período vacío y un período que contenga valores nulos.
- Verifique el depósito más nuevo para ver datos parciales.
- Cambie un filtro y confirme que el resultado cambia en la dirección esperada.
Para las uniones, compare el recuento de filas antes y después de la unión. Una multiplicación inesperada suele indicar granos incompatibles.
Guardar solo análisis revisados
Cambie el nombre de una consulta revisada por la decisión que respalda, no por el mensaje que la creó. Incluya unidades y alcance importante en el nombre cuando sea práctico. Guarde una nueva entrada del historial cuando cambie la lógica y explique los cambios de definición de materiales junto al panel que la utiliza.
No conecte el SQL generado directamente a una alerta de localización, un flujo de trabajo de facturación, una decisión de control de acceso o un informe financiero de cara al cliente sin una revisión del dominio y pruebas representativas.
Mejorar una primera respuesta débil
Si la primera consulta es incorrecta, haga explícita la corrección:
- definir el grano en hilera y la población elegible;
- proporcionar valores categóricos exactos;
- especificar si la identidad es por usuario, cuenta, sesión o evento;
- nombrar el campo de tiempo esperado y el depósito;
- indicar cómo manejar nulos, reintentos y entregas duplicadas;
- solicitar conteos intermedios además del porcentaje final;
- Solicite una breve lista de suposiciones con el SQL.
El Paquete de avisos Telemetry incluye instrumentación reutilizable y mensajes de revisión del SQL. Continúe con SQL Observabilidad y análisis de eventos o practique con datos deterministas en el Laboratorio SaaS SQL.