Compartilhar via


Contêineres do Integration Services

Aplica-se a: SQL Server SSIS Integration Runtime no Azure Data Factory

Contêineres são objetos do SQL Server Integration Services que fornecem estrutura a pacotes e serviços a tarefas. Eles fornecem suporte à repetição de fluxos de controle em pacotes e agrupam tarefas e contêineres em unidades de trabalho significativas. Os contêineres podem incluir outros contêineres, além de tarefas.

Os pacotes usam contêineres para os propósitos a seguir:

  • Repetição de tarefas para cada elemento em uma coleção, como arquivos em uma pasta, esquemas ou objetos no SQL Server Management Objects (SMO). Por exemplo, um pacote pode executar instruções Transact-SQL que residem em arquivos múltiplos.

  • Repita as tarefas até que uma expressão especificada seja avaliada como false. Por exemplo, um pacote pode enviar uma mensagem diferente de email sete vezes, uma vez para cada dia da semana.

  • Agrupar tarefas e contêineres que precisam ter êxito ou falhar como uma unidade. Por exemplo, um pacote pode agrupar tarefas que excluem e somam linhas em uma tabela de banco de dados, e então confirmar ou reverter todas as tarefas quando uma apresentar falha.

Tipos de contêineres

Integration Services fornece quatro tipos de contêineres para criar pacotes. A tabela a seguir lista os tipos de contêineres.

Contêiner Descrição
Contêiner Loop Foreach Executa um fluxo de controle repetidamente usando um enumerador.
Contêiner Loop For Executa um fluxo de controle repetidamente testando uma condição.
Contêiner de sequência Agrupa tarefas e contêineres em fluxos de controle que são subconjuntos do fluxo de controle de pacote.
Contêiner Host da Tarefa Fornece serviços a uma única tarefa.

Pacotes e manipuladores de eventos também são tipos de contêineres. Para obter informações, confira Pacotes do Integration Services (SSIS) e Manipuladores de Eventos do Integration Services (SSIS).

Resumo das propriedades dos contêineres

Todos os tipos de contêineres têm um conjunto de propriedades em comum. Se você criar pacotes que usam as ferramentas gráficas fornecidas pelo Integration Services , a janela Propriedades listará as propriedades a seguir dos contêineres Foreach Loop, Loop For e Sequence. As propriedades do contêiner host da tarefa são configuradas como parte da configuração da tarefa que o host da tarefa encapsula. Você define as propriedades Host da Tarefa quando configura a tarefa.

Propriedade DESCRIÇÃO
DelayValidation Um valor booliano que indica se a validação do contêiner foi adiada até o tempo de execução. O valor padrão para essa propriedade é False.

Para obter mais informações, consulte DelayValidation.
Descrição É a descrição do contêiner. A propriedade contém uma cadeia de caracteres, mas pode estar em branco.

Para obter mais informações, consulte Description.
Disable Um valor booliano que indica se o contêiner é executado. O valor padrão para essa propriedade é False.

Para obter mais informações, consulte Disable.
DisableEventHandlers Um valor booliano que indica se os manipuladores de eventos estão associados à execução do contêiner. O valor padrão para essa propriedade é False.
FailPackageOnFailure Um valor booliano que especifica se o pacote irá falhar se ocorrer um erro no contêiner. O valor padrão para essa propriedade é False.

Para obter mais informações, consulte FailPackageOnFailure.
FailParentOnFailure Um valor booliano que especifica se o contêiner pai irá falhar se ocorrer um erro no contêiner. O valor padrão para essa propriedade é False.

Para obter mais informações, consulte FailParentOnFailure.
ForcedExecutionValue Se ForceExecutionValue estiver definido como True, o objeto que contém o valor de execução opcional para o contêiner. O valor padrão dessa propriedade é 0.

Para obter mais informações, consulte ForcedExecutionValue.
ForcedExecutionValueType O tipo de dados de ForcedExecutionValue. O valor padrão dessa propriedade é Int32.
ForceExecutionResult Um valor que especifica o resultado forçado da execução do pacote ou contêiner. Os valores são None, Success, Failuree Completion. O valor padrão para essa propriedade é None.

Para obter mais informações, consulte ForceExecutionResult.
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.

Para obter mais informações, consulte ForceExecutionValue.
ID É o GUID do contêiner que é atribuído quando o pacote é criado. Esta propriedade é somente para leitura.

ID.
IsolationLevel É o nível de isolamento da transação de contêiner. Os valores são Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializablee Snapshot. O valor padrão dessa propriedade é Serializable. Para obter mais informações, consulte IsolationLevel.
LocaleID É uma localidade do Microsoft Win32. O valor padrão dessa propriedade é a localidade do sistema operacional no computador local.

Para obter mais informações, consulte LocaleID.
LoggingMode É um valor que especifica o comportamento de log do contêiner. Os valores são Disabled, Enablede UseParentSetting. O valor padrão dessa propriedade é UseParentSetting. Para obter mais informações, consulte DTSLoggingMode.
MaximumErrorCount É o número máximo de erros que podem acontecer antes de um contêiner parar de ser executado. O valor padrão desta propriedade é 1.

Para obter mais informações, consulte MaximumErrorCount.
Nome É o nome do contêiner.

Para obter mais informações, consulte Name.
TransactionOption É a participação transacional do contêiner. Os valores são NotSupported, Supportede Required. O valor padrão dessa propriedade é Supported. Para obter mais informações, consulte DTSTransactionOption.

Para saber a respeito de todas as propriedades que estão disponíveis para os contêineres Loop Foreach, Loop For, Sequência e Host da Tarefa ao configurá-los programaticamente, consulte os seguintes tópicos da API de Integration Services :

  • T:Microsoft.SqlServer.Dts.Runtime.ForEachLoop

  • T:Microsoft.SqlServer.Dts.Runtime.ForLoop

  • T:Microsoft.SqlServer.Dts.Runtime.Sequence

  • T:Microsoft.SqlServer.Dts.Runtime.TaskHost

Objetos que estendem a funcionalidade do contêiner

Os contêineres incluem fluxos de controle que consistem em executáveis e restrições de precedência e podem usar manipuladores de eventos e variáveis. O contêiner host da tarefa é uma exceção: como o contêiner host da tarefa encapsula uma única tarefa, ele não usa restrições de precedência.

Executáveis

Os executáveis referem-se às tarefas do nível de contêiner e a qualquer contêiner dentro do contêiner. Um executável pode ser uma das tarefas e dos contêineres que o Integration Services fornece ou uma tarefa personalizada. Para obter mais informações, consulte Tarefas do Integration Services.

Restrições de precedência

As restrições de precedência vinculam contêineres e tarefas dentro do mesmo contêiner pai em um fluxo de controle ordenado. Para obter informações, consulte Restrições de precedência.

Manipuladores de eventos

Os manipuladores de eventos no nível de contêiner respondem a eventos gerados pelo contêiner ou aos objetos nele incluídos. Para obter mais informações, confira Manipuladores de Eventos do Integration Services (SSIS).

Variáveis

As variáveis usadas em contêineres incluem as variáveis do sistema no nível de contêiner fornecidas pelo Integration Services e as variáveis definidas pelo usuário usadas pelo contêiner. Para obter mais informações, consulte Variáveis do SSIS (Integration Services).

Pontos de interrupção

Quando você define um ponto de interrupção em um contêiner e a condição de interrupção é Interromper quando o contêiner recebe o evento OnVariableValueChanged, defina a variável no escopo de contêiner.

Consulte Também

Fluxo de Controle