catalog.set_object_parameter_value (databáze SSISDB)

Článek
2025-03-05

platí pro:SQL Server SSIS Integration Runtime ve službě Azure Data Factory

platí pro:SQL Server

Nastaví hodnotu parametru v katalogu integračních služeb. Přidruží hodnotu k proměnné prostředí nebo přiřadí literálovou hodnotu, která se použije ve výchozím nastavení, pokud nejsou přiřazeny žádné jiné hodnoty.

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 ]

Argumenty

[@object_type =] object_type
Typ parametru. Hodnotu 20 použijte k označení parametru projektu nebo hodnoty 30 k označení parametru balíčku. object_type je smallInt.

[@folder_name =] folder_name
Název složky, která obsahuje parametr. folder_name je nvarchar(128).

[@project_name =] project_name
Název projektu, který obsahuje parametr. project_name je nvarchar(128).

[@parameter_name =] parameter_name
Název parametru. parameter_name je nvarchar(128).

[@parameter_value =] parameter_value
Hodnota parametru. parameter_value je sql_variant.

[@object_name =] object_name
Název balíčku. Tento argument se vyžaduje, pokud je parametrem balíčku. object_name je nvarchar(260).

[@value_type =] value_type
Typ hodnoty parametru. Pomocí znaku V označte, že parameter_value je hodnota literálu, která se ve výchozím nastavení používá, pokud před spuštěním nejsou přiřazeny žádné jiné hodnoty. Pomocí znaku R označte, že parameter_value je odkazovaná hodnota a byla nastavena na název proměnné prostředí. Tento argument je nepovinný, znak V se používá ve výchozím nastavení. value_type je znak(1).

Návratová hodnota kódu

0 (úspěch)

Sady výsledků

Žádný

Dovolení

Tato uložená procedura vyžaduje jedno z následujících oprávnění:

Oprávnění KE ČTENÍ a ÚPRAVě projektu
Členství v roli databáze ssis_admin
Členství v roli serveru správce systému

Chyby a upozornění

Následující seznam popisuje některé podmínky, které mohou způsobit, že uložená procedura vyvolá chybu:

Typ parametru není platný.
Název projektu není platný.
U parametrů balíčku není název balíčku platný.
Typ hodnoty není platný.
Uživatel nemá příslušná oprávnění.

Poznámky

Pokud není zadán žádný value_type, použije se ve výchozím nastavení hodnota literálu pro parameter_value. Při použití hodnoty literálu je value_set v zobrazení object_parameters nastavena na 1. Hodnota parametru NULL není povolená.
Pokud value_type obsahuje znak R, který označuje odkazovanou hodnotu, parameter_value odkazuje na název proměnné prostředí.
Hodnotu 20 lze použít pro object_type k označení parametru projektu. V tomto případě není nutná hodnota object_name a jakákoli hodnota zadaná pro object_name se ignoruje. Tato hodnota se používá, když chce uživatel nastavit parametr projektu.
Hodnotu 30 lze použít k označení parametru balíčku object_type. V tomto případě se k označení odpovídajícího balíčku použije hodnota object_name. Pokud není zadán object_name, uložená procedura vrátí chybu a ukončí se.

Sdílet prostřednictvím