Establecer las propiedades de paquetes

  • Artículo

Se aplica a:SQL Server SSIS Integration Runtime en Azure Data Factory

Cuando se crea un paquete en SQL Server Data Tools (SSDT) mediante la interfaz gráfica proporcionada por Integration Services , se configuran las propiedades del objeto de paquete en la ventana Propiedades.

La ventana Propiedades proporciona una lista categorizada y alfabética de propiedades. Para organizar la ventana Propiedades por categorías, haga clic en el icono Por categorías.

Cuando se organiza por categorías, la ventana Propiedades agrupa propiedades en las siguientes categorías:

Para obtener información sobre propiedades adicionales de paquetes que no se pueden establecer en la ventana Propiedades , vea Package.

Para establecer las propiedades del paquete en la ventana Propiedades.

Propiedades por categoría

Las siguientes tablas enumeran las propiedades de paquete por categoría.

Puntos de control

Puede usar las propiedades de esta categoría para reiniciar el paquete desde un punto de error en el flujo de control de paquetes, en lugar de volver a ejecutar el paquete desde el principio de su flujo de control. Para obtener más información, vea Restart Packages by Using Checkpoints.

Propiedad Descripción
CheckpointFileName Nombre del archivo que captura la información del punto de comprobación que permite que un paquete se reinicie. Cuando el paquete termina correctamente, se elimina este archivo.
CheckpointUsage Especifica cuándo se puede reiniciar un paquete. Los valores son Never, IfExistsy Always. El valor predeterminado de esta propiedad es Never, que indica que el paquete no puede reiniciarse. Para más información, consulte DTSCheckpointUsage.
SaveCheckpoints Especifica si los puntos de comprobación se escriben en el archivo de punto de comprobación cuando se ejecuta el paquete. El valor predeterminado de esta propiedad es False.

Nota

La opción /CheckPointing on de dtexec equivale a establecer en True el valor de la propiedad SaveCheckpoints del paquete y el de la propiedad CheckpointUsage en Always. Para obtener más información, consulte utilidad dtexec.

Ejecución

Las propiedades en esta categoría configuran el comportamiento de tiempo de ejecución del objeto de paquete.

Propiedad Descripción
DelayValidation Indica si la validación del paquete se retrasa hasta que se ejecute el paquete. El valor predeterminado de esta propiedad es False.
Deshabilitar Indica si el paquete está deshabilitado. El valor predeterminado de esta propiedad es False.
DisableEventHandlers Especifica si se ejecutan los controladores de eventos del paquete. El valor predeterminado de esta propiedad es False.
FailPackageOnFailure Especifica si el paquete genera un error cuando se produce un error en un componente de paquete. El único valor válido de esta propiedad es False.
FailParentOnError Especifica si el contenedor principal genera un error cuando se produce un error en un contenedor secundario. El valor predeterminado de esta propiedad es False.
MaxConcurrentExecutables Cantidad de archivos ejecutables que el paquete puede ejecutar simultáneamente. El valor predeterminado de esta propiedad es -1, que indica que no hay límite.
MaximumErrorCount Cantidad máxima de errores que se pueden producir antes de que un paquete termine de ejecutarse. El valor predeterminado de esta propiedad es 1.
PackagePriorityClass Clase de prioridad de subproceso Win32 del subproceso del paquete. Los valores son Default, AboveNormal, Normal, BelowNormaly Idle. El valor predeterminado de esta propiedad es Default. Para más información, consulte DTSPriorityClass.

Valor de ejecución forzada

Las propiedades de esta categoría configuran un valor de ejecución opcional para el paquete.

Propiedad Descripción
ForcedExecutionValue Si ForceExecutionValue se configura como True, valor que especifica el valor de ejecución opcional que devuelve el paquete. El valor predeterminado de esta propiedad es 0.
ForcedExecutionValueType Tipo de datos de ForcedExecutionValue. El valor predeterminado de esta propiedad es Int32.
ForceExecutionValue Valor booleano que especifica si se debería forzar a que el valor de ejecución opcional del contenedor contenga un valor concreto. El valor predeterminado de esta propiedad es False.

Identificación

Las propiedades de esta categoría proporcionan información como el identificador único y el nombre del paquete.

Propiedad Descripción
CreationDate Fecha en que se creó el paquete.
CreatorComputerName Nombre del equipo en el que creó el paquete.
CreatorName Nombre de la persona que creó el paquete.
Descripción Descripción de la funcionalidad del paquete.
Id GUID del paquete, que se asigna cuando se crea el paquete. Esta propiedad es de solo lectura. Para generar un nuevo valor aleatorio para la propiedad ID, seleccione <Generar nuevo Id.> en la lista desplegable.
Nombre Nombre del paquete.
PackageType Tipo de paquete. Los valores son Default, DTSDesigner, DTSDesigner100, DTSWizard, SQLDBMainty SQLReplication. El valor predeterminado de esta propiedad es Default. Para más información, consulte DTSPackageType.

Varios

Las propiedades de esta categoría se usan para obtener acceso a las configuraciones y expresiones que usa un paquete y proporcionar información acerca de la configuración regional y modo de registro del paquete. Para más información, vea Usar expresiones de propiedad en paquetes.

Propiedad Descripción
Configuraciones Colección de las configuraciones que usa el paquete. Haga clic en el botón Examinar (…) para ver y configurar las configuraciones de paquetes.
Expresiones Haga clic en el botón Examinar (…) para crear expresiones para las propiedades del paquete.

Observe que puede crear expresiones de propiedad para todas las propiedades de paquete que incluye el modelo de objeto, y no solo para las propiedades enumeradas en la ventana Propiedades.

