Definir as propriedades do pacote

Artigo
05/07/2013

Ao criar um pacote no SSDT (SQL Server Data Tools) usando a interface gráfica fornecida pelo Integration Services, você define as propriedades do objeto do pacote na janela Propriedades.

A janela Propriedades fornece uma lista de propriedades categorizada e alfabética. Para classificar a janela Propriedades por categoria, clique no ícone Categorizado.

Quando organizada por categoria, a janela Propriedades agrupa propriedades nas seguintes categorias:

Pontos de Verificação
Execução
Valor de Execução Forçada
Identificação
Diversos
Segurança
Transações
Versão

Para obter informações sobre as propriedades de pacote adicionais que você não pode definir na janela Propriedades, consulte Package.

Para definir as propriedades de pacote na janela Propriedades

Definir as propriedades de um pacote

Propriedades por Categoria

As tabelas a seguir listam as propriedades de pacote por categoria.

Pontos de Verificação

Você pode usar as propriedades nessa categoria para reiniciar o pacote a partir de um ponto de falha no fluxo de controle do pacote, em vez de executar novamente o pacote desde o começo de seu fluxo de controle. Para obter mais informações, consulte Reiniciar pacotes por meio de pontos de verificação.

Propriedade	Descrição
CheckpointFileName	O nome do arquivo que captura as informações do ponto de verificação que permite a reinicialização de um pacote. Quando o pacote é concluído com sucesso, este arquivo é excluído.
CheckpointUsage	Especifica quando um pacote pode ser reinicializado. Os valores são Never, IfExists e Always. O valor padrão dessa propriedade é Never, que indica que o pacote não pode ser reinicializado. Para obter mais informações, consulte DTSCheckpointUsage.
SaveCheckpoints	Especifica se os pontos de verificação são gravados no arquivo de ponto de verificação quando o pacote é executado. O valor padrão dessa propriedade é False.

Observação
A opção /CheckPointing on do dtexec é equivalente à configuração da propriedade SaveCheckpoints do pacote como True e da propriedade CheckpointUsage como Sempre. Para obter mais informações, consulte Utilitário dtexec.

Execução

As propriedades nesta categoria configuram o comportamento de tempo de execução do objeto de pacote.

Propriedade	Descrição
DelayValidation	Indica se a validação do pacote está adiada até que o pacote seja executado. O valor padrão para essa propriedade é False.
Disable	Indica se o pacote está desabilitado ou não. O valor padrão dessa propriedade é False.
DisableEventHandlers	Especifica se os manipuladores de eventos de pacote são executados. O valor padrão dessa propriedade é False.
FailPackageOnFailure	Especifica se o pacote falha caso ocorra um erro em um componente de pacote. O único valor válido dessa propriedade é False.
FailParentOnError	Especifica se o contêiner pai falha caso ocorra um erro em um contêiner filho. O valor padrão dessa propriedade é False.
MaxConcurrentExecutables	O número de arquivos executáveis que o pacote pode executar simultaneamente. O valor padrão dessa propriedade é -1 , que indica que não há nenhum limite.
MaximumErrorCount	O número máximo de erros que podem acontecer antes de um pacote parar de ser executado. O valor padrão dessa propriedade é 1.
PackagePriorityClass	A classe de prioridade de thread Win32 do thread de pacote. Os valores são Default, AboveNormal, Normal, BelowNormal, Idle. O valor padrão dessa propriedade é Default. Para obter mais informações, consulte DTSPriorityClass.

Valor de Execução Forçada

As propriedades dessa categoria configuram um valor de execução opcional para o pacote.

Propriedade	Descrição
ForcedExecutionValue	Se ForceExecutionValue estiver definido como True, um valor que especifica o valor de execução opcional que o pacote retorna. O valor padrão dessa propriedade é 0.
ForcedExecutionValueType	O tipo de dados de ForcedExecutionValue. O valor padrão dessa propriedade é Int32.
ForceExecutionValue	Um valor Booliano que especifica se o valor de execução opcional do contêiner deve ser forçado a conter um valor específico. O valor padrão dessa propriedade é False.

Identificação

As propriedades dessa categoria fornecem informações como o identificador exclusivo e o nome do pacote.

Propriedade	Descrição
CreationDate	A data em que o pacote foi criado.
CreatorComputerName	O nome do computador no qual o pacote foi criado.
CreatorName	O nome da pessoa que criou o pacote.
Description	Uma descrição da funcionalidade do pacote.
ID	O GUID do pacote, que é atribuído quando o pacote é criado. Esta propriedade é somente leitura. Para gerar um novo valor aleatório para a propriedade ID, selecione <Gerar Nova ID> na lista suspensa.
Name	O nome do pacote.
PackageType	O tipo do pacote. Os valores são Default, DTSDesigner, DTSDesigner100, DTSWizard, SQLDBMaint e SQLReplication. O valor padrão dessa propriedade é Default. Para obter mais informações, consulte DTSPackageType.

Diversos

As propriedades desta categoria são usadas para acessar as configurações e expressões que um pacote usa e para fornecer informações sobre a localidade e o modo de log do pacote. Para obter mais informações, consulte Usar expressões de propriedade em pacotes.

Configurations

