catalog.set_object_parameter_value (baza danych SSISDB)

Artykuł
2025-03-05

Dotyczy:sql Server SSIS Integration Runtime w usłudze Azure Data Factory

Ustawia wartość parametru w katalogu usług Integration Services. Kojarzy wartość ze zmienną środowiskową lub przypisuje wartość literału, która jest używana domyślnie, gdy nie przypisano żadnych innych wartości.

Składnia

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 ]

Argumenty

[@object_type =] object_type
Typ parametru. Użyj wartości 20, aby wskazać parametr projektu lub wartość 30 wskazać parametr pakietu. object_type jest smallInt.

[@folder_name =] folder_name
Nazwa folderu zawierającego parametr . folder_name to nvarchar(128).

[@project_name =] project_name
Nazwa projektu, który zawiera parametr . project_name jest nvarchar(128).

[@parameter_name =] parameter_name
Nazwa parametru. parameter_name to nvarchar(128).

[@parameter_value =] parameter_value
Wartość parametru. parameter_value jest sql_variant.

[@object_name =] object_name
Nazwa pakietu. Ten argument jest wymagany, gdy parametr jest parametrem pakietu. object_name to nvarchar(260).

[@value_type =] value_type
Typ wartości parametru. Użyj V znaku, aby wskazać, że parameter_value jest wartością literału używaną domyślnie, gdy żadne inne wartości nie są przypisane przed wykonaniem. Użyj R znaku, aby wskazać, że parameter_value jest wartością przywołyną i została ustawiona na nazwę zmiennej środowiskowej. Ten argument jest opcjonalny, V znaku jest używany domyślnie. value_type jest char(1).

Zwracana wartość kodu

0 (powodzenie)

Zestawy wyników

Żaden

Uprawnienia

Ta procedura składowana wymaga jednego z następujących uprawnień:

Uprawnienia DO ODCZYTU i MODYFIKOWANIA w projekcie
Członkostwo w roli bazy danych ssis_admin
Członkostwo w roli serwera sysadmin

Błędy i ostrzeżenia

Poniższa lista zawiera opis niektórych warunków, które mogą spowodować wystąpienie błędu procedury składowanej:

Typ parametru jest nieprawidłowy
Nazwa projektu jest nieprawidłowa
W przypadku parametrów pakietu nazwa pakietu jest nieprawidłowa
Typ wartości jest nieprawidłowy
Użytkownik nie ma odpowiednich uprawnień

Uwagi

Jeśli nie określono value_type, domyślnie jest używana wartość literału dla parameter_value. Gdy jest używana wartość literału, value_set w widoku object_parameters jest ustawiona na wartość 1. Wartość parametru NULL jest niedozwolona.
Jeśli value_type zawiera znak R, który oznacza wartość, do której odwołuje się odwołanie, parameter_value odnosi się do nazwy zmiennej środowiskowej.
Wartość 20 może służyć object_type do oznaczania parametru projektu. W takim przypadku wartość object_name nie jest konieczna, a każda wartość określona dla object_name jest ignorowana. Ta wartość jest używana, gdy użytkownik chce ustawić parametr projektu.
Wartość 30 może służyć object_type do oznaczania parametru pakietu. W tym przypadku wartość object_name jest używana do oznaczania odpowiedniego pakietu. Jeśli nie określono object_name, procedura składowana zwraca błąd i kończy działanie.

Udostępnij za pośrednictwem