catalog.set_execution_parameter_value (SSISDB 資料庫)

  • 發行項

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

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

語法

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

    • 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

Basic

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

2

Performance

只記錄效能統計資料，以及 OnError 和 OnWarning 事件。

3

Verbose

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

若要指定 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

一個或多個事件代碼

範例

下列範例指定 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

下列範例指定 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 (成功)

結果集

無

權限

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

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

  • ssis_admin 資料庫角色成員資格

  • sysadmin 伺服器角色成員資格

錯誤和警告

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

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

  • 執行識別碼無效

  • 參數名稱無效

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

請參閱

參考

catalog.execution_parameter_values (SSISDB 資料庫)

概念

產生封裝執行的傾印檔案