catalog.set_execution_parameter_value (Banco de Dados SSISDB)
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
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
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 |
Básica Todos os eventos são registrados em log, menos personalizados e de diagnóstico. Este é 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. |
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 |
Exemplo
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
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 erros ou avisos:
O usuário não tem as permissões adequadas
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
Referência
catalog.execution_parameter_values (Banco de Dados SSISDB)