Establecer las propiedades de paquetes
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, use una consulta SQL para establecer 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
En SQL Server Data Tools (SSDT), abra el proyecto de Integration Services que contiene el paquete que desea configurar.
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.
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.
Modifique las propiedades del paquete en la ventana Propiedades .
En el menú Archivo , haga clic en Guardar los elementos seleccionados para guardar el paquete actualizado.