catalog.start_execution (SSISDB 資料庫)

  • 發行項

啟動在 Integration Services 目錄中的執行執行個體。

語法

start_execution [ @execution_id = ] execution_id

引數

  • [ @execution\_id = ] execution_id
    執行之執行個體的唯一識別碼。 execution_id 為 bigint。

備註

已使用執行來指定在封裝執行的單一執行個體期間，封裝將會使用的變數值。 建立執行執行個體之後，在該執行執行個體啟動之前，對應的專案可能已重新部署。 在這種情況下，執行執行個體將參考已過期的專案。 這將會造成預存程序失敗。

[!附註]

執行只能啟動一次。 若要啟動執行的執行個體，它必須處於已建立狀態 (catalog.operations 檢視之 status 資料行中的值為 1)。

範例

以下範例呼叫 catalog.create_execution 建立 Child1.dtsx 封裝執行之執行個體。 Integration Services Project1 包含此封裝。 本範例呼叫 catalog.set_execution_parameter_value 來設定 Parameter1、Parameter2 和 LOGGING_LEVEL 參數的值。 本範例將呼叫 catalog.start_execution 以啟動執行之執行個體。

Declare @execution_id bigint
EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Child1.dtsx', @execution_id=@execution_id OUTPUT, @folder_name=N'TestDeply4', @project_name=N'Integration Services Project1', @use32bitruntime=False, @reference_id=Null
Select @execution_id
DECLARE @var0 sql_variant = N'Child1.dtsx'
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=20, @parameter_name=N'Parameter1', @parameter_value=@var0
DECLARE @var1 sql_variant = N'Child2.dtsx'
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=20, @parameter_name=N'Parameter2', @parameter_value=@var1
DECLARE @var2 smallint = 1
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=50, @parameter_name=N'LOGGING_LEVEL', @parameter_value=@var2
EXEC [SSISDB].[catalog].[start_execution] @execution_id
GO

傳回碼值

0 (成功)

結果集

無

權限

這個預存程序需要下列其中一個權限：

  • 執行執行個體的 READ 和 MODIFY 權限、專案的 READ 和 EXECUTE 權限，以及 (如果適用的話) 參考環境的 READ 權限

  • ssis_admin 資料庫角色成員資格

  • sysadmin 伺服器角色成員資格

錯誤和警告

下列清單描述的是可能會引發錯誤或警告的某些條件：

  • 使用者未具備適當的權限

  • 執行識別碼無效

  • 執行已啟動或已完成；執行只能啟動一次

  • 與專案相關聯的環境參考無效

  • 未設定所需的參數值

  • 與執行執行個體相關聯的專案版本已過期；只能執行最新版本的專案