catalog.set_object_parameter_value (SSISDB 資料庫)

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

適用於：SQL Server

設定 Integration Services 目錄中參數的值。 將值與環境變數建立關聯，或指派常值，在沒有指派其他值時預設會使用此常值。

語法

catalog.set_object_parameter_value [ @object_type = ] object_type   
    , [ @folder_name = ] folder_name   
    , [ @project_name = ] project_name   
    , [ @parameter_name = ] parameter_name   
    , [ @parameter_value = ] parameter_value   
 [  , [ @object_name = ] object_name ]  
 [  , [ @value_type = ] value_type ]  

引數

[@object_type =] object_type
參數類型。 使用 20 值表示專案參數，或使用 30 值表示封裝參數。 object_type 是 smallInt。

[@folder_name =] folder_name
包含參數之資料夾的名稱。 folder_name 是 nvarchar(128) 。

[@project_name =] project_name
包含參數之專案的名稱。 project_name 是 nvarchar(128) 。

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

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

[@object_name =] object_name
封裝名稱。 參數為封裝參數時，就需要這個引數。 object_name 是 nvarchar(260)。

[@value_type =] value_type
參數值的類型。 使用字元 V 表示如果執行前沒有指派任何值，就會預設使用常值 parameter_value。 使用字元 R 表示 parameter_value 這個參考值已設定為環境變數的名稱。 這是選擇性引數，根據預設，會使用字元 V。 value_type 是 char(1)。

傳回碼值

0 (成功)

結果集

None

權限

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

• 專案的 READ 和 MODIFY 權限

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

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

錯誤和警告

下列清單將描述可能會造成預存程序引發錯誤的某些條件：

• 參數類型無效

• 專案名稱無效

• 封裝名稱對封裝參數來說無效

• 值類型無效

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

備註

• 如果沒有指定 value_type，預設會使用 parameter_value 的常值。 使用常值時，object_parameters 檢視中的 value_set 會設定為 1。 不允許 NULL 參數值。

• 如果 value_type 包含字元 R (表示受參考的值)，parameter_value 就會參考環境變數的名稱。

• object_type 可以使用 20 值表示專案參數。 在這個情況下，就不需要 object_name 的值，而且為 object_name 指定的任何值都會遭到忽略。 當使用者想要設定專案參數時，可以使用這個值。

• object_type 可以使用 30 值表示套件參數。 在這個情況下，object_name 的值會用來表示對應的套件。 如果未指定 object_name，則預存程序會傳回錯誤並結束。