A coleção de configurações que o pacote usa. Clique no botão procurar (…) para visualizar e configurar as configurações do pacote.

Expressions

Clique no botão procurar (...) para criar expressões para as propriedades do pacote.

Observação
Você pode criar expressões de propriedade para todas as propriedades do pacote que o modelo de objeto inclui, não apenas as propriedades exibidas na janela Propriedades.

Para obter mais informações, consulte Usar expressões de propriedade em pacotes.

Para exibir expressões de propriedade existentes, expanda Expressions. Clique o botão procurar (...) em uma caixa de texto de expressão para modificar e avaliar uma expressão.

ForceExecutionResult

O resultado de execução do pacote. Os valores são None, Success, Failure e Completion. O valor padrão dessa propriedade é None. Para obter mais informações, consulte T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult.

LocaleId

É uma localidade do Microsoft Win32. O valor padrão dessa propriedade é a localidade do sistema operacional no computador local.

LoggingMode

Um valor que especifica o comportamento de log do pacote. Os valores são Disabled, Enabled e UseParentSetting. O valor padrão dessa propriedade é UseParentSetting. Para obter mais informações, consulte DTSLoggingMode.

OfflineMode

Indica se o pacote está no modo offline. Esta propriedade é somente leitura. A propriedade é definida no nível de projeto. Geralmente, o Designer SSIS tenta se conectar a cada fonte de dados usada por seu próprio pacote para validar os metadados associados às fontes e aos destinos. Você pode habilitar Trabalhar Offline no menu SSIS , até mesmo antes de abrir um pacote, para evitar essas tentativas de conexão, e os erros de validação resultantes quando as fontes de dados não estão disponíveis. Você também pode habilitar a opção Trabalhar Offline para acelerar as operações no designer e a desabilitar apenas quando você desejar validar seu pacote.

SuppressConfigurationWarnings

Indica se os avisos gerados por configurações são suprimidos. O valor padrão dessa propriedade é False.

UpdateObjects

Indica se o pacote está atualizado para usar versões mais novas dos objetos que contém, se essas versões estiverem disponíveis. Por exemplo, se essa propriedade estiver definida como True, um pacote que inclua uma tarefa Inserção em Massa será atualizado para usar a versão mais nova da tarefa Inserção em Massa que o Integration Services fornece. O valor padrão dessa propriedade é False.

Segurança

As propriedades nesta categoria são usadas para definir o nível de proteção do pacote. Para obter mais informações, consulte Controle de acesso de dados confidenciais em pacotes.

Propriedade	Descrição
PackagePassword	A senha para os níveis de proteção do pacote (EncryptSensitiveWithPassword e EncryptAllWithPassword) que exigeem senhas.
ProtectionLevel	O nível de proteção do pacote. Os valores são DontSaveSensitive, EncryptSensitiveWithUserKey, EncryptSensitiveWithPassword, EncryptAllWithPassword e ServerStorage. O valor padrão dessa propriedade é EncryptSensitiveWithUserKey. Para obter mais informações, consulte DTSProtectionLevel.

Transações

As propriedades nesta categoria configuram o nível de isolamento e a opção de transação do pacote. Para obter mais informações, consulte Transações do Integration Services.

IsolationLevel

O nível de isolamento da transação do pacote. Os valores são Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializable e Snapshot. O valor padrão dessa propriedade é Serializable.

O valor Snapshot da propriedade IsolationLevel é incompatível com transações de pacote. Portanto, você não pode usar a propriedade IsolationLevel para definir o nível de isolamento das transações de pacote como Shapshot. Em vez disso, use uma consulta SQL para definir as transações de pacote como Snapshot. Para obter mais informações, consulte SET TRANSACTION ISOLATION LEVEL (Transact-SQL).

O sistema aplica a propriedade IsolationLevel às transações de pacote somente quando o valor da propriedade TransactionOption está definido como Required.

O valor da propriedade IsolationLevel solicitado por um contêiner filho é ignorado quando as seguintes condições forem verdadeiras:

O valor da propriedade TransactionOption do contêiner filho é Supported.
O contêiner filho une-se à transação de um contêiner pai.

O valor da propriedade IsolationLevel solicitada pelo contêiner é respeitado apenas quando o contêiner inicia uma nova transação. Um contêiner iniciará uma nova transação quando as seguintes condições forem verdadeiras:

O valor da propriedade TransactionOption do contêiner for Required.
O pai ainda não iniciou uma transação.

Para obter mais informações, consulte IsolationLevel.

TransactionOption

A participação transacional do pacote. Os valores são NotSupported, Supported e Required. O valor padrão dessa propriedade é Supported. Para obter mais informações, consulte DTSTransactionOption.

Versão

As propriedades nesta categoria fornecem informações sobre a versão do objeto de pacote.

Propriedade	Descrição
VersionBuild	O número de versão da criação do pacote.
VersionComments	Comentários sobre a versão do pacote.
VersionGUID	O GUID da versão do pacote. Esta propriedade é somente leitura.
VersionMajor	A versão principal mais recente do pacote.
VersionMinor	A versão secundária mais recente do pacote.

Permaneça 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 dessas atualizações, assine os RSS feeds disponíveis na página.

Share via