catalog.set_object_parameter_value (SSISDB-database)

Artikel
2025-03-05

van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

van toepassing op:SQL Server-

Hiermee stelt u de waarde van een parameter in de Integration Services-catalogus in. Koppelt de waarde aan een omgevingsvariabele of wijst een letterlijke waarde toe die standaard wordt gebruikt wanneer er geen andere waarden worden toegewezen.

Syntaxis

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 ]

Argumenten

[@object_type =] object_type
Het type parameter. Gebruik de waarde 20 om een projectparameter of de waarde aan te geven 30 om een pakketparameter aan te geven. De object_type is smallInt.

[@folder_name =] folder_name
De naam van de map die de parameter bevat. De folder_name is nvarchar(128).

[@project_name =] project_name
De naam van het project dat de parameter bevat. De project_name is nvarchar(128).

[@parameter_name =] parameter_name
De naam van de parameter. De parameter_name is nvarchar(128).

[@parameter_value =] parameter_value
De waarde van de parameter. De parameter_value is sql_variant.

[@object_name =] object_name
De naam van het pakket. Dit argument is vereist wanneer de parameter een pakketparameter is. De object_name is nvarchar(260).

[@value_type =] value_type
Het type parameterwaarde. Gebruik het teken V om aan te geven dat parameter_value een letterlijke waarde is die standaard wordt gebruikt wanneer er geen andere waarden worden toegewezen vóór de uitvoering. Gebruik het teken R om aan te geven dat parameter_value een waarde waarnaar wordt verwezen en is ingesteld op de naam van een omgevingsvariabele. Dit argument is optioneel, het teken V wordt standaard gebruikt. De value_type is teken(1).

Retourcodewaarde

0 (geslaagd)

Resultatensets

Geen

Machtigingen

Voor deze opgeslagen procedure zijn een van de volgende machtigingen vereist:

Lees- en WIJZIGINGsmachtigingen voor het project
Lidmaatschap van de ssis_admin-databaserol
Lidmaatschap van de sysadmin serverfunctie

Fouten en waarschuwingen

In de volgende lijst worden enkele voorwaarden beschreven die ertoe kunnen leiden dat de opgeslagen procedure een fout genereert:

Het parametertype is ongeldig
De projectnaam is ongeldig
Voor pakketparameters is de pakketnaam ongeldig
Het waardetype is ongeldig
De gebruiker beschikt niet over de juiste machtigingen

Opmerkingen

Als er geen value_type is opgegeven, wordt standaard een letterlijke waarde voor parameter_value gebruikt. Wanneer een letterlijke waarde wordt gebruikt, wordt de value_set in de object_parameters weergave ingesteld op 1. Een NULL-parameterwaarde is niet toegestaan.
Als value_type het teken Rbevat, wat een waarde waarnaar wordt verwezen, verwijst parameter_value naar de naam van een omgevingsvariabele.
De waarde 20 kan worden gebruikt voor object_type om een projectparameter aan te geven. In dit geval is een waarde voor object_name niet nodig en wordt een waarde die is opgegeven voor object_name genegeerd. Deze waarde wordt gebruikt wanneer de gebruiker een projectparameter wil instellen.
De waarde 30 kan worden gebruikt voor object_type om een pakketparameter aan te geven. In dit geval wordt een waarde voor object_name gebruikt om het bijbehorende pakket aan te geven. Als object_name niet is opgegeven, retourneert de opgeslagen procedure een fout en wordt beëindigd.

Delen via