catalog.create_execution (SSISDB 資料庫)
在 Integration Services 目錄中建立執行的執行個體。
此預存程序會使用預設伺服器記錄層級。
語法
create_execution [ @folder_name = folder_name
, [ @project_name = ] project_name
, [ @package_name = ] package_name
[ , [ @reference_id = ] reference_id ]
[ , [ @use32bitruntime = ] use32bitruntime ]
, [ @execution_id = ] execution_id OUTPUT
引數
[ @folder\_name = ] folder_name
包含所要執行之封裝的資料夾名稱。 folder_name 為 nvarchar(128)。[ @project\_name = ] project_name
包含所要執行之封裝的專案名稱。 project_name 為 nvarchar(128)。[ @package\_name = ] package_name
要執行之封裝的名稱。 package_name 為 nvarchar(260)。[ @reference\_id = ] reference_id
環境參考的唯一識別碼。 這個參數是選擇性的。 reference_id 為 bigint。[@ use32bitruntime =] use32bitruntime
指出是否要使用 32 位元執行階段，在 64 位元作業系統上執行封裝。 使用 1 值，即可在執行 64 位元作業系統時執行 32 位元執行階段。 使用 0 值，即可在執行 64 位元作業系統時執行 64 位元執行階段。 這個參數是選擇性的。 Use32bitruntime 為 bit。[ @execution\_id = ] execution_id
傳回執行執行個體的唯一識別碼。 execution_id 為 bigint。
備註
執行是用以指定在封裝執行的單一執行個體期間，該封裝所使用的變數值。
如果使用 reference_id 參數指定了環境參考，則預存程序會將來自對應環境變數的常值或參考值填入專案和封裝參數。 如果指定了環境參考，封裝執行期間就會使用預設參數值。 若要精確地判斷哪些值會用於特定的執行執行個體，請使用來自這個預存程序的 execution_id 輸出參數值，並查詢 execution_parameter_values 檢視。
執行中只能夠指定標示為進入點的封裝。 如果封裝不是已指定的進入點，執行就會失敗。
範例
以下範例呼叫 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 與 EXECUTE 權限，以及 (如果適用的話) 參考環境的 READ 權限
ssis_admin 資料庫角色成員資格
sysadmin 伺服器角色成員資格
錯誤和警告
下列清單描述的是可能引發錯誤或警告的某些狀況：
封裝不存在。
使用者未具備適當的權限。
環境參考 reference_id 無效。
指定的封裝不是進入點封裝。
參考的環境變數其資料類型與專案或封裝參數的資料類型不同。
專案或封裝包含需要值的參數，但未指派任何值。
在環境參考 reference_id 所指定的環境中找不到參考的環境變數。