Definir propriedades do pacote
se aplica a:
SQL Server SSIS Integration Runtime no Azure Data Factory
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 de pacote na janela Propriedades.
A janela Propriedades fornece uma lista categorizada e alfabética de propriedades. Para organizar a janela de propriedades por categoria, clique no ícone Categoria.
Quando organizadas por categoria, a janela Propriedades
Para obter informações sobre propriedades adicionais do pacote que não podem ser definidas na janela Propriedades, consulte Package.
Para definir as propriedades do pacote na janela Propriedades
Propriedades por Categoria
As tabelas a seguir listam as propriedades do pacote por categoria.
Pontos de verificação
Você pode usar as propriedades nesta 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 início de seu fluxo de controle. Para obter mais informações, consulte Reiniciar Pacotes Usando Pontos de Verificação.
| Propriedade | Descrição |
|---|---|
| CheckpointFileName | O nome do arquivo que captura as informações de ponto de verificação que permitem que um pacote seja reiniciado. Quando o pacote é concluído com êxito, esse arquivo é excluído. |
| CheckpointUsage | Especifica quando um pacote pode ser reiniciado. Os valores são Nunca, IfExistse Sempre. O valor padrão dessa propriedade é Never, que indica que o pacote não pode ser reiniciado. Para obter mais informações, consulte DTSCheckpointUsage. |
| SalvarPontosDeVerificação | 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
O /CheckPointing na opção de dtexec é equivalente a definir a propriedade SaveCheckpoints do pacote como Verdadeiro e a propriedade CheckpointUsage como Sempre. Para obter mais informações, consulte dtexec Utility.
Execução
As propriedades nesta categoria configuram o comportamento em tempo de execução do objeto do pacote.
| Propriedade | Descrição |
|---|---|
| AtrasoValidação | Indica se a validação do pacote está atrasada até que o pacote seja executado. O valor padrão para essa propriedade é False. |
| Desativar | Indica se o pacote está desativado. O valor padrão dessa propriedade é False. |
| DisableEventHandlers | Especifica se os manipuladores de eventos do pacote são executados. O valor padrão dessa propriedade é False. |
| FailPackageOnFailure | Especifica se o pacote falhará se ocorrer um erro em um componente do pacote. O único valor válido desta propriedade é False. |
| FailParentOnError | Especifica se o contêiner pai falhará se ocorrer um erro em um contêiner filho. O valor padrão desta propriedade é False. |
| MaxConcurrentExecutables | O número de arquivos executáveis que o pacote pode executar simultaneamente. O valor padrão dessa propriedade é -1, o que indica que não há limite. |
| ContagemMáximaDeErros | O número máximo de erros que podem ocorrer antes que um pacote pare de ser executado. O valor padrão dessa propriedade é 1. |
| ClasseDePrioridadeDoPacote | A classe de prioridade de thread Win32 do thread do pacote. Os valores são Padrão, Acima do Normal, Normal, Abaixo do Normal, Ocioso. O valor padrão dessa propriedade é Default. Para obter mais informações, consulte DTSPriorityClass. |
Valor de execução compulsória
As propriedades nesta categoria configuram um valor de execução opcional para o pacote.
| Propriedade | Descrição |
|---|---|
| ValorDeExecuçãoForçada | 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. |
| TipoDeValorDeExecuçãoForçada | 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 dessa propriedade é False. |
Identificação
As propriedades nesta categoria fornecem informações como o identificador exclusivo e o nome do pacote.
| Propriedade | Descrição |
|---|---|
| Data de Criação | 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. Esta propriedade é somente leitura. Para gerar um novo valor aleatório para a propriedade ID, selecione <Gerar Novo ID> na lista suspensa. |
| Nome | O nome do pacote. |
| TipoDePacote | O tipo de 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 nesta 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 Uso de 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 visualizar 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 que o modelo de objeto inclui, não apenas as propriedades listadas na janela Propriedades. Para obter mais informações, consulte Utilizar expressões de propriedade em pacotes. Para exibir expressões de propriedade existentes, expanda Expressões. Clique no botão procurar (...) numa caixa de expressões para modificar e avaliar uma expressão. |
| ForçarResultadoExecução | O resultado da execução do pacote. Os valores são Nenhum, Sucesso, Falhae Conclusão. O valor padrão dessa propriedade é Nenhum. Para obter mais informações, consulte T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult. |
| LocaleId | Um locale do Microsoft Win32. O valor padrão dessa propriedade é a localidade do sistema operacional no computador local. |
| Modo de Registo | Um valor que especifica o comportamento de log do pacote. Os valores são Desativado, Ativadoe UsarConfiguraçãoParental. O valor padrão dessa propriedade é UseParentSetting. Para obter mais informações, consulte DTSLoggingMode. |
| ModoOffline | Indica se o pacote está no modo offline. Esta propriedade é somente leitura. A propriedade é definida no nível do projeto. Normalmente, o Designer SSIS tenta se conectar a cada fonte de dados usada pelo seu pacote para validar os metadados associados a fontes e destinos. Você pode habilitar Trabalhar Offline no menu SSIS, 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 estiverem disponíveis. Você também pode habilitar Trabalhar Offline para acelerar as operações no designer e desativá-lo somente quando quiser que seu pacote seja validado. |
| SuppressConfigurationWarnings | Indica se os avisos gerados pelas configurações são suprimidos. O valor padrão dessa propriedade é False. |
| UpdateObjects | Indica se o pacote é atualizado para usar versões mais recentes dos objetos que ele contém, se versões mais recentes 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 recente 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 Controle de Acesso para Dados Confidenciais em Pacotes.
| Propriedade | Descrição |
|---|---|
| PackagePassword | A palavra-passe para os níveis de proteção do pacote (EncryptSensitiveWithPassword e EncryptAllWithPassword) que exigem palavras-passe. |
| Nível de Proteção | O nível de proteção da embalagem. Os valores são NãoGuardarSensível, EncriptarSensívelComChaveDeUtilizador, EncriptarSensívelComPalavraPasse, EncriptarTudoComPalavraPassee ArmazenamentoNoServidor. 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 |
|---|---|
| Nível de Isolamento | O nível de isolamento da transação do pacote. Os valores são Não especificado, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializablee Snapshot. O valor padrão dessa propriedade é Serializable. Nota: O valor Snapshot da propriedade IsolationLevel é incompatível com transações de pacotes. Portanto, não é possível usar a propriedade IsolationLevel para definir o nível de isolamento das transações de pacote como Snapshot. Em vez disso, use uma consulta SQL para definir 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 é 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 ingressa na transação de um contêiner pai. O valor da propriedade IsolationLevel solicitada pelo contentor é respeitado somente quando o contentor 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. |
| OpçãoDeTransação | A participação transacional do pacote. Os valores são Não Suportado, Suportado, Necessário. 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 |
|---|---|
| VersãoConstrução | O número da versão da compilação do pacote. |
| Versão Comentários | Comentários sobre a versão do pacote. |
| VersionGUID | O GUID da versão do pacote. Esta propriedade é somente leitura. |
| VersionMajor | A última versão principal do pacote. |
| VersionMinor | A última versão menor do pacote. |
Definir propriedades do pacote na janela Propriedades
No SSDT (SQL Server Data Tools), abra o projeto 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 SSIS ou clique com o botão direito do mouse e selecione Exibir Designer .
Clique na guia Fluxo de Controle e siga um destes procedimentos:
Clique com o botão direito do mouse em qualquer lugar no plano de fundo da superfície de design do fluxo de controle e clique em Propriedades.
No menu Exibir, clique em janela de Propriedades.
Edite as propriedades do pacote na janela Propriedades do .
No menu Arquivo, clique em Salvar Itens Selecionados para salvar o pacote atualizado.