Definir as propriedades do pacote
Aplica-se a:
SQL Server SSIS Integration Runtime no Azure Data Factory
Ao criar um pacote no SQL Server Data Tools (SSDT) 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:
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 saber mais, confira Restart Packages by Using Checkpoints.
| 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, IfExistse 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 de dtexec equivale a definir a propriedade SaveCheckpoints do pacote como True, e a propriedade CheckpointUsage como Always. Para saber mais, veja dtexec Utility.
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 desta 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 | Caso ForceExecutionValue esteja 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. |
| Descrição | Uma descrição da funcionalidade do pacote. |
| ID | O GUID do pacote, que é atribuído quando o pacote é criado. Essa propriedade é somente leitura. Para gerar um novo valor aleatório para a propriedade ID, selecione <Gerar Nova ID> na lista suspensa. |
| Nome | O nome do pacote. |
| PackageType | O tipo do pacote. Os valores são Default, DTSDesigner, DTSDesigner100, DTSWizard, SQLDBMainte 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 |
|---|---|
| Configurações | A coleção de configurações que o pacote usa. Clique no botão Procurar (…) para exibir e configurar as configurações do pacote. |
| Expressões | Clique no botão Procurar (…) para criar expressões para as propriedades do pacote. Observe que você pode criar expressões de propriedade para todas as propriedades do pacote incluídas pelo modelo de objeto, 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 no 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, Failuree 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, Enablede UseParentSetting. O valor padrão dessa propriedade é UseParentSetting. Para obter mais informações, consulte DTSLoggingMode. |
| OfflineMode | Indica se o pacote está no modo offline. Essa 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 inclui uma tarefa Inserção em Massa será atualizado para usar a versão mais nova da tarefa Inserção em Massa fornecida pelo Integration Services . 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 Access Control for Sensitive Data in Packages.
| Propriedade | DESCRIÇÃO |
|---|---|
| PackagePassword | A senha para níveis de proteção do pacote (EncryptSensitiveWithPassword e EncryptAllWithPassword) que exige senhas. |
| ProtectionLevel | O nível de proteção do pacote. Os valores são DontSaveSensitive, EncryptSensitiveWithUserKey, EncryptSensitiveWithPassword, EncryptAllWithPassworde ServerStorage. O valor padrão dessa propriedade é EncryptSensitiveWithUserKey. Para obter mais informações, consulte DTSProtectionLevel. |
Transactions
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, Serializablee Snapshot. O valor padrão dessa propriedade é Serializable. Observação: 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, confira 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, Supportede 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. Essa propriedade é somente leitura. |
| VersionMajor | A versão principal mais recente do pacote. |
| VersionMinor | A versão secundária mais recente do pacote. |
Definir as propriedades do pacote na janela Propriedades
No SQL Server Data Tools (SSDT), abra o projeto do Integration Services que contém o pacote que você deseja configurar.
No Gerenciador de Soluções, clique duas vezes no pacote para abri-lo no Designer do SSIS ou clique com o botão direito do mouse e selecione Designer de Exibição.
Clique na guia Fluxo de Controle e escolha uma das seguintes opções:
Clique com o botão direito do mouse em qualquer lugar da tela de fundo da superfície de design do fluxo de controle e clique em Propriedades.
No menu Exibir , clique em Janela Propriedades.
Edite as propriedades do pacote na janela Propriedades .
No menu Arquivo , clique em Salvar Itens Selecionados para salvar o pacote atualizado.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de