Definir as propriedades do pacote
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
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. |
.gif "Observação") 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.
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.
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.
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.
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 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:
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. |
|
.gif "Ícone do Integration Services (pequeno)")
Permaneça atualizado com o Integration Services