sp_add_job (Transact-SQL)

  • 文章

適用於：SQL ServerAzure SQL 受控執行個體

建立 SQL Server Agent 服務所執行的新作業。

Transact-SQL 語法慣例

重要

Azure SQL 受控執行個體目前支援多數 (但非全部) 的 SQL Server Agent 功能。 如需詳細資料，請參閱 Azure SQL 受控執行個體與 SQL Server 之間的 T-SQL 差異。

語法

sp_add_job 
         [ @job_name = ] N'job_name'
     [ , [ @enabled = ] enabled ]
     [ , [ @description = ] N'description' ]
     [ , [ @start_step_id = ] step_id ]
     [ , [ @category_name = ] 'category' ]
     [ , [ @category_id = ] category_id ]
     [ , [ @owner_login_name = ] 'login' ]
     [ , [ @notify_level_eventlog = ] eventlog_level ]
     [ , [ @notify_level_email = ] email_level ]
     [ , [ @notify_level_netsend = ] netsend_level ]
     [ , [ @notify_level_page = ] page_level ]
     [ , [ @notify_email_operator_name = ] 'email_name' ]
     [ , [ @notify_netsend_operator_name = ] 'netsend_name' ]
     [ , [ @notify_page_operator_name = ] 'page_name' ]
     [ , [ @delete_level = ] delete_level ]
     [ , [ @job_id = ] job_id OUTPUT ]
[ ; ]

引數

@job_name

作業的名稱。 名稱必須是唯一的，且不能包含百分比 （%） 字元。 @job_name為 nvarchar（128），沒有預設值。 必要。

@enabled

指出已新增作業的狀態。 enabled 是 tinyint，預設值 1 為 （enabled）。 如果 0為 ，則作業未啟用，且未根據其排程執行;不過，可以手動執行。

@description

這是作業的描述。 @description為 nvarchar（512），預設值為 NULL。 如果 省略@description ， N'No description available' 則會使用 。

@start_step_id

要針對作業執行之第一個步驟的標識碼。 @start_step_id為 int，預設值為 1。

@category_name

作業的類別。 @category_name為 sysname，預設值為 NULL。

@category_id

指定作業類別目錄的語言無關機制。 @category_id為 int，預設值為 NULL。

@owner_login_name

擁有作業的登入名稱。 @owner_login_name為 sysname，預設值NULL為 ，其解譯為目前的登入名稱。 只有系統管理員固定伺服器角色的成員可以設定或變更@owner_login_name的值。 如果使用者不是系統管理員角色集的成員，或變更@owner_login_name的值，則執行此預存程式會失敗，並傳回錯誤。

@notify_level_eventlog

值，指出何時將專案放在此作業的 Microsoft Windows 應用程式記錄中。 @notify_level_eventlog為 int，而且可以是下列其中一個值：

值 描述
0 永不
1 成功時
2 (預設值) 失敗時
3 永遠

@notify_level_email

值，指出完成此作業時傳送電子郵件的時機。 @notify_level_email 為 int，預設值0為 ，表示永不。 @notify_level_email使用與@notify_level_eventlog相同的值。

@notify_level_netsend

值，指出完成此作業時傳送網路訊息的時機。 @notify_level_netsend為 int，預設值為 0，表示永不。 @notify_level_netsend使用與@notify_level_eventlog相同的值。

@notify_level_page

值，指出完成此作業時傳送頁面的時機。 @notify_level_page為 int，預設值0為 ，表示永不。 @notify_level_page使用與@notify_level_eventlog相同的值。

@notify_email_operator_name

到達@notify_email_operator_name時要傳送電子郵件的人員電子郵件名稱。 @notify_email_operator_name為 sysname，預設值為 NULL。

@notify_netsend_operator_name

完成此作業時，傳送網路訊息的操作員名稱。 @notify_netsend_operator_name為 sysname，預設值為 NULL。

@notify_page_operator_name

完成此作業時要分頁的人員名稱。 @notify_page_operator_name為 sysname，預設值為 NULL。

@delete_level

值，指出刪除作業的時機。 delete_value為 int，預設值為 0，這表示永不。 @delete_level使用與@notify_level_eventlog相同的值。

注意

當 @delete_level 為3時，不論為作業定義的任何排程為何，作業只會執行一次。 此外，如果作業自行刪除，作業的所有歷程記錄也會一併刪除。

@job_id 輸出

作業建立成功時，指派給作業的作業識別碼。 @job_id是 uniqueidentifier 類型的輸出變數，預設值為 NULL。

傳回碼值

0 （成功）或 1 （失敗）。

結果集

無。

備註

@originating_server存在於 中，但未列在 sp_add_job[自變數] 底下。 @originating_server保留供內部使用。

執行作業以新增作業之後 sp_add_job ， sp_add_jobstep 可用來新增執行作業活動的步驟。 sp_add_jobschedule 可用來建立 SQL Server Agent 服務用來執行作業的排程。

使用 sp_add_jobserver 來設定執行作業的 SQL Server 實例，以及 sp_delete_jobserver 從 SQL Server 實例中移除作業。 如果作業在多伺服器環境中的一或多個目標伺服器上執行，請使用 sp_apply_job_to_targets 來設定作業的目標伺服器或目標伺服器群組。 若要從目標伺服器或目標伺服器群組中移除作業，請使用 sp_remove_job_from_targets。 Azure SQL 受控執行個體 不支援多伺服器 管理員 製化 #MSX/TSX 功能。

SQL Server Management Studio 提供易用的作業管理圖形介面，是建立及管理作業基礎結構的建議方式。

此預存程式會與 Azure SQL 資料庫 的 Azure 彈性作業服務類似物件共享 的名稱sp_add_job。 如需彈性作業版本的相關信息，請參閱 jobs.sp_add_job （Azure Elastic Jobs） （Transact-SQL） 。

權限

此預存程式是由 db_owner 角色所擁有。 您可以授與 EXECUTE 任何用戶的許可權，但這些許可權可能會在 SQL Server 升級期間覆寫。

其他用戶必須在資料庫中獲得下列其中一個 SQL Server Agent 固定資料庫角色 msdb ：

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

如需這些角色權限的詳細資訊，請參閱 SQL Server Agent 固定資料庫角色。

只有系統管理員固定伺服器角色的成員可以設定或變更@owner_login_name的值。 如果使用者不是系統管理員角色集的成員，或變更@owner_login_name的值，則執行此預存程式會失敗，並傳回錯誤。

範例

A. 新增作業

這個範例會新增名為 NightlyBackups的新作業。

USE msdb;
GO

EXEC dbo.sp_add_job @job_name = N'NightlyBackups';
GO

B. 新增具有呼叫器、電子郵件和 net send 資訊的作業

此範例會建立名為 Ad hoc Sales Data Backup 的作業，以在作業失敗時通知 François Ajenstat （依呼叫器、電子郵件或網路快顯訊息），並在成功完成時刪除作業。

注意

此範例假設名為 François Ajenstat 的運算符和名為 的 françoisa 登入已經存在。

USE msdb;
GO

EXEC dbo.sp_add_job
    @job_name = N'Ad hoc Sales Data Backup',
    @enabled = 1,
    @description = N'Ad hoc backup of sales data',
    @owner_login_name = N'françoisa',
    @notify_level_eventlog = 2,
    @notify_level_email = 2,
    @notify_level_netsend = 2,
    @notify_level_page = 2,
    @notify_email_operator_name = N'François Ajenstat',
    @notify_netsend_operator_name = N'François Ajenstat',
    @notify_page_operator_name = N'François Ajenstat',
    @delete_level = 1;
GO

相關內容