Compartir a través de


Contenedores de Integration Services

Actualizado: 14 de abril de 2006

Los contenedores son objetos de SQL Server 2005 Integration Services (SSIS) que proporcionan estructura a los paquetes y servicios a las tareas. Permiten repetir flujos de control en paquetes y agrupan tareas y contenedores en unidades de trabajo significativas. Los contenedores pueden incluir otros contenedores, además de tareas.

Los paquetes usan contenedores para los siguientes fines:

  • Repetir tareas para cada elemento de una colección, como archivos de una carpeta, esquemas u objetos de administración de SQL Server (SMO). Por ejemplo, un paquete puede ejecutar instrucciones de Transact-SQL almacenadas en varios archivos.
  • Repetir las tareas hasta que una expresión especificada se evalúe como false. Por ejemplo, un paquete puede enviar un mensaje de correo electrónico distinto siete veces, una vez cada día de la semana.
  • Agrupar tareas y contenedores que deben completarse correctamente o no completarse como una unidad (todas o ninguna). Por ejemplo, un paquete puede agrupar tareas que eliminan y agregan filas de una tabla de base de datos, y confirmar o revertir todas las tareas si una no se completa correctamente.

Tipos de contenedor

Integration Services proporciona cuatro tipos de contenedores para generar paquetes. En la tabla siguiente se muestran los tipos de contenedor.

Contenedor Descripción

Contenedor Foreach Loop

Ejecuta un flujo de control repetidamente mediante un enumerador.

Contenedor de bucles For

Ejecuta un flujo de control repetidamente probando una condición.

Contenedor de secuencias

Agrupa tareas y contenedores en flujos de control que son subconjuntos del flujo de control del paquete.

Contenedor de tarea

Proporciona servicios a una tarea individual.

Los paquetes y los controladores de eventos también son tipos de contenedores. Para obtener más información, vea Paquetes de Integration Services y Controladores de eventos de Integration Services.

Resumen de propiedades de contenedor

Todos los tipos de contenedor tienen un conjunto de propiedades comunes. Si se crean paquetes con las herramientas gráficas de Integration Services, en la ventana Propiedades se enumeran las siguientes propiedades de los contenedores de bucles Foreach, bucles For y secuencias. Las propiedades del contenedor del host de la tarea se configuran como parte de la configuración de la tarea que el host de la tarea encapsula. Las propiedades del host de la tarea se establecen al configurar la tarea.

Propiedad Descripción

DelayValidation

Indica si la validación del contenedor se retrasa hasta el tiempo de ejecución. La propiedad contiene el valor booleano False.

Description

Descripción del contenedor. La propiedad contiene una cadena, pero puede estar en blanco.

Disable

Indica si el contenedor se ejecuta. La propiedad contiene el valor booleano predeterminado False.

DisableEventHandlers

Indica si los controladores de eventos asociados al contenedor se ejecutan. La propiedad contiene el valor booleano predeterminado False.

FailPackageOnFailure

Especifica si el paquete genera un error cuando se produce un error en el contenedor. La propiedad contiene el valor booleano predeterminado False.

FailParentOnFailure

Especifica si el contenedor principal genera un error cuando se produce un error en el contenedor. La propiedad contiene el valor booleano predeterminado False.

ForcedExecutionValue

Si ForceExecutionValue se configura como True, un valor que especifica el valor de ejecución que devuelve el contenedor. El valor predeterminado de esta propiedad es 0.

ForcedExecutionValueType

Tipo de datos de ForcedExecutionValue.

ForceExecutionResult

Especifica si el valor de ejecución del contenedor es forzado. La propiedad contiene el valor booleano predeterminado False.

ForceExecutionValue

El resultado de la ejecución del contenedor. Los valores son None, Success, Failure y Completion. El valor predeterminado de esta propiedad es None. Para obtener más información, vea T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult.

ID

GUID del contenedor, que se asigna cuando se crea el paquete. Esta propiedad es de sólo lectura.

IsolationLevel

Nivel de aislamiento de la transacción del contenedor. Los valores son Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializable y Snapshot. El valor predeterminado de esta propiedad es Serializable. Para obtener más información, vea IsolationLevel.

LocaleID

Una configuración regional de Microsoft Win32. El valor predeterminado de esta propiedad es la configuración regional del sistema operativo del equipo local.

LoggingMode

Valor que especifica el comportamiento de registro del contenedor. Los valores son Disabled, Enabled y UseParentSetting. El valor predeterminado de esta propiedad es UseParentSetting. Para obtener más información, vea DTSLoggingMode.

MaximumErrorCount

Cantidad máxima de errores que se pueden producir antes de que un contenedor termine de ejecutarse. El valor predeterminado de esta propiedad es 1.

Name

Nombre del contenedor.

TransactionOption

Participación transaccional del contenedor. Los valores son NotSupported, Supported y Required. El valor predeterminado de esta propiedad es Supported. Para obtener más información, vea DTSTransactionOption.

Para obtener información sobre todas las propiedades disponibles para los contenedores de bucles Foreach, bucles For, secuencias y host de la tarea cuando se configuran mediante programación, vea los siguientes temas de la API de Integration Services:

Objetos que extienden la funcionalidad de un contenedor

Los contenedores incluyen flujos de control formados por ejecutables y restricciones de precedencia, y pueden usar controladores de eventos y variables. El contenedor del host de la tarea es una excepción: puesto que este contenedor encapsula una única tarea, no utiliza las restricciones de precedencia.

Ejecutables

Los ejecutables hacen referencia a las tareas de nivel de contenedor y a cualquier contenedor contenido en el contenedor. Un ejecutable puede ser una de las tareas y los contenedores proporcionados por Integration Services, o una tarea personalizada. Para obtener más información, vea Tareas de Integration Services y Contenedores de Integration Services.

Restricciones de precedencia

Las restricciones de precedencia vinculan los contenedores y las tareas del mismo contenedor principal en un flujo de control ordenado. Para obtener más información, vea Restricciones de precedencia.

Controladores de eventos

Los controladores de eventos de nivel de contenedor responden a eventos provocados por el contenedor o por los objetos que incluye. Para obtener más información, vea Controladores de eventos de Integration Services.

Variables

Las variables que se usan en contenedores incluyen las variables del sistema de nivel de contenedor proporcionadas por Integration Services y las variables definidas por el usuario utilizadas por el contenedor. Para obtener más información, vea Variables de Integration Services.

Vea también

Conceptos

Elementos de flujo de control

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión Historial

14 de abril de 2006

Contenido nuevo:
  • Sección agregada en la que se describen las propiedades de los contenedores.