catalog.set_object_parameter_value (SSISDB Database)

Artikel
2025-03-05

gäller för:SQL Server SSIS Integration Runtime i Azure Data Factory

gäller för:SQL Server

Anger värdet för en parameter i Integration Services-katalogen. Associerar värdet med en miljövariabel eller tilldelar ett literalvärde som används som standard när inga andra värden tilldelas.

Syntax

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 ]

Argument

[@object_type =] object_type
Typ av parameter. Använd värdet 20 för att ange en projektparameter eller värdet 30 för att ange en paketparameter. object_type är litenInt.

[@folder_name =] folder_name
Namnet på mappen som innehåller parametern. folder_name är nvarchar(128).

[@project_name =] project_name
Namnet på projektet som innehåller parametern. project_name är nvarchar(128).

[@parameter_name =] parameter_name
Namnet på parametern. parameter_name är nvarchar(128).

[@parameter_value =] parameter_value
Värdet för parametern. parameter_value är sql_variant.

[@object_name =] object_name
Namnet på paketet. Det här argumentet krävs när parametern är en paketparameter. object_name är nvarchar(260).

[@value_type =] value_type
Typ av parametervärde. Använd tecknet V för att ange att parameter_value är ett literalvärde som används som standard när inga andra värden tilldelas före körningen. Använd tecknet R för att ange att parameter_value är ett refererat värde och har angetts till namnet på en miljövariabel. Det här argumentet är valfritt, tecknet V används som standard. value_type är tecken(1).

Returnera kodvärde

0 (lyckades)

Resultatuppsättningar

Ingen

Behörigheter

Den här lagrade proceduren kräver någon av följande behörigheter:

LÄS- och ÄNDRA-behörigheter för projektet
Medlemskap i ssis_admin databasrollen
Medlemskap i serverrollen sysadmin

Fel och varningar

I följande lista beskrivs några villkor som kan orsaka att den lagrade proceduren skapar ett fel:

Parametertypen är inte giltig
Projektnamnet är inte giltigt
För paketparametrar är paketnamnet ogiltigt
Värdetypen är inte giltig
Användaren har inte rätt behörigheter

Anmärkningar

Om ingen value_type anges används ett literalvärde för parameter_value som standard. När ett literalvärde används anges value_set i vyn object_parameters till 1. Ett NULL-parametervärde tillåts inte.
Om value_type innehåller tecknet R, som anger ett refererat värde, refererar parameter_value till namnet på en miljövariabel.
Värdet 20 kan användas för object_type för att ange en projektparameter. I det här fallet är ett värde för object_name inte nödvändigt och alla värden som anges för object_name ignoreras. Det här värdet används när användaren vill ange en projektparameter.
Värdet 30 kan användas för object_type för att ange en paketparameter. I det här fallet används ett värde för object_name för att ange motsvarande paket. Om object_name inte anges returnerar den lagrade proceduren ett fel och avslutas.

Dela via