catalog.set_execution_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 voor een exemplaar van uitvoering in de Integration Services-catalogus.

Een parameterwaarde kan niet worden gewijzigd nadat een exemplaar van uitvoering is gestart.

Syntaxis

catalog.set_execution_parameter_value [ @execution_id = execution_id  
    , [ @object_type = ] object_type  
    , [ @parameter_name = ] parameter_name  
    , [ @parameter_value = ] parameter_value

Argumenten

[ @execution_id = ] execution_id
De unieke id voor het exemplaar van uitvoering. De execution_id is grote.

[ @object_type = ] object_type
Het type parameter.

Stel voor de volgende parameters object_type in op 50

LOGGING_LEVEL
CUSTOMIZED_LOGGING_LEVEL
DUMP_ON_ERROR
DUMP_ON_EVENT
DUMP_EVENT_CODE
CALLER_INFO
GESYNCHRONISEERD

Gebruik de waarde 20 om een projectparameter of de waarde aan te geven 30 om een pakketparameter aan te geven.

De object_type is kleine.

[ @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.

Opmerkingen

Als u de parameterwaarden wilt achterhalen die zijn gebruikt voor een bepaalde uitvoering, voert u een query uit op de catalog.execution_parameter_values weergave.

Als u het bereik wilt opgeven van informatie die wordt geregistreerd tijdens het uitvoeren van een pakket, stelt u parameter_name in op LOGGING_LEVEL en stelt u parameter_value in op een van de volgende waarden.

Stel de parameter object_type in op 50.

Waarde	Beschrijving
0	Geen Logboekregistratie is uitgeschakeld. Alleen de uitvoeringsstatus van het pakket wordt geregistreerd.
1	Basisch Alle gebeurtenissen worden geregistreerd, behalve aangepaste en diagnostische gebeurtenissen. Dit is de standaardwaarde.
2	Voorstelling Alleen prestatiestatistieken en OnError- en OnWarning-gebeurtenissen worden vastgelegd.
3	Breedsprakig Alle gebeurtenissen worden geregistreerd, inclusief aangepaste en diagnostische gebeurtenissen. Aangepaste gebeurtenissen omvatten die gebeurtenissen die worden geregistreerd door Integration Services-taken. Zie Aangepaste berichten voor logboekregistratie voor meer informatie
4	Runtimeherkomst Verzamelt de gegevens die nodig zijn om herkomst in de gegevensstroom bij te houden.
100	Aangepast niveau voor logboekregistratie Geef de instellingen op in de parameter CUSTOMIZED_LOGGING_LEVEL. Zie catalog.create_customized_logging_levelvoor meer informatie over de waarden die u kunt opgeven. Zie Logboekregistratie inschakelen voor pakketuitvoering op de SSIS-servervoor meer informatie over aangepaste logboekregistratieniveaus.

Als u wilt opgeven dat de Integration Services-server dumpbestanden genereert wanneer er een fout optreedt tijdens het uitvoeren van een pakket, stelt u de volgende parameterwaarden in voor een uitvoeringsexemplaren die niet zijn uitgevoerd.

Parameter	Waarde
execution_id	De unieke id voor het exemplaar van uitvoering
object_type	50
parameter_name	'DUMP_ON_ERROR
parameter_value	1

Als u wilt opgeven dat de Integration Services-server dumpbestanden genereert wanneer er gebeurtenissen optreden tijdens het uitvoeren van een pakket, stelt u de volgende parameterwaarden in voor een uitvoeringsexemplaren die niet zijn uitgevoerd.

Parameter	Waarde
execution_id	De unieke id voor het exemplaar van uitvoering
object_type	50
parameter_name	'DUMP_ON_EVENT
parameter_value	1

Als u de gebeurtenissen tijdens de uitvoering van het pakket wilt opgeven waardoor de Integration Services-server dumpbestanden genereert, stelt u de volgende parameterwaarden in voor een uitvoeringsexemplaren die niet zijn uitgevoerd. Scheid meerdere gebeurteniscodes met behulp van een puntkomma.

Parameter	Waarde
execution_id	De unieke id voor het exemplaar van uitvoering
object_type	50
parameter_name	DUMP_EVENT_CODE
parameter_value	Een of meer gebeurteniscodes

Voorbeelden

Een. Dumpbestanden genereren voor fouten

In het volgende voorbeeld wordt aangegeven dat de Integration Services-server dumpbestanden genereert wanneer er een fout optreedt tijdens het uitvoeren van een pakket.

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_ERROR',1

B. Dumpbestanden genereren voor gebeurtenissen

In het volgende voorbeeld wordt aangegeven dat de Integration Services-server dumpbestanden genereert wanneer gebeurtenissen optreden tijdens het uitvoeren van een pakket en geeft de gebeurtenis op die ervoor zorgt dat de server de bestanden genereert.

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_EVENT',1  
  
declare @event_code nvarchar(50)  
set @event_code = '0xC020801C'  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_EVENT_CODE', @event_code

Retourcodewaarde

0 (geslaagd)

Resultatensets

Geen

Machtigingen

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

LEES- en WIJZIGINGsmachtigingen voor het exemplaar van uitvoering
Lidmaatschap van de ssis_admin-databaserol
Lidmaatschap van de sysadmin serverfunctie

Fouten en waarschuwingen

In de volgende lijst worden enkele voorwaarden beschreven die een fout of waarschuwing kunnen veroorzaken:

De gebruiker beschikt niet over de juiste machtigingen
De uitvoerings-id is ongeldig
De parameternaam is ongeldig
Het gegevenstype van de parameterwaarde komt niet overeen met het gegevenstype van de parameter

Zie ook

catalog.execution_parameter_values (SSISDB-database)
dumpbestanden genereren voor pakketuitvoering

Delen via