SQL Server Agent
実環境ではまだテストされていません。結果をお知らせください。コードはベンダーのドキュメントに沿って作成しています。support@taskbeacon.io までご連絡ください。
T-SQL は URL を呼び出せないため、ping はそれぞれ独立したジョブステップ(curl.exe を使う CmdExec)になります。
コード
これは Code(コード)タブが生成するコードです(開始とエラー にチェックを入れた状態)。アプリでは、あなたのジョブ専用のアドレスがすでに入っています。
-- 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.仕組み
別の CmdExec ステップが、T-SQL ステップの前に /start、成功した後にそのままのアドレス、失敗したときに /fail を ping します。Agent は終了コードもエラーテキストも行数も ping に渡しません。エラーそのものは SQL Server のジョブ履歴にあります。
一部を省きたい場合は、Code タブでオプションのチェックを外してください。報告できる内容もご覧ください。
スケジュールで実行する
SQL Server Management Studio で、SQL Server Agent → Jobs → 対象のジョブ → Properties → Schedules → New を選びます。毎日・毎週・毎月のいずれかと時刻を選び、TaskBeacon のジョブにも同じスケジュールを設定してください。上のステップを Steps にその順番で追加し、On success / On failure の動作は記載どおりにします。
よくある問題
- Operating system (CmdExec) を選べない。 既定では、CmdExec ステップを作成できるのは sysadmin のメンバーだけです。それ以外のユーザーには CmdExec プロキシ アカウントが必要です(DBA に相談してください)。
- T-SQL ステップは成功したのに、CmdExec ステップが失敗する。 このステップはあなたではなく、SQL Server Agent のサービス アカウント(またはプロキシ)としてデータベース サーバー上で実行されます。そのサーバーから HTTPS で TaskBeacon のアドレスに接続できる必要があります。何が妨げているかは、そのサーバーのコマンド プロンプトで curl の行を実行すると分かります。
- curl.exe が見つからない。 Windows Server 2019 以降には標準で入っています。古いサーバーでは、そこに置いた
curl.exeのフルパスを指定してください。 - アラートにエラーの本文がない。 失敗ステップは T-SQL ステップが失敗したことしか伝えません。エラーそのものは SQL Server のジョブの View History にあります。
ユースケース: Database Mail なしで SQL Server Agent ジョブの失敗アラートを受け取る。その他のご質問: FAQ