SQL asistido por IA: generar, revisar y validar consultas
Describa su pregunta y Telemetry podrá usar los metadatos de sus tablas para redactar SQL de DataFusion o un plan de visualización. Puede leer y editar el SQL en el espacio de trabajo Consulta. Revise las reglas de conteo antes de confiar en el resultado.
Use el borrador como punto de partida. Pida a alguien que conozca la aplicación que revise los campos, las reglas de conteo, las decisiones de privacidad y los umbrales de producción.
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.