Compartilhar via


Definindo propriedades do pacote

Ao criar um pacote no Business Intelligence Development Studio usando a interface gráfica que o Integration Services fornece, 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

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 Usando pontos de verificação em pacotes.

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çãoObservaçã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 desta 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 nesta 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 Booleano 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 desta propriedade é False.

Identificação

As propriedades nesta 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 Usando expressões de propriedade em pacotes.

Propriedade

Descrição

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çãoObservaçã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 Usando expressões de propriedade em pacotes.

Para visualizar 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 Definindo o nível de proteção de pacotes.

Propriedade

Descrição

PackagePassword

A senha para os níveis de proteção do pacote (EncryptSensitiveWithPassword e EncryptAllWithPassword) que requerem 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 Incorporando transações em pacotes.

Propriedade

Descrição

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.

ObservaçãoObservação
O valor Snapshot da propriedade IsolationLevel é incompatível com transações de pacote. Assim, 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 é definido como Required.

O valor da propriedade IsolationLevel pedido 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 junta-se à transação de um contêiner pai.

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

  • O valor da propriedade TransactionOption do contêiner é 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.

Í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 RSS feeds disponíveis na página.

Histórico de alterações

Conteúdo atualizado

  • Atualizada a explicação dos valores na categoria Valor de Execução Forçada.

  • Explicado como a propriedade TransactionOption influencia se o valor da propriedade IsolationLevel pedida por um contêiner será ignorado ou não.

  • Uma observação que explica por que não é possível usar a propriedade IsolationLevel para definir uma transação de pacote como Snapshot foi adicionada