catalog.set_execution_parameter_value (Banco de Dados SSISDB)

se aplica a:SQL Server SSIS Integration Runtime no Azure Data Factory

Aplica-se a:SQL Server

Define o valor de um parâmetro para uma instância de execução no catálogo do Integration Services.

Um valor de parâmetro não pode ser alterado após o início de uma instância de execução.

Sintaxe

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

Argumentos

[ @execution_id = ] execution_id
O identificador exclusivo para a instância de execução. O execution_id é bigint.

[ @object_type = ] object_type
O tipo de parâmetro.

Para os seguintes parâmetros, defina object_type como 50

• LOGGING_LEVEL

• CUSTOMIZED_LOGGING_LEVEL

• DUMP_ON_ERROR

• DUMP_ON_EVENT

• DUMP_EVENT_CODE

• CALLER_INFO

• SINCRONIZADO

Use o valor 20 para indicar um parâmetro de projeto ou o valor 30 para indicar um parâmetro de pacote.

O object_type é pequeno.

[ @parameter_name = ] parameter_name
O nome do parâmetro. O parameter_name é nvarchar(128).

[ @parameter_value = ] parameter_value
O valor do parâmetro. O parameter_value é sql_variant.

Comentários

Para descobrir os valores de parâmetro que foram usados para uma determinada execução, consulte a visualização catalog.execution_parameter_values.

Para especificar o escopo das informações que são registradas durante a execução de um pacote, defina parameter_name como LOGGING_LEVEL e defina parameter_value para um dos seguintes valores.

Defina o parâmetro object_type como 50.

Valor	Descrição
0	Nenhum O registo está desativado. Somente o status de execução do pacote é registrado.
1	Básico Todos os eventos são registrados, exceto eventos personalizados e de diagnóstico. Este é o valor padrão.
2	Desempenho Somente as estatísticas de desempenho e os eventos OnError e OnWarning são registrados.
3	Verbose Todos os eventos são registrados, incluindo eventos personalizados e de diagnóstico. Os eventos personalizados incluem os eventos registrados por tarefas do Integration Services. Para obter mais informações, consulte mensagens personalizadas para registro em log
4	Linhagem de tempo de execução Coleta os dados necessários para rastrear a linhagem no fluxo de dados.
100	Nível de registo personalizado Especifique as configurações no parâmetro CUSTOMIZED_LOGGING_LEVEL. Para obter mais informações sobre os valores que você pode especificar, consulte catalog.create_customized_logging_level. Para obter mais informações sobre níveis de log personalizados, consulte Habilitar o log para execução de pacotes no Servidor SSIS.

Para especificar que o servidor do Integration Services gera arquivos de despejo quando ocorre qualquer erro durante a execução de um pacote, defina os seguintes valores de parâmetro para uma instância de execução que não foi executada.

Parâmetro	Valor
execution_id	O identificador único para a instância de execução
object_type	50
parameter_name	«DUMP_ON_ERROR
parameter_value	1

Para especificar que o servidor do Integration Services gera arquivos de despejo quando ocorrem eventos durante a execução de um pacote, defina os seguintes valores de parâmetro para uma instância de execução que não foi executada.

Parâmetro	Valor
execution_id	O identificador único para a instância de execução
object_type	50
parameter_name	«DUMP_ON_EVENT
parameter_value	1

Para especificar os eventos durante a execução do pacote que fazem com que o servidor do Integration Services gere arquivos de despejo, defina os seguintes valores de parâmetro para uma instância de execução que não foi executada. Separe vários códigos de evento usando um ponto-e-vírgula.

Parâmetro	Valor
execution_id	O identificador único para a instância de execução
object_type	50
parameter_name	DUMP_EVENT_CODE
parameter_value	Um ou mais códigos de evento

Exemplos

Um. Gerar arquivos de despejo para erros

O exemplo a seguir especifica que o servidor do Integration Services gera arquivos de despejo quando ocorre qualquer erro durante a execução de um pacote.

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. Gerar arquivos de despejo para eventos

O exemplo a seguir especifica que o servidor Integration Services gera arquivos de despejo quando ocorrem eventos durante a execução de um pacote e especifica o evento que faz com que o servidor gere os arquivos.

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  

Valor do código de retorno

0 (sucesso)

Conjuntos de resultados

Nenhum

Permissões

Este procedimento armazenado requer uma das seguintes permissões:

• Permissões LER e MODIFICAR na instância de execução

• Associação à função de banco de dados ssis_admin

• Associação à função de servidor sysadmin

Erros e Avisos

A lista a seguir descreve algumas condições que podem gerar um erro ou aviso:

• O usuário não tem as permissões apropriadas

• O identificador de execução não é válido

• O nome do parâmetro não é válido

• O tipo de dados do valor do parâmetro não corresponde ao tipo de dados do parâmetro

Ver também

catalog.execution_parameter_values (Banco de Dados SSISDB)
Gerando arquivos de despejo para execução de pacotes