Para más información, vea Usar expresiones de propiedad en paquetes.

Para ver expresiones de propiedad existentes, expanda Expressions. Haga clic en el botón Examinar (…) en un cuadro de texto de expresión para modificar y evaluar una expresión.
ForceExecutionResult El resultado de la ejecución del paquete. Los valores son None, Success, Failurey Completion. El valor predeterminado de esta propiedad es None. Para obtener más información, vea T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult.
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 paquete. Los valores son Disabled, Enabledy UseParentSetting. El valor predeterminado de esta propiedad es UseParentSetting. Para más información, consulte DTSLoggingMode.
OfflineMode Indica si el paquete está en el modo sin conexión. Esta propiedad es de solo lectura. La propiedad se establece en el nivel de proyecto. Por lo general, el Diseñador SSIS intenta conectarse a cada origen de datos utilizado por el paquete para validar los metadatos asociados a los orígenes y destinos. Es posible habilitar la opción Trabajar sin conexión en el menú SSIS , incluso antes de abrir un paquete, para evitar los intentos de conexión y los errores de validación provocados por esos intentos cuando los orígenes de datos no están disponibles. También se puede habilitar la opción Trabajar sin conexión para acelerar las operaciones en el diseñador, y deshabilitarla solo cuando se quiere validar el paquete.
SuppressConfigurationWarnings Indica si se suprimen las advertencias generadas por configuraciones. El valor predeterminado de esta propiedad es False.
UpdateObjects Indica si el paquete se actualiza para usar versiones más recientes de los objetos que contiene, si hay versiones más recientes disponibles. Por ejemplo, si esta propiedad se establece en True, un paquete que incluye una tarea Inserción masiva se actualiza para usar una versión más reciente de la tarea Inserción masiva que proporciona Integration Services . El valor predeterminado de esta propiedad es False.

Seguridad

Las propiedades en esta categoría se usan para configurar el nivel de protección del paquete. Para más información, consulte Access Control for Sensitive Data in Packages.

Propiedad Descripción
PackagePassword Contraseña de los niveles de protección del paquete (EncryptSensitiveWithPassword y EncryptAllWithPassword) que requieren contraseñas.
ProtectionLevel El nivel de protección del paquete. Los valores son DontSaveSensitive, EncryptSensitiveWithUserKey, EncryptSensitiveWithPassword, EncryptAllWithPasswordy ServerStorage. El valor predeterminado de esta propiedad es EncryptSensitiveWithUserKey. Para más información, consulte DTSProtectionLevel.

Transacciones

Las propiedades en esta categoría configuran el nivel de aislamiento y la opción de transacción del paquete. Para más información, vea Transacciones de Integration Services.

Propiedad Descripción
IsolationLevel Nivel de aislamiento de la transacción del paquete. Los valores son Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializabley Snapshot. El valor predeterminado de esta propiedad es Serializable.

Nota: El valor Snapshot de la propiedad IsolationLevel es incompatible con las transacciones de paquete. Por consiguiente, no puede utilizar la propiedad IsolationLevel para establecer el nivel de aislamiento de las transacciones de paquete en Shapshot. En su lugar, utilice una consulta SQL para establecer las transacciones de paquete en Snapshot. Para obtener más información, vea SET TRANSACTION ISOLATION LEVEL (Transact-SQL).

El sistema aplica la propiedad IsolationLevel a las transacciones de paquete solamente cuando el valor de la propiedad TransactionOption se establece en Required.

El valor de la propiedad IsolationLevel solicitado por un contenedor secundario se omite cuando se cumplen las condiciones siguientes:
El valor de la propiedad TransactionOption del contenedor secundario es Supported.
El contenedor secundario combina la transacción de un contenedor primario.

El valor de la propiedad IsolationLevel solicitado por el contenedor se respeta solamente cuando el contenedor inicia una nueva transacción. Un contenedor inicia una nueva transacción cuando se cumplen las condiciones siguientes:
El valor de la propiedad TransactionOption del contenedor es Required.
El contenedor primario aún no ha iniciado una transacción.



Para más información, consulte IsolationLevel.
TransactionOption Participación transaccional del paquete. Los valores son NotSupported, Supportedy Required. El valor predeterminado de esta propiedad es Supported. Para más información, consulte DTSTransactionOption.

Versión

Las propiedades de esta categoría proporcionan información sobre la versión del objeto de paquete.

Propiedad Descripción
VersionBuild Número de versión de la compilación del paquete.
VersionComments Comentarios acerca de la versión del paquete.
VersionGUID GUID de la versión del paquete. Esta propiedad es de solo lectura.
VersionMajor Última versión importante del paquete.
VersionMinor Última versión de menor importancia del paquete.

Establecimiento de las propiedades del paquete en la ventana Propiedades

  1. En SQL Server Data Tools (SSDT), abra el proyecto de Integration Services que contiene el paquete que desea configurar.

  2. En el Explorador de soluciones, haga doble clic en el paquete para abrirlo en el Diseñador SSIS , o bien haga clic con el botón derecho y seleccione Diseñador de vistas.

  3. Haga clic en la pestaña Flujo de control y, a continuación, realice una de las operaciones siguientes:

    • Haga clic con el botón derecho en cualquier parte del fondo de la superficie de diseño de flujo de control y haga clic en Propiedades.

    • En el menú Ver , haga clic en Ventana de propiedades.

  4. Modifique las propiedades del paquete en la ventana Propiedades .

  5. En el menú Archivo , haga clic en Guardar los elementos seleccionados para guardar el paquete actualizado.