Criar parâmetros

Use o SSDT (SQL Server Data Tools) para criar parâmetros de projeto e parâmetros de pacote. Os procedimentos a seguir fornecem instruções passo a passo para criar parâmetros de pacote/projeto.

Observação
Se você estiver convertendo um projeto criado com o uso de uma versão anterior do Integration Services no modelo de implantação de projeto, use o Assistente de Conversão de Projeto do Integration Services para criar parâmetros com base em configurações. Para obter mais informações, consulte Implantar projetos no Servidor do Integration Services.

Para criar parâmetros de pacote

1. Abra o pacote no SQL Server Data Tools e clique na guia Parâmetros no SSIS Designer.

   

2. Clique no botão Adicionar Parâmetro na barra de ferramentas.

   

3. Insira valores para as propriedades Nome, Tipo de Dados, Valor, Diferencia e Obrigatório na própria lista ou na janela Propriedades. A tabela a seguir descreve essas propriedades.

   Propriedade	Descrição
   Nome	O nome do parâmetro.
   Tipo de dados	O tipo de dados do parâmetro.
   Valor padrão	O valor padrão do parâmetro atribuído em tempo de design. Também conhecido como o padrão de design.
   Diferencia	Valores de parâmetros confidenciais são criptografados no catálogo e aparecem como um valor NULL quando exibidos com o Transact-SQL ou o SQL Server Management Studio.
   Obrigatório	Exige que um valor diferente do padrão de design seja especificado para que o pacote possa ser executado.
   Descrição	Para fins de manutenção, a descrição do parâmetro. No SSDT (SQL Server Data Tools), defina a descrição do parâmetro na janela Propriedades do Visual Studio quando o parâmetro for selecionado na janela de parâmetros aplicável.

   Observação
   Quando você implanta um projeto no catálogo, várias propriedades adicionais são associadas ao projeto. Para consultar todas as propriedades de todos os parâmetros do catálogo, use a exibição catalog.object_parameters (Banco de Dados SSISDB).

4. Salve o projeto para salvar as alterações nos parâmetros. Valores de parâmetros são armazenados no arquivo de projeto.

   Cuidado
   Você pode editar no local na lista ou usar a janela Propriedades para modificar os valores de propriedades de parâmetro. Você pode excluir um parâmetro usando o botão da barra de ferramentas Excluir (X). Usando o último botão da barra de ferramentas, você pode especificar um valor para um parâmetro que só seja usado quando você executar o pacote no SQL Server Data Tools.

   Observação
   Se você reabrir o arquivo de pacote sem abrir o projeto no SQL Server Data Tools, a guia Parâmetros estará vazia e desabilitada.

Para criar os parâmetros do projeto

1. Abra o projeto no SQL Server Data Tools.

2. Clique com o botão direito em Project.params no Gerenciador de Soluções e clique em Abrir (OU) clique duas vezes em Project.params para abri-lo.

   

3. Clique no botão Adicionar Parâmetro na barra de ferramentas.

   

4. Insira valores para as propriedades Nome, Tipo de Dados, Valor, Diferencia e Obrigatório.

   Propriedade	Descrição
   Nome	O nome do parâmetro.
   Tipo de dados	O tipo de dados do parâmetro.
   Valor padrão	O valor padrão do parâmetro atribuído em tempo de design. Também conhecido como o padrão de design.
   Diferencia	Valores de parâmetros confidenciais são criptografados no catálogo e aparecem como um valor NULL quando exibidos com o Transact-SQL ou o SQL Server Management Studio.
   Obrigatório	Exige que um valor diferente do padrão de design seja especificado para que o pacote possa ser executado.
   Descrição	Para fins de manutenção, a descrição do parâmetro. No SQL Server Data Tools, defina a descrição do parâmetro na janela Propriedades do Visual Studio quando o parâmetro for selecionado na janela de parâmetros aplicável.

5. Salve o projeto para salvar as alterações nos parâmetros. O valores de parâmetros são armazenados em configurações no arquivo de projeto. Salve o arquivo de projeto para confirmar em disco as alterações nos valores de parâmetros.

   Cuidado

   Você pode editar no local na lista ou usar a janela Propriedades para modificar os valores de propriedades de parâmetro. Você pode excluir um parâmetro usando o botão da barra de ferramentas Excluir (X). Usando o último botão da barra de ferramentas para abrir Gerenciar Valores de Parâmetro, você pode especificar um valor para um parâmetro que só seja usado quando você executar o pacote no SQL Server Data Tools.

Consulte também

Conceitos

Parâmetros do Integration Services (SSIS)