catalog.set_execution_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 pro instanci spuštění v katalogu integračních služeb.

Hodnotu parametru nelze změnit po spuštění instance.

Syntax

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

Argumenty

[ @execution_id = ] execution_id
Jedinečný identifikátor instance spuštění. execution_id je bigint.

[ @object_type = ] object_type
Typ parametru.

Pro následující parametry nastavte object_type na 50.

LOGGING_LEVEL
CUSTOMIZED_LOGGING_LEVEL
DUMP_ON_ERROR
DUMP_ON_EVENT
DUMP_EVENT_CODE
CALLER_INFO
SYNCHRONIZOVANÝ

Hodnotu 20 použijte k označení parametru projektu nebo hodnoty 30 k označení parametru balíčku.

object_type je malý.

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

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

Poznámky

Pokud chcete zjistit hodnoty parametrů, které se použily pro dané spuštění, zadejte dotaz na zobrazení catalog.execution_parameter_values.

Pokud chcete určit rozsah informací, které se protokolují během provádění balíčku, nastavte parameter_name na LOGGING_LEVEL a nastavte parameter_value na jednu z následujících hodnot.

Nastavte parametr object_type na 50.

Hodnota	Popis
0	Žádný Protokolování je vypnuté. Protokoluje se pouze stav spuštění balíčku.
1	Základní Všechny události se protokolují s výjimkou vlastních a diagnostických událostí. Toto je výchozí hodnota.
2	Představení Protokolují se pouze statistiky výkonu a události OnError a OnWarning.
3	Užvaněný Všechny události se protokolují, včetně vlastních a diagnostických událostí. Mezi vlastní události patří události, které jsou protokolovány úlohami integračních služeb. Další informace najdete v tématu vlastních zpráv pro protokolování
4	Rodokmen modulu runtime Shromažďuje data potřebná ke sledování rodokmenu v toku dat.
100	Vlastní úroveň protokolování Zadejte nastavení v parametru CUSTOMIZED_LOGGING_LEVEL. Další informace o zadaných hodnotách najdete v tématu catalog.create_customized_logging_level. Další informace o přizpůsobených úrovních protokolování naleznete v tématu Povolit protokolování pro spouštění balíčků na serveru SSIS.

Chcete-li určit, že server integrační služby generuje soubory výpisu paměti, pokud dojde k jakékoli chybě během provádění balíčku, nastavte následující hodnoty parametrů pro instanci spuštění, která se nespustí.

Parametr	Hodnota
execution_id	Jedinečný identifikátor instance spuštění
object_type	50
parameter_name	'DUMP_ON_ERROR
parameter_value	1

Chcete-li určit, že server integrační služby generuje soubory výpisu paměti při událostech během provádění balíčku, nastavte následující hodnoty parametrů pro instanci spuštění, která nebyla spuštěna.

Parametr	Hodnota
execution_id	Jedinečný identifikátor instance spuštění
object_type	50
parameter_name	'DUMP_ON_EVENT
parameter_value	1

Chcete-li určit události během provádění balíčku, které způsobují, že server integrační služby generuje soubory výpisu paměti, nastavte následující hodnoty parametrů pro instanci spuštění, která se nespustí. Oddělte více kódů událostí středníkem.

Parametr	Hodnota
execution_id	Jedinečný identifikátor instance spuštění
object_type	50
parameter_name	DUMP_EVENT_CODE
parameter_value	Jeden nebo více kódů událostí

Příklady

A. Generování souborů výpisu paměti pro chyby

Následující příklad určuje, že server integrační služby generuje soubory výpisu paměti, když dojde k jakékoli chybě během provádění balíčku.

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. Generování souborů s výpisem paměti pro události

Následující příklad určuje, že server integrační služby generuje soubory výpisu paměti při událostech během provádění balíčku a určuje událost, která způsobí, že server vygeneruje soubory.

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

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í READ a MODIFY pro instanci provádění
Č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 vyvolat chybu nebo upozornění:

Uživatel nemá příslušná oprávnění.
Identifikátor spuštění není platný.
Název parametru není platný.
Datový typ hodnoty parametru neodpovídá datovému typu parametru.

Viz také

catalog.execution_parameter_values (databáze SSISDB)
generování souborů s výpisem paměti pro spouštění balíčků

Sdílet prostřednictvím