Partilhar via


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çãoObservaçã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çãoObservaçã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çãoObservaçã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 os 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çãoObservaçã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

Ícone do Integration Services (pequeno) Fique atualizado com o Integration Services

Para obter os mais recentes downloads, artigos, exemplos e vídeos da Microsoft, bem como soluções selecionadas da comunidade, visite a página Integration Services no MSDN ou TechNet:

Para receber uma notificação automática das atualizações, assine os feeds RSS disponíveis na página.