catalog.set_execution_parameter_value (SSISDB 資料庫)

  • 發行項

適用於：SQL Server Azure Data Factory 中的 SSIS Integration Runtime

適用於：SQL Server

為 Integration Services 目錄中執行之執行個體設定參數值。

執行的執行個體啟動之後，參數值就無法變更。

語法

catalog.set_execution_parameter_value [ @execution_id = execution_id  
    , [ @object_type = ] object_type  
    , [ @parameter_name = ] parameter_name  
    , [ @parameter_value = ] parameter_value

引數

[ @execution_id = ] execution_id
執行之執行個體的唯一識別碼。 execution_id 是 bigint。

[ @object_type = ] object_type
參數類型。

將下列參數的 object_type 設為 50

  • LOGGING_LEVEL

  • CUSTOMIZED_LOGGING_LEVEL

  • DUMP_ON_ERROR

  • DUMP_ON_EVENT

  • DUMP_EVENT_CODE

  • CALLER_INFO

  • SYNCHRONIZED

使用 20 值表示專案參數，或使用 30 值表示封裝參數。

object_type 是 smallint。

[ @parameter_name = ] parameter_name
參數名稱。 parameter_name 是 nvarchar(128)。

[ @parameter_value = ] parameter_value
參數的值。 parameter_value 是 sql_variant。

備註

若要找出用於給定執行的參數值，請查詢 catalog.execution_parameter_values 檢視。

若要指定套件執行期間所記錄的資訊範圍，請將 parameter_name 設為 LOGGING_LEVEL，並將 parameter_value 設為下列其中一個值。

將 object_type參數設為 50。

值 描述
0 無

關閉記錄功能。 只記錄封裝執行狀態。
1 基本

記錄所有事件，自訂和診斷事件除外。 這是預設值。
2 效能

只記錄效能統計資料，以及 OnError 和 OnWarning 事件。
3 「詳細資訊」

記錄所有事件，包括自訂和診斷事件。
自訂事件，包括 Integration Services 工作所記錄的那些事件。 如需詳細資訊，請參閱自訂訊息以進行記錄
4 執行階段歷程

收集追蹤資料流程中歷程所需的資料。
100 自訂記錄層次

指定 CUSTOMIZED_LOGGING_LEVEL 參數中的設定。 如需可指定值的詳細資訊，請參閱 catalog.create_customized_logging_level。

如需自訂記錄層次的詳細資訊，請參閱在 SSIS 伺服器上啟用套件執行的記錄功能。

若要指定 Integration Services 伺服器在套件執行期間發生任何錯誤時產生傾印檔案，請針對尚未執行之執行的執行個體，設定下列參數值。

參數 值
execution_id 執行的執行個體之唯一識別碼
object_type 50
parameter_name 'DUMP_ON_ERROR
parameter_value 1

若要指定 Integration Services 伺服器在套件執行期間發生事件時產生傾印檔案，請針對尚未執行的執行執行個體，設定下列參數值。

參數 值
execution_id 執行的執行個體之唯一識別碼
object_type 50
parameter_name 'DUMP_ON_EVENT
parameter_value 1

若要指定套件執行期間會導致 Integration Services 伺服器產生傾印檔案的事件，請針對尚未執行之執行的執行個體，設定下列參數值。 使用分號來分隔多個事件代碼。

參數 值
execution_id 執行的執行個體之唯一識別碼
object_type 50
parameter_name DUMP_EVENT_CODE
parameter_value 一個或多個事件代碼

範例

A. 產生錯誤的傾印檔案

下列範例指定 Integration Services 伺服器在封裝執行期間發生任何錯誤時產生傾印檔案。

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_ERROR',1

B. 產生事件的傾印檔案

下列範例指定 Integration Services 伺服器在封裝執行期間發生事件時產生傾印檔案，以及指定會導致伺服器產生檔案的事件。

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_EVENT',1  
  
declare @event_code nvarchar(50)  
set @event_code = '0xC020801C'  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_EVENT_CODE', @event_code

傳回碼值

0 (成功)

結果集

None

權限

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

  • 執行的執行個體之 READ 和 MODIFY 權限

  • ssis_admin 資料庫角色的成員資格

  • 系統管理員伺服器角色的成員資格

錯誤和警告

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

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

  • 執行識別碼無效

  • 參數名稱無效

  • 參數值的資料類型與參數的資料類型不相符

另請參閱

catalog.execution_parameter_values (SSISDB 資料庫)
產生套件執行的傾印檔案