Parâmetros do Integration Services (SSIS)
Os parâmetros doIntegration Services (SSIS) permitem atribuir valores às propriedades nos pacotes em tempo de execução do pacote. Você pode criar parâmetros de projeto em nível de projeto e parâmetros de pacote em nível de pacote. Os parâmetros do projeto são usados para fornecer uma entrada externa que o projeto recebe para um ou mais pacotes no projeto. Os parâmetros do pacote permitem modificar a execução do pacote sem a necessidade de editar e reimplantar o pacote.
No SQL Server Data Tools , você cria, modifica ou exclui parâmetros de projeto usando a janela Project.params . Você cria, modifica e exclui parâmetros de pacote usando a guia Parâmetros no Designer do SSIS . Você associa um novo parâmetro ou um existente à propriedade de uma tarefa usando a caixa de diálogo Parametrizar . Para saber mais sobre como usar a janela Project.params e a guia Parâmetros , consulte Create Parameters. Para obter mais informações sobre a caixa de diálogo Parametrizar , consulte Parameterize Dialog Box.
Parâmetros e modelo de implantação de pacote
Em geral, se você estiver implantando um pacote usando o modelo de implantação de pacote, deverá usar configurações em vez de parâmetros.
Quando você implantar um pacote que contém parâmetros usando o modelo de implantação de pacote e, em seguida, executar o pacote, os parâmetros não serão chamados durante a execução. Se o pacote contiver parâmetros de pacote e as expressões dentro do pacote usarem os parâmetros, os valores resultantes serão aplicados em runtime. Se o pacote contiver parâmetros de projeto, a execução de pacote poderá falhar.
Parâmetros e modelo de implantação de projeto
Ao implantar um projeto no servidor do Integration Services, você usa exibições, procedimentos armazenados e a interface do usuário do SQL Server Management Studio para gerenciar parâmetros de projeto e pacote. Para obter mais informações, consulte os tópicos a seguir.
Valores dos parâmetros
Você pode atribuir até três tipos diferentes de valores a um parâmetro. Quando uma execução de pacote é iniciada, um único valor é usado para o parâmetro, o qual é resolvido para seu valor literal final.
A tabela a seguir lista os tipos de valores.
| Nome do valor | DESCRIÇÃO | Tipo de valor |
|---|---|---|
| Valor de execução | O valor que é atribuído a uma instância específica da execução do pacote. Essa atribuição substitui todos os outros valores, mas se aplica apenas a uma única instância de execução do pacote. | Literal |
| Valor do servidor | O valor atribuído ao parâmetro dentro do escopo do projeto, depois que o projeto é implantado no servidor do Integration Services. Esse valor substitui o padrão de design. | Literal ou referência de variável de ambiente |
| Valor do design | O valor atribuído ao parâmetro quando o projeto é criado ou editado no SQL Server Data Tools. Esse valor persiste com o projeto. | Literal |
Você pode usar um único parâmetro para atribuir um valor a várias propriedades de pacote. Uma única propriedade de pacote pode receber apenas um valor de um único parâmetro.
Execuções e valores de parâmetros
A execução é um objeto que representa uma única instância da execução do pacote. Ao criar uma execução, você especifica todos os detalhes necessários para executar um pacote, como os valores dos parâmetros de execução. Você também pode modificar os valores dos parâmetros para execuções existentes.
Quando você define explicitamente o valor de um parâmetro de execução, o valor é aplicável apenas àquela instância específica de execução. O valor de execução é usado em vez de um valor de servidor ou um valor de design. Se você não definir explicitamente um valor de execução, e um valor de servidor tiver sido especificado, o valor de servidor será usado.
Quando um parâmetro estiver marcado como obrigatório, um valor do servidor ou um valor da execução deverá ser especificado para esse parâmetro. Caso contrário, o pacote correspondente não será executado. Embora o parâmetro tenha um valor padrão em tempo de criação, ele nunca será usado assim que o projeto for implantado.
Variáveis de ambiente
Se um parâmetro fizer referência a uma variável de ambiente, o valor literal dessa variável será resolvido por meio da referência de ambiente especificada e aplicado ao parâmetro. O valor do parâmetro literal final que é usado para a execução do pacote é referenciado como o valor do parâmetro de execução. A referência de ambiente para uma execução é especificada usando a caixa de diálogo Executar
Se um parâmetro de projeto fizer referência a uma variável de ambiente e o valor literal da variável não puder ser resolvido na execução, o valor de design será usado. O valor de servidor não é usado.
Para exibir as variáveis de ambiente que são atribuídas a valores de parâmetros, consulte a exibição catalog.object_parameters. Para obter mais informações, confira catalog.object_parameters (Banco de dados SSISDB).
Determinando valores de parâmetros de execução
As seguintes exibições e procedimento armazenado Transact-SQL podem ser usados para exibir e definir valores de parâmetros.
catalog.execution_parameter_values (Banco de Dados SSISDB)(exibição)
Mostra os valores de parâmetros reais que serão usados por uma execução específica
catalog.get_parameter_values (Banco de dados SSISDB) (procedimento armazenado)
Resolve e mostra os valores reais do pacote especificado e da referência de ambiente
catalog.object_parameters (Banco de Dados SSISDB) (exibição)
Exibe os parâmetros e as propriedades para todos os pacotes e projetos no catálogo do Integration Services , inclusive o padrão do design e os valores padrão do servidor.
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 .
Você também pode usar a caixa de diálogo Executar Pacote no SQL Server Data Tools (SSDT) para modificar o valor do parâmetro. Para obter mais informações, consulte Execute Package Dialog Box.
Você também pode usar a opção /Parameter do dtexec para modificar um valor de parâmetro. Para saber mais, veja dtexec Utility.
Validação de parâmetro
Se não for possível resolver os valores dos parâmetros, haverá falha na execução do pacote correspondente. Para ajudar a evitar falhas, você pode validar projetos e pacotes usando a caixa de diálogo Validar em SQL Server Data Tools (SSDT). A validação permite confirmar se todos os parâmetros têm os valores necessários ou se os valores necessários podem ser resolvidos com referências de ambiente específicas. A validação também verifica outros problemas comuns de pacotes.
Para obter mais informações, consulte Validate Dialog Box.
Exemplo de parâmetro
Este exemplo descreve um parâmetro denominado pkgOptions que é usado para especificar opções para o pacote no qual reside.
Durante o tempo de design, quando o parâmetro foi criado no SQL Server Data Tools, um valor padrão de 1 foi atribuído ao parâmetro. Esse valor padrão é referenciado como o padrão de design. Se o projeto for implantado no catálogo do SSISDB e nenhum outro valor tiver sido atribuído a esse parâmetro, a propriedade do pacote correspondente ao parâmetro pkgOptions receberá o valor de 1 durante a execução do pacote. O padrão de design persiste com o projeto durante seu ciclo de vida.
Na preparação de uma instância específica de execução do pacote, um valor 5 é atribuído ao parâmetro pkgOptions . Esse valor é referenciado como o valor de execução porque ele se aplica ao parâmetro apenas para aquela instância de execução específica. Quando a execução é iniciada, a propriedade do pacote correspondente ao parâmetro pkgOptions recebe o valor de 5.
Related Tasks
Definir valores de parâmetro após a implantação do projeto
Conteúdo relacionado
Entrada de blog, o Dica Rápida do SSIS: parâmetros necessários, em mattmasson.com.