SQL Server Agent
Aún no se ha probado en una instalación real; cuéntanos cómo te fue. El código sigue la documentación del fabricante. Escribe a support@taskbeacon.io.
T-SQL no puede llamar a una URL, así que los pings son pasos propios de la tarea (CmdExec con curl.exe).
El código
Este es el código que genera la pestaña Code (código) (con inicio y errores marcado). En la app ya contiene la dirección propia de tu job.
-- SQL Server Agent: T-SQL cannot call a URL, so add job steps around your T-SQL step.
-- curl.exe is built into Windows Server 2019+ and Windows 10/11. Step type: Operating system (CmdExec).
--
-- Step 1 "TaskBeacon start" Type: Operating system (CmdExec)
-- curl.exe -fsS -m 10 "https://taskbeacon.io/ping/your-job-id/start"
-- On success: Go to the next step. On failure: Go to the next step.
--
-- Step 2 "Your T-SQL" Type: Transact-SQL script (T-SQL)
-- EXEC dbo.your_procedure;
-- On success: Go to step 3. On failure: Go to step 4.
--
-- Step 3 "TaskBeacon success" Type: Operating system (CmdExec)
-- curl.exe -fsS -m 10 "https://taskbeacon.io/ping/your-job-id"
-- On success: Quit the job reporting success.
--
-- Step 4 "TaskBeacon fail" Type: Operating system (CmdExec)
-- curl.exe -fsS -m 10 "https://taskbeacon.io/ping/your-job-id/fail"
-- On success: Quit the job reporting failure. On failure: Quit the job reporting failure.Cómo funciona
Pasos CmdExec separados envían un ping a /start antes de tu paso T-SQL, a la dirección simple cuando este tiene éxito y a /fail cuando falla. Agent no pasa al ping ni un código de salida ni el texto del error, ni un número de filas: el error en sí está en el historial de la tarea en SQL Server.
Desmarca opciones en la pestaña Code para dejar partes fuera. Consulta qué se puede informar.
Ejecutar según un horario
En SQL Server Management Studio: SQL Server Agent → Jobs → tu job → Properties → Schedules → New. Elige diario, semanal o mensual y una hora, y pon el mismo horario en el job de TaskBeacon. Añade los pasos de arriba en Steps, en ese orden, con las acciones On success / On failure tal como están escritas.
Problemas frecuentes
- No puedes elegir Operating system (CmdExec). Por defecto, solo los miembros de sysadmin pueden crear pasos CmdExec; los demás necesitan una cuenta proxy de CmdExec (pídesela a tu DBA).
- El paso CmdExec falla, pero el paso T-SQL fue bien. El paso se ejecuta en el servidor de base de datos con la cuenta de servicio de SQL Server Agent (o el proxy), no con la tuya. Ese servidor debe poder llegar a la dirección de TaskBeacon por HTTPS; ejecuta allí la línea de curl en un Símbolo del sistema para ver qué la bloquea.
- No se encuentra curl.exe. Viene incluido en Windows Server 2019 y posteriores. En un servidor más antiguo, indica la ruta completa a un
curl.execolocado allí. - La alerta no tiene texto de error. El paso de fallo solo dice que el paso T-SQL falló. El error en sí está en SQL Server, en View History del job.
Casos de uso: Alertas de fallo de jobs de SQL Server Agent sin Database Mail. Más preguntas: preguntas frecuentes.