Criar configurações de pacote

Você cria as configurações do pacote por meio da caixa de diálogo Organizador de Configurações do Pacote e do Assistente de Configuração de Pacotes. Para acessar essas ferramentas, clique em Configurações do Pacote no menu de SSIS em SSDT (SQL Server Data Tools).

Observação
Você também pode acessar o Organizador de Configuração de Pacote, clicando no botão de reticências ao lado da propriedade Configuração. A propriedade Configuração aparece na janela de propriedades para o pacote.

Observação

As configurações estão disponíveis para o modelo de implantação de pacote. Os parâmetros são usados no lugar das configurações para o modelo de implantação de projeto. O modelo de implantação de projeto permite que você implante projetos do Integration Services no servidor do Integration Services. Para obter mais informações sobre os modelos de implantação, consulte Implantação de projetos e pacotes.

Na caixa de diálogo Organizador de Configurações do Pacote, você pode habilitar pacotes para usar configurações, adicionar e excluir configurações e definir a ordem de preferência para carregar as configurações.

Observação

Quando as configurações de pacote são carregadas na ordem preferencial, elas são carregadas da parte superior da lista mostrada na caixa de diálogo Organizador de Configurações do Pacote até a parte inferior da lista. Porém, no tempo de execução, talvez as configurações do pacote não sejam carregadas na ordem preferencial. Em particular, as configurações do pacote pai são carregadas depois das configurações de outros tipos.

Observação
Se várias configurações definirem a mesma propriedade de objeto, o valor carregado por último será usado no tempo de execução.

Na caixa de diálogo Organizador de Configurações do Pacote, você executa o Assistente de Configuração de Pacotes, que o guia através de etapas para criar uma configuração. Para executar o Assistente de Configuração de Pacotes, adicione uma nova configuração na caixa de diálogo Organizador de Configurações do Pacote ou edite uma existente. Nas páginas do assistente, você escolhe o tipo de configuração, escolhe se quer acessar a configuração diretamente ou usar variáveis de ambiente, e seleciona as propriedades a serem salvas na configuração.

O exemplo a seguir mostra as propriedades de destino de uma variável e de um pacote, do modo como são mostradas na página Concluindo o Assistente, no Assistente de Configuração de Pacotes:

\Package.Variables[User::TodaysDate].Properties[RaiseChangedEvent]

\Package.Properties[MaximumErrorCount]

\Package.Properties[LoggingMode]

\Package.Properties[LocaleID]

\Package\My SQL Task.Variables[User::varTableName].Properties[Value]

Neste exemplo, a configuração atualiza estas propriedades:

• A propriedade RaiseChangedEvent da variável definida pelo usuário, TodaysDate.

• As propriedades MaximumErrorCount, LoggingMode, e LocaleID do pacote.

• A propriedade Value da variável definida pelo usuário, varTableName, dentro do escopo da tarefa, My SQL Task.

O "\Package" representa a raiz e pontos (.) separam os objetos que definem o caminho até a propriedade que a configuração atualiza. Os nomes das variáveis e das propriedades estão entre parênteses. O termo Package sempre é usado na configuração, independente do nome do pacote; porém, todos os outros objetos no caminho usam os nomes definidos pelo usuário.

Depois que o assistente terminar, a nova configuração é adicionada à lista de configurações na caixa de diálogo Organizador de Configurações do Pacote.

Observação

A última página do Assistente de Configuração de Pacote, Concluindo o Assistente, lista as propriedades de destino da configuração. Se você quiser atualizar as propriedades enquanto estiver executando pacotes usando o utilitário prompt de comando dtexec, poderá gerar as cadeias de caracteres que representam os caminhos de propriedade executando o Assistente de Configuração de Pacotes e, então, copiar e colá-las na janela do prompt de comando para usar com a opção definida de dtexec.

A tabela a seguir descreve as colunas da lista de configurações na caixa de diálogo Organizador de Configurações do Pacote.

Coluna	Descrição
Nome da Configuração	O nome da configuração.
Tipo de Configuração	O tipo de configuração.
Cadeia de Caracteres de Configuração	O local da configuração. O local pode ser um caminho, uma variável de ambiente, uma chave do Registro, um nome de variável do pacote pai ou uma tabela em um banco de dados do SQL Server.
Objeto de Destino	O nome do objeto com uma propriedade que tem uma configuração. Se a configuração for um arquivo de configuração XML, a coluna ficará em branco, devido à configuração poder atualizar vários objetos.
Propriedade de Destino	O nome da propriedade. Se a configuração gravar em um arquivo de configuração XML ou em uma tabela do SQL Server, a coluna ficará em branco, pois a configuração pode atualizar vários objetos.

Para criar uma configuração de pacote

1. No SSDT (SQL Server Data Tools), abra o projeto do Integration Services que contém o pacote desejado.

2. No Gerenciador de Soluções, clique duas vezes no pacote para abri-lo.

3. No Designer SSIS, clique na guia Fluxo de Controle, Fluxo de Dados, Manipulador de Eventos ou Explorador de Pacotes.

4. No menu SSIS , clique em Configurações do Pacote.

5. Na caixa de diálogo Organizador de Configurações do Pacote, selecione Habilitar configurações do pacote e clique em Adicionar.

6. Na página inicial da página Assistente de Configuração de Pacotes, clique em Avançar.

7. Na página Selecionar Tipo de Configuração, especifique o tipo de configuração e defina as propriedades pertinentes ao tipo de configuração. Para obter mais informações, consulte Referência da interface do usuário do Assistente de Configuração de Pacotes.

8. Na página Selecionar Propriedades a Serem Exportadas, selecione as propriedades dos objetos do pacote a serem incluídas na configuração. Se o tipo de configuração oferecer suporte somente a uma propriedade, o título dessa página de assistente será Selecionar Propriedade de Destino. Para obter mais informações, consulte Referência da interface do usuário do Assistente de Configuração de Pacotes.

   Observação
   Somente o Arquivo de Configuração XML e os tipos de configuração do SQL Server oferecem suporte a várias propriedades em uma configuração.

9. Na página Concluindo o Assistente, digite o nome da configuração e clique em Concluir.

10. Exiba a configuração na caixa de diálogo Organizador de Configurações do Pacote.

11. Clique em Fechar.

Recursos externos

• Artigo técnico de Noções básicas sobre configurações de pacotes do Integration Services, em msdn.microsoft.com

• Entrada de blog, Criando pacotes em código – Configurações de Pacote, em www.sqlis.com.

• Entrada de blog, Exemplo de API – Adicione programaticamente um arquivo de configuração a um pacote, em blogs.msdn.com.

Mantenha-se atualizado com o Integration Services Para obter os downloads, artigos, exemplos e vídeos mais recentes da Microsoft, bem como soluções selecionadas pela comunidade, visite a página do Integration Services no MSDN: Visite a página do Integration Services no MSDN Para receber uma notificação automática sobre essas atualizações, assine os feeds RSS disponíveis na página.

Consulte também

Conceitos

Configurações de pacote

Implantação de pacotes (SSIS)

Trabalhando com variáveis programaticamente