catalog.set_execution_parameter_value (baza danych SSISDB)

Dotyczy:sql Server SSIS Integration Runtime w usłudze Azure Data Factory

Dotyczy:programu SQL Server

Ustawia wartość parametru dla wystąpienia wykonywania w katalogu usług Integration Services.

Nie można zmienić wartości parametru po uruchomieniu wystąpienia wykonania.

Składnia

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
Unikatowy identyfikator wystąpienia wykonania. execution_id jest bigint.

[ @object_type = ] object_type
Typ parametru.

W przypadku następujących parametrów ustaw wartość object_type na 50

• LOGGING_LEVEL

• CUSTOMIZED_LOGGING_LEVEL

• DUMP_ON_ERROR

• DUMP_ON_EVENT

• DUMP_EVENT_CODE

• CALLER_INFO

• SYNCHRONIZOWANE

Użyj wartości 20, aby wskazać parametr projektu lub wartość 30 wskazać parametr pakietu.

object_type jest smallint.

[ @parameter_name = ] parameter_name
Nazwa parametru. parameter_name to nvarchar(128).

[ @parameter_value = ] parameter_value
Wartość parametru. parameter_value jest sql_variant.

Uwagi

Aby dowiedzieć się, jakie wartości parametrów zostały użyte dla danego wykonania, wykonaj zapytanie w widoku catalog.execution_parameter_values.

Aby określić zakres informacji rejestrowanych podczas wykonywania pakietu, ustaw parameter_name na LOGGING_LEVEL i ustaw parameter_value na jedną z następujących wartości.

Ustaw parametr object_type na 50.

Wartość	Opis
0	Żaden Rejestrowanie jest wyłączone. Rejestrowany jest tylko stan wykonywania pakietu.
1	Podstawowy Wszystkie zdarzenia są rejestrowane, z wyjątkiem zdarzeń niestandardowych i diagnostycznych. Jest to wartość domyślna.
2	Wydajność Rejestrowane są tylko statystyki wydajności oraz zdarzenia OnError i OnWarning.
3	Gadatliwy Wszystkie zdarzenia są rejestrowane, w tym zdarzenia niestandardowe i diagnostyczne. Zdarzenia niestandardowe obejmują te zdarzenia, które są rejestrowane przez zadania usług Integration Services. Aby uzyskać więcej informacji, zobacz niestandardowe komunikaty na potrzeby rejestrowania
4	Pochodzenie środowiska uruchomieniowego Zbiera dane wymagane do śledzenia pochodzenia danych w przepływie danych.
100	Niestandardowy poziom rejestrowania Określ ustawienia w parametrze CUSTOMIZED_LOGGING_LEVEL. Aby uzyskać więcej informacji na temat wartości, które można określić, zobacz catalog.create_customized_logging_level. Aby uzyskać więcej informacji na temat dostosowanych poziomów rejestrowania, zobacz Enable Logging for Package Execution on the SSIS Server.

Aby określić, że serwer usług Integration Services generuje pliki zrzutu, gdy wystąpi błąd podczas wykonywania pakietu, ustaw następujące wartości parametrów dla wystąpienia wykonania, które nie zostało uruchomione.

Parametr	Wartość
execution_id	Unikatowy identyfikator wystąpienia wykonania
object_type	50
parameter_name	"DUMP_ON_ERROR
parameter_value	1

Aby określić, że serwer usług Integration Services generuje pliki zrzutu, gdy zdarzenia występują podczas wykonywania pakietu, ustaw następujące wartości parametrów dla wystąpienia wykonywania, które nie zostało uruchomione.

Parametr	Wartość
execution_id	Unikatowy identyfikator wystąpienia wykonania
object_type	50
parameter_name	"DUMP_ON_EVENT
parameter_value	1

Aby określić zdarzenia podczas wykonywania pakietu, które powodują, że serwer usług Integration Services wygeneruje pliki zrzutu, ustaw następujące wartości parametrów dla wystąpienia wykonania, które nie zostało uruchomione. Oddzielaj wiele kodów zdarzeń przy użyciu średnika.

Parametr	Wartość
execution_id	Unikatowy identyfikator wystąpienia wykonania
object_type	50
parameter_name	DUMP_EVENT_CODE
parameter_value	Co najmniej jeden kod zdarzenia

Przykłady

A. Generowanie plików zrzutu pod kątem błędów

W poniższym przykładzie określono, że serwer usług Integration Services generuje pliki zrzutu, gdy wystąpi błąd podczas wykonywania pakietu.

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. Generowanie plików zrzutu dla zdarzeń

W poniższym przykładzie określono, że serwer usług Integration Services generuje pliki zrzutu, gdy zdarzenia występują podczas wykonywania pakietu, i określa zdarzenie, które powoduje wygenerowanie plików przez serwer.

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  

Zwracana wartość kodu

0 (powodzenie)

Zestawy wyników

Żaden

Uprawnienia

Ta procedura składowana wymaga jednego z następujących uprawnień:

• Uprawnienia DO ODCZYTU i MODYFIKOWANIa w wystąpieniu wykonywania

• Członkostwo w roli bazy danych ssis_admin

• Członkostwo w roli serwera sysadmin

Błędy i ostrzeżenia

Na poniższej liście opisano niektóre warunki, które mogą zgłaszać błąd lub ostrzeżenie:

• Użytkownik nie ma odpowiednich uprawnień

• Identyfikator wykonywania jest nieprawidłowy

• Nazwa parametru jest nieprawidłowa

• Typ danych wartości parametru jest niezgodny z typem danych parametru

Zobacz też

catalog.execution_parameter_values (baza danych SSISDB)
generowanie plików zrzutu na potrzeby wykonywania pakietów