Modo DATA

DATA es el flujo de trabajo de ejecución para operaciones con impacto de escritura en Genie.

Para qué sirve DATA

• Ejecutar actualizaciones de datos aprobadas.
• Ejecutar operaciones con impacto en el esquema con confirmación explícita.
• Gestionar solicitudes de migración de varios pasos con revisión y ejecución escalonadas.

Cómo decide Genie entre SQL único y plan de migración

Genie dirige tu solicitud a una de dos rutas de ejecución:

• Single-statement DATA execution para operaciones focalizadas de un solo paso.
• Migration plan para solicitudes de tipo migración o claramente de varios pasos (por ejemplo, operaciones encadenadas como agregar, rellenar y después limpiar).

Flujos completos

1. Cambia a DATA y acepta la advertencia.
2. Envía una solicitud precisa.
3. Sigue la confirmación de una sola sentencia o las tarjetas de pasos de migración.
4. Confirma, cancela, reintenta, omite o aborta según el resultado.
5. Valida los resultados antes de continuar.

Aclaración previa

Preflight es un proceso agentivo que ahora está siempre habilitado para las solicitudes DATA, para asegurar que la intención quede clara y sea consciente del esquema antes de ejecutar nada.

• Automatic: Preflight se ejecuta por defecto en cada petición DATA.
• Clarification: si la IA detecta ambigüedad o necesita más contexto de esquema, hará preguntas breves.
• Budget: puedes controlar el máximo de preguntas de aclaración en Settings > Clarification Budget > Preflight Questions.

Advertencia al entrar en el modo y activación

Flujo A: ejecución DATA de una sola sentencia

1. Genie devuelve un bloque SQL final con enlaces de acción.
2. Revisa el SQL y la intención.
3. Haz clic en Confirm (o en Confirm Full Table Change cuando sea necesario) para ejecutar, o en Cancel para detenerlo.
4. Si hace falta, escribe la frase exacta que aparece en el chat en lugar de usar el botón:
   • CONFIRM CHANGE para una ejecución escalonada estándar
   • CONFIRM FULL TABLE CHANGE para una operación de tabla completa o destructiva
5. Genie devuelve un estado de éxito, advertencia o fallo.

Flujo B: plan de migración (solicitudes de varios pasos)

En el flujo de migración, Genie devuelve un plan antes de ejecutar:

• Un resumen como “Migration plan ready (N steps)”.
• Detalles opcionales de revisión del plan completo para todos los pasos.
• Una tarjeta del paso actual con vista previa del SQL y acciones del plan.
• La fila de acciones actual usa Execute Step-by-Step, Execute All y Abort Plan.

Si eliges Execute All, Genie pide confirmación explícita antes de ejecutar de forma secuencial.

Después de ejecutar, Genie informa del progreso de cada paso y de la finalización.

Acciones de paso y qué hace cada una

• Execute Step-by-Step: ejecuta la migración un paso cada vez para que puedas revisar cada acción preparada antes de continuar.
• Execute All: ejecuta secuencialmente los pasos restantes tras la confirmación explícita.
• Abort Plan: detiene el plan de migración activo.
• Confirm: ejecuta una acción SQL preparada. También puedes escribir CONFIRM CHANGE.
• Confirm Full Table Change: requiere la confirmación exacta para UPDATE, TRUNCATE, DROP de tabla completa o acciones de impacto similar. También puedes escribir CONFIRM FULL TABLE CHANGE.
• Cancel: no ejecuta el SQL preparado y vuelve al flujo de revisión controlada.

Acciones de fallo y recuperación

Si un paso de migración falla o queda bloqueado, Genie puede mostrar controles de recuperación:

• Retry Step: vuelve a preparar y reintenta el paso fallido actual.
• Skip Step: marca el paso actual como omitido y continúa con el siguiente.
• Abort Plan: detiene el plan cuando no es seguro seguir.

Cuando omites un paso destructivo, Genie avisa de que la migración puede quedar incoherente.

Controles de seguridad deterministas que puedes ver

Antes de ejecutar, Genie aplica controles deterministas y puede bloquear la ejecución:

• Protección de tabla completa para UPDATE o DELETE sin una intención acotada.
• Detección de desajustes entre marcadores de posición y parámetros.
• Bloques de validación DATA (mostrados como mensajes [DATA Validation]).
• Bloqueo de formas de SQL no compatibles.
• Bloqueo de CREATE INDEX. Genie no ejecuta CREATE INDEX en DATA porque FileMaker gestiona el indexado mediante la configuración de campos y almacenamiento.

El bloque de advertencia y los controles de confirmación se muestran en línea en el chat para SQL de alto impacto.

Buenas prácticas para una ejecución segura

• Mantén las peticiones específicas (tabla, campos, alcance del filtro e impacto previsto).
• Valida el objetivo complejo en QUERY antes de ejecutar DATA.
• Revisa todos los pasos de migración antes de usar Execute All.
• Si necesitas cambiar el comportamiento del indexado, usa las opciones de campos/almacenamiento de FileMaker en lugar de SQL de modo DATA.
• Trata las advertencias destructivas como puntos obligatorios de revisión.

Guía de recuperación

• Si el texto de confirmación no coincide con la intención, cancela y vuelve a preparar la solicitud.
• Si un paso se detiene, usa Retry Step, Skip Step o Abort Plan según el riesgo.
• Si Genie bloquea CREATE INDEX, mueve ese cambio a la configuración de esquema de FileMaker en lugar de volver a intentarlo en DATA.
• Si la validación bloquea la ejecución, revisa el alcance o la intención del SQL y vuelve a ejecutar.
• Si el estado del plan está obsoleto, inicia una nueva solicitud DATA y regenera el plan.

Páginas relacionadas

• Modo QUERY
• Messages and Actions
• Feature-Specific Troubleshooting