catalog.set_execution_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 för en körningsinstans i katalogen Integration Services.

Det går inte att ändra ett parametervärde när en instans av körningen har startats.

Syntax

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

Argument

[ @execution_id = ] execution_id
Den unika identifieraren för körningsinstansen. execution_id är bigint.

[ @object_type = ] object_type
Typ av parameter.

För följande parametrar anger du object_type till 50

LOGGING_LEVEL
CUSTOMIZED_LOGGING_LEVEL
DUMP_ON_ERROR
DUMP_ON_EVENT
DUMP_EVENT_CODE
CALLER_INFO
SYNKRONISERAS

Använd värdet 20 för att ange en projektparameter eller värdet 30 för att ange en paketparameter.

object_type är smallint.

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

Anmärkningar

Om du vill ta reda på parametervärdena som användes för en viss körning frågar du catalog.execution_parameter_values vy.

Om du vill ange omfånget för information som loggas under en paketkörning anger du parameter_name till LOGGING_LEVEL och anger parameter_value till något av följande värden.

Ange parametern object_type till 50.

Värde	Beskrivning
0	Ingen Loggning är inaktiverat. Endast paketkörningsstatusen loggas.
1	Grundläggande Alla händelser loggas, förutom anpassade och diagnostiska händelser. Det här är standardvärdet.
2	Föreställning Endast prestandastatistik och OnError- och OnWarning-händelser loggas.
3	Mångordig Alla händelser loggas, inklusive anpassade och diagnostiska händelser. Anpassade händelser inkluderar de händelser som loggas av Integration Services-uppgifter. Mer information finns i anpassade meddelanden för loggning
4	Körnings härkomst Samlar in de data som krävs för att spåra ursprung i dataflödet.
100	Anpassad loggningsnivå Ange inställningarna i parametern CUSTOMIZED_LOGGING_LEVEL. Mer information om de värden som du kan ange finns i catalog.create_customized_logging_level. Mer information om anpassade loggningsnivåer finns i Aktivera loggning för paketkörning på SSIS Server-.

Ange att Integration Services-servern genererar dumpfiler när ett fel inträffar under en paketkörning genom att ange följande parametervärden för en körningsinstans som inte har körts.

Parameter	Värde
execution_id	Den unika identifieraren för körningsinstansen
object_type	50
parameter_name	"DUMP_ON_ERROR
parameter_value	1

Ange att Integration Services-servern genererar dumpfiler när händelser inträffar under en paketkörning genom att ange följande parametervärden för en körningsinstans som inte har körts.

Parameter	Värde
execution_id	Den unika identifieraren för körningsinstansen
object_type	50
parameter_name	"DUMP_ON_EVENT
parameter_value	1

Om du vill ange de händelser under paketkörningen som gör att Integration Services-servern genererar dumpfiler anger du följande parametervärden för en körningsinstans som inte har körts. Avgränsa flera händelsekoder med ett semikolon.

Parameter	Värde
execution_id	Den unika identifieraren för körningsinstansen
object_type	50
parameter_name	DUMP_EVENT_CODE
parameter_value	En eller flera händelsekoder

Exempel

A. Generera dumpfiler för fel

I följande exempel anges att Integration Services-servern genererar dumpfiler när ett fel inträffar under en paketkörning.

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. Generera dumpfiler för händelser

I följande exempel anges att Integration Services-servern genererar dumpfiler när händelser inträffar under en paketkörning och anger den händelse som gör att servern genererar filerna.

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

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 körningsinstansen
Medlemskap i ssis_admin databasrollen
Medlemskap i serverrollen sysadmin

Fel och varningar

I följande lista beskrivs vissa villkor som kan orsaka ett fel eller en varning:

Användaren har inte rätt behörigheter
Körningsidentifieraren är ogiltig
Parameternamnet är ogiltigt
Datatypen för parametervärdet matchar inte parameterns datatyp

Se även

catalog.execution_parameter_values (SSISDB Database)
Generera dumpfiler för paketkörning

Dela via