Criando configurações do pacote

Você cria as configurações do pacote usando a caixa de diálogo Organizador de Configurações do Pacote e o Assistente de Configuração de Pacotes. Para acessar essas ferramentas, clique em Configurações do Pacote no menu de SSIS em Business Intelligence Development Studio.

Observação
Para se familiazar melhor com os conceitos explicados nesta seção, consulte Tutorial: Implantando pacotes e Lição 3: Adicionando configurações de pacote do Tutorial: Criando um pacote ETL simples.

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.

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.

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. Os exemplos seguintes mostram 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]

As configurações atualizam as 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 do pacote

• Como adicionar uma configuração de pacote

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.

• Ferramenta, Editor de arquivo de configuração de pacote, em codeplex.com.

Fique atualizado com o Integration Services Para obter os downloads, artigos, exemplos e vídeos da Microsoft mais recentes, bem como soluções selecionadas da 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 RSS feeds disponíveis na página.

Consulte também

Conceitos

Configurações de pacotes do SSIS

Implantação de pacotes (Integration Services)

Trabalhando com variáveis programaticamente