Compartilhar via

catalog.set_execution_parameter_value (Banco de Dados SSISDB)

  • Artigo

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

Aplica-se: 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 da execução da instância.

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 da instância de execução. O execution_id é bigint.

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

Para os parâmetros a seguir, defina object_type como 50

  • LOGGING_LEVEL

  • CUSTOMIZED_LOGGING_LEVEL

  • DUMP_ON_ERROR

  • DUMP_ON_EVENT

  • DUMP_EVENT_CODE

  • CALLER_INFO

  • SYNCHRONIZED

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 é smallint.

[ @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âmetros que foram usados para uma determinada execução, consulte a exibição catalog.execution_parameter_values.

Para especificar o escopo das informações registradas em log durante uma execução de pacote, defina parameter_name como LOGGING_LEVEL e parameter_value como um dos valores a seguir.

Defina o parâmetro object_type como 50.

Valor Descrição
0 Nenhum

O log está desativado. Apenas o status da execução do pacote é registrado em log.
1 Basic

Todos os eventos são registrados em log, menos personalizados e de diagnóstico. Esse é o valor padrão.
2 Desempenho

Apenas estatísticas de desempenho e eventos OnError e OnWarning são registrados em log.
3 Detalhado

Todos os eventos são registrados em log, inclusive eventos personalizados e de diagnóstico.
Eventos personalizados incluem os que são registrados em log por meio de tarefas do Integration Services. Para obter mais informações, consulte Custom Messages for Logging (Mensagens personalizadas para criação de log)
4 Linhagem de runtime

Coleta os dados necessários para rastrear a linhagem no fluxo de dados.
100 Nível de registro em log 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, veja Habilitar o log para a execução do pacote 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 valores dos parâmetros a seguir para uma instância de execução que não foi executada.

Parâmetro Valor
execution_id O identificador exclusivo da 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 valores dos parâmetros a seguir para uma instância de execução que não foi executada.

Parâmetro Valor
execution_id O identificador exclusivo da instância de execução
object_type 50
parameter_name 'DUMP_ON_EVENT
parameter_value 1

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

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

Exemplos

a. Gerar arquivos de despejo para erros

O exemplo a seguir especifica que o servidor do Integration Services gera arquivos de despejo quando ocorre um 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 do 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 (êxito)

Conjuntos de resultados

Nenhum

Permissões

Este procedimento armazenado exige uma das seguintes permissões:

  • Permissões READ e MODIFY 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 um aviso:

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

  • O identificador da 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

Consulte Também

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