SQL Server Agent
Noch nicht an einer echten Installation getestet – sagen Sie uns, wie es gelaufen ist. Der Code folgt der Dokumentation des Herstellers. Schreiben Sie an support@taskbeacon.io.
T-SQL kann keine URL aufrufen, deshalb sind die Pings eigene Jobschritte (CmdExec mit curl.exe).
Der Code
Das ist der Code, den der Tab Code erzeugt (mit Start und Fehler angehakt). In der App enthält er bereits die eigene Adresse Ihres Jobs.
-- 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.So funktioniert es
Eigene CmdExec-Schritte pingen /start vor Ihrem T-SQL-Schritt, die einfache Adresse, nachdem er erfolgreich war, und /fail, wenn er fehlschlägt. Agent übergibt dem Ping weder einen Exit-Code noch den Fehlertext und auch keine Zeilenzahl: Der Fehler selbst steht im Verlauf des Jobs in SQL Server.
Entfernen Sie auf dem Tab Code Haken bei Optionen, um Teile wegzulassen. Siehe was gemeldet werden kann.
Nach Zeitplan ausführen
In SQL Server Management Studio: SQL Server Agent → Jobs → Ihr Job → Properties (Eigenschaften) → Schedules (Zeitpläne) → New (Neu). Wählen Sie täglich, wöchentlich oder monatlich und eine Uhrzeit, und stellen Sie beim Job in TaskBeacon denselben Zeitplan ein. Fügen Sie die Schritte oben unter Steps (Schritte) hinzu, in dieser Reihenfolge, mit den Aktionen On success / On failure wie angegeben.
Häufige Probleme
- Sie können Operating system (CmdExec) nicht auswählen. Standardmäßig dürfen nur Mitglieder von sysadmin CmdExec-Schritte anlegen; andere brauchen ein CmdExec-Proxykonto (fragen Sie Ihren DBA).
- Der CmdExec-Schritt schlägt fehl, der T-SQL-Schritt war in Ordnung. Der Schritt läuft auf dem Datenbankserver unter dem Dienstkonto des SQL Server Agent (oder dem Proxy), nicht unter Ihrem Konto. Dieser Server muss die TaskBeacon-Adresse über HTTPS erreichen; führen Sie die curl-Zeile dort in einer Eingabeaufforderung aus, um zu sehen, was sie blockiert.
- curl.exe wird nicht gefunden. Es ist ab Windows Server 2019 enthalten. Auf einem älteren Server geben Sie den vollständigen Pfad zu einer dort abgelegten
curl.exean. - Die Benachrichtigung enthält keinen Fehlertext. Der Fehlerschritt sagt nur, dass der T-SQL-Schritt fehlschlug. Der Fehler selbst steht in SQL Server unter View History (Verlauf anzeigen) des Jobs.
Anwendungsfälle: Benachrichtigungen bei fehlgeschlagenen SQL-Server-Agent-Jobs ohne Database Mail. Weitere Fragen: FAQ.