Establecer las propiedades de un componente de flujo de datos

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

Para establecer las propiedades de los componentes de flujo de datos, que incluyen orígenes, destinos y transformaciones, utilice una de las características siguientes:

  • Los editores de componentes que Integration Services proporciona. Estos editores incluyen solo las propiedades personalizadas de cada componente de flujo de datos.

  • La ventana Propiedades enumera las propiedades personalizadas de nivel de componente de cada elemento, al igual que las propiedades que son comunes a todos los elementos de flujo de datos.

  • El cuadro de diálogo Editor avanzado proporciona acceso a las propiedades personalizadas de cada componente. El cuadro de diálogo Editor avanzado también permite acceder a las propiedades comunes de todos los componentes de flujo de datos (propiedades de entradas, salidas, salidas de error, columnas y columnas externas).

Establecer las propiedades de un componente de flujo de datos con un editor de componentes

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

  2. En el Explorador de soluciones, haga doble clic en el paquete para abrirlo.

  3. Haga clic en la pestaña Flujo de control y luego haga doble clic en la tarea Flujo de datos que contiene el flujo de datos con el componente cuyas propiedades quiere ver y modificar.

  4. Haga doble clic en el componente de flujo de datos.

  5. En el editor de componentes, vea o modifique los valores de las propiedades y luego cierre el editor.

  6. Para guardar el paquete actualizado, en el menú Archivo , haga clic en Guardar los elementos seleccionados.

Establecer las propiedades de un componente de flujo de datos en la ventana Propiedades

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

  2. En el Explorador de soluciones, haga doble clic en el paquete para abrirlo.

  3. Haga clic en la pestaña Flujo de control y luego haga doble clic en la tarea Flujo de datos que contiene el componente cuyas propiedades quiere ver y modificar.

  4. Haga clic con el botón derecho en el componente de flujo de datos y luego haga clic en Propiedades.

  5. Vea o modifique los valores de la propiedad y luego cierre la ventana Propiedades .

    Nota:

    Muchas propiedades son de solo lectura y no pueden modificarse.

  6. Para guardar el paquete actualizado, en el menú Archivo , haga clic en Guardar los elementos seleccionados.

Establecer las propiedades de un componente de flujo de datos con el Editor avanzado

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

  2. En el Explorador de soluciones, haga doble clic en el paquete para abrirlo.

  3. Haga clic en la pestaña Flujo de control y luego haga doble clic en la tarea Flujo de datos que contiene el componente que quiere ver o modificar.

  4. En el diseñador de flujos de datos, haga clic con el botón derecho en el componente de flujo de datos y luego haga clic en Mostrar editor avanzado.

    Nota:

    En SQL Server, los componentes de flujo de datos que admiten varias entradas no pueden usar el Editor avanzado.

  5. En el cuadro de diálogo Editor avanzado , realice cualquiera de los pasos siguientes:

    • Para ver y especificar la conexión que el componente utiliza, haga clic en la pestaña Administradores de conexiones .

      Nota:

      La pestaña Administradores de conexiones está disponible solamente para los componentes de flujo de datos que usan administradores de conexiones para conectarse a orígenes de datos tales como archivos y bases de datos

    • Para ver y modificar propiedades de nivel de componente, haga clic en la pestaña Propiedades de componente .

    • Para ver y modificar asignaciones entre columnas externas y la salida disponible, haga clic en la pestaña Asignaciones de columnas .

      Nota:

      La pestaña Asignaciones de columnas solo está disponible al ver o modificar orígenes o destinos.

    • Para ver una lista de las columnas de entrada disponibles y para actualizar los nombres de las columnas de salida, haga clic en la pestaña Columnas de entrada .

      Nota:

      La pestaña Columnas de entrada está disponible solamente cuando se trabaja con transformaciones o destinos. Para más información, consulte Integration Services Transformations.

    • Para ver y modificar las propiedades de las entradas, salidas y salidas de errores, y las propiedades de las columnas que contienen, haga clic en la pestaña Propiedades de entrada y salida .

      Nota:

      Los orígenes no tienen entradas. Los destinos no tienen salidas, excepto una salida de errores opcional.

  6. Vea o modifique los valores de propiedades.

  7. Haga clic en OK.

  8. Para guardar el paquete actualizado, en el menú Archivo , haga clic en Guardar los elementos seleccionados.

Propiedades comunes de los componentes de flujo de datos

Los objetos de flujo de datos en el modelo de objetos de Microsoft SQL Server Integration Services tienen propiedades comunes y propiedades personalizadas en el nivel del componente, de las entradas y salidas, y de las columnas de entrada y de salida. Muchas propiedades tienen valores de solo lectura que son asignados en tiempo de ejecución por el motor de flujo de datos.

En este tema se enumeran y describen las propiedades comunes de los objetos de flujo de datos.

Component properties

En el modelo de objetos de Integration Services, un componente en el flujo de datos implementa la interfaz IDTSComponentMetaData100.

La tabla siguiente describe las propiedades de los componentes en un flujo de datos. Algunas propiedades tienen valores de solo lectura que son asignados en tiempo de ejecución por el motor de flujo de datos.

Propiedad Tipo de datos Descripción
ComponentClassID String CLSID del componente.
ContactInfo String Información de contacto para el programador de un componente.
Descripción String Descripción del componente de flujo de datos. El valor predeterminado de esta propiedad es el nombre del componente de flujo de datos.
ID Entero Valor que identifica de forma única esta instancia del componente.
IdentificationString String Identifica el componente.
IsDefaultLocale Boolean Indica si el componente utiliza la configuración regional de la tarea Flujo de Datos a la que pertenece.
LocaleID Entero Configuración regional que el componente de flujo de datos utiliza cuando el paquete se ejecuta. Todas las configuraciones regionales de Windows están disponibles para su uso en componentes de flujo de datos.
Nombre String Nombre del componente de flujo de datos.
PipelineVersion Entero La versión de la tarea de flujo de datos para la que se ha diseñado la ejecución de un componente.
UsesDispositions Boolean Indica si un componente tiene una salida de error.
ValidateExternalMetadata Boolean Indica si se validan los metadatos de columnas externas. El valor predeterminado de esta propiedad es True.
Versión Entero Versión de un componente.

Propiedades de entrada

En el modelo de objetos de Integration Services , las transformaciones y los destinos tienen entradas. Una entrada de un componente en el flujo de datos implementa la interfaz IDTSInput100.

La tabla siguiente describe las propiedades de las entradas de componentes en un flujo de datos. Algunas propiedades tienen valores de solo lectura que son asignados en tiempo de ejecución por el motor de flujo de datos.

Propiedad Tipo de datos Descripción
Descripción String Descripción de la entrada.
ErrorOrTruncationOperation String Cadena opcional que especifica los tipos de errores o truncamientos que pueden producirse al procesar una fila.
ErrorRowDisposition DTSRowDisposition Valor que especifica el control de errores. Los valores son Fail component, Ignore failurey Redirect row.
HasSideEffects Boolean Indica si un componente se puede quitar del plan de ejecución del flujo de datos cuando no está adjunto a un componente de nivel inferior y cuando RunInOptimizedMode es true.
ID Entero Valor que identifica la entrada de forma inequívoca.
IdentificationString String Cadena que identifica la entrada.
IsSorted Boolean Indica si los datos de la entrada están ordenados.
Nombre String Nombre de la entrada.
SourceLocale Entero El Id. de configuración regional (LCID) de los datos de entrada.
TruncationRowDisposition DTSRowDisposition Valor que determina la forma en que el componente administra los truncamientos producidos al procesar las filas. . Los valores son Fail component, Ignore failurey Redirect row.

Los destinos y algunas transformaciones no admiten la salida de errores y, además, las propiedades ErrorRowDisposition y TruncationRowDisposition de estos componentes son de solo lectura.

Propiedades de las columnas de entrada

En el modelo de objetos de Integration Services , una entrada contiene una colección de columnas de entrada. Una columna de entrada de un componente en el flujo de datos implementa la interfaz IDTSInputColumn100.

La tabla siguiente describe las propiedades de las columnas de entrada de los componentes en un flujo de datos. Algunas propiedades tienen valores de solo lectura que son asignados en tiempo de ejecución por el motor de flujo de datos.

Propiedad Tipo de datos Descripción
ComparisonFlags Entero Conjunto de marcas que especifican la comparación de columnas cuyo tipo de datos es carácter. Para más información, consulte Comparing String Data.
Descripción String Describe la columna de entrada.
ErrorOrTruncationOperation String Cadena opcional que especifica los tipos de errores o truncamientos que pueden producirse al procesar una fila.
ErrorRowDisposition DTSRowDisposition Valor que especifica el control de errores. Los valores son Fail component, Ignore failurey Redirect row.
ExternalMetadataColumnID IDTSExternalMetadataColumn100 El Id. de la columna de metadatos externa asignado a una columna de entrada.
ID Entero Valor que identifica la columna de entrada de forma inequívoca.
IdentificationString String Cadena que identifica la columna de entrada.
LineageID Entero El Id. de columna para la columna de nivel superior.
LineageIdentificationString String La cadena de identificación que incluye el nombre de la columna de nivel superior.
Nombre String Nombre de la columna de entrada.
SortKeyPosition Entero Valor que indica si una columna está ordenada, su criterio de ordenación y la secuencia en la que se ordenan varias columnas. El valor 0 indica que la columna no está ordenada. Para obtener más información, vea Ordenar datos para las transformaciones Mezclar y Combinación de mezcla.
TruncationRowDisposition DTSRowDisposition Valor que determina la forma en que el componente administra los truncamientos producidos al procesar las filas. Los valores son Fail component, Ignore failurey Redirect row.
UpstreamComponentName String Nombre del componente de nivel superior.
UsageType DTSUsageType Valor que determina la forma en que el componente utiliza una columna de entrada.

Las columnas de entrada también tienen las propiedades de tipo de datos descritas en "Propiedades del tipo de datos”.

Propiedades de salida

En el modelo de objetos de Integration Services , las transformaciones y los orígenes tienen salidas. Una salida de un componente en el flujo de datos implementa la interfaz IDTSOutput100.

La tabla siguiente describe las propiedades de las salidas de componentes en un flujo de datos. Algunas propiedades tienen valores de solo lectura que son asignados en tiempo de ejecución por el motor de flujo de datos.

Propiedad Tipo de datos Descripción
DeleteOutputOnPathDetached Boolean Valor que determina si el motor de flujo de datos elimina la salida cuando ésta se separa de una ruta.
Descripción String Describe la salida.
ErrorOrTruncationOperation String Cadena opcional que especifica los tipos de errores o truncamientos que pueden producirse al procesar una fila.
ErrorRowDisposition DTSRowDisposition Valor que especifica el control de errores. Los valores son Fail component, Ignore failurey Redirect row.
ExclusionGroup Entero Valor que identifica un grupo de salidas mutuamente excluyentes.
HasSideEffects Boolean Valor que indica si un componente puede quitarse del plan de ejecución del flujo de datos cuando no está adjunto con un componente de nivel superior y cuando RunInOptimizedMode es true.
ID Entero Valor que identifica la salida de forma inequívoca.
IdentificationString String Cadena que identifica la salida.
IsErrorOut Boolean Indica si la salida es una salida de errores.
IsSorted Boolean Indica si la salida está ordenada. El valor predeterminado es False.

** Importante ** Aunque se establezca el valor de la propiedad IsSorted en True, los datos no se ordenan. Esta propiedad únicamente proporciona una sugerencia a los componentes de nivel inferior acerca de que los datos se han ordenado previamente. Para obtener más información, vea Ordenar datos para las transformaciones Mezclar y Combinación de mezcla.
Nombre String Nombre de la salida.
SynchronousInputID Entero El Id. de una entrada que es sincrónica con la salida.
TruncationRowDisposition DTSRowDisposition Valor que determina la forma en que el componente administra los truncamientos producidos al procesar las filas. Los valores son Fail component, Ignore failurey Redirect row.

Propiedades de las columnas de salida

En el modelo de objetos de Integration Services , una salida contiene una colección de columnas de resultados. Una columna de resultados de un componente en el flujo de datos implementa la interfaz IDTSOutputColumn100.

La tabla siguiente describe las propiedades de las columnas de resultados de los componentes en un flujo de datos. Algunas propiedades tienen valores de solo lectura que son asignados en tiempo de ejecución por el motor de flujo de datos.

Propiedad Tipo de datos Descripción
ComparisonFlags Entero Conjunto de marcas que especifican la comparación de columnas cuyo tipo de datos es carácter. Para más información, consulte Comparing String Data.
Descripción String Describe la columna de resultados.
ErrorOrTruncationOperation String Cadena opcional que especifica los tipos de errores o truncamientos que pueden producirse al procesar una fila.
ErrorRowDisposition DTSRowDisposition Valor que especifica el control de errores. Los valores son Fail component, Ignore failurey Redirect row. El valor predeterminado es Error de componente.
ExternalMetadataColumnID Entero El Id. de la columna de metadatos externa asignado a una columna de entrada.
ID Entero Valor que identifica la columna de resultados de forma inequívoca.
IdentificationString String Cadena que identifica la columna de resultados.
LineageID Entero El Id. de columna para la columna de resultados. Los componentes de nivel inferior hacen referencia a la columna utilizando este valor.
LineageIdentificationString String La cadena de identificación que incluye el nombre de la columna.
Nombre String Nombre de la columna de resultados.
SortKeyPosition Entero Valor que indica si una columna está ordenada, su criterio de ordenación y la secuencia en la que se ordenan varias columnas. El valor 0 indica que la columna no está ordenada. Para obtener más información, vea Ordenar datos para las transformaciones Mezclar y Combinación de mezcla.
SpecialFlags Entero Un valor que contiene las marcas especiales de la columna de resultados.
TruncationRowDisposition DTSRowDisposition Valor que determina la forma en que el componente administra los truncamientos producidos al procesar las filas. Los valores son Fail component, Ignore failurey Redirect row. El valor predeterminado es Error de componente.

Las columnas de resultados también incluyen un conjunto de propiedades de tipo de datos.

Propiedades de las columnas de metadatos externos

En el modelo de objetos Integration Services , las entradas y salidas pueden contener una colección de columnas de metadatos externos. Una columna de metadatos externos de un componente en el flujo de datos implementa la interfaz IDTSExternalMetadataColumn100.

La tabla siguiente describe las propiedades de las columnas de metadatos externos de los componentes en un flujo de datos. Algunas propiedades tienen valores de solo lectura que son asignados en tiempo de ejecución por el motor de flujo de datos.

Propiedad Tipo de datos Descripción
Descripción String Describe la columna externa.
ID Entero Valor que identifica la columna de forma inequívoca.
IdentificationString String Cadena que identifica la columna.
Nombre String Nombre de la columna de externa.

Las columnas de metadatos externos también incluyen un conjunto de propiedades de tipo de datos.

Propiedades de tipos de datos

Las columnas de resultados y de metadatos externos incluyen un conjunto de propiedades de tipo de datos. Dependiendo del tipo de datos de la columna, las propiedades pueden ser de lectura y escritura o de solo lectura.

La tabla siguiente describe las propiedades del tipo de datos de las columnas de resultados y de metadatos externos.

Propiedad Tipo de datos Descripción
CodePage Entero Especifica la página de códigos para cadenas en un formato que no es Unicode.
DataType Integer (enumeración) Tipo de datos Integration Services de la columna. Para obtener más información, vea Integration Services Data Types.
Length Entero Longitud de una columna en caracteres.
Precisión Entero Precisión de una columna numérica.
Escala Entero Escala de una columna numérica.

Propiedades personalizadas de los componentes de flujo de datos

Para obtener información acerca de propiedades personalizadas, vea los siguientes temas.

Utilizar una expresión en un componente de flujo de datos

Este procedimiento describe cómo agregar una expresión a la transformación División condicional o a la transformación Columna derivada. La transformación División condicional utiliza expresiones para definir las condiciones que dirigen las filas de datos a una salida de transformación y la transformación Columna derivada utiliza expresiones para definir los valores asignados a las columnas.

Para implementar una expresión en una transformación, el paquete ya debe incluir por lo menos una tarea Flujo de datos y un origen.

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

  2. En el Explorador de soluciones, haga doble clic en el paquete para abrirlo.

  3. En el Diseñador SSIS , haga clic en la pestaña Flujo de control y, a continuación, en la tarea Flujo de datos que contiene el flujo de datos en el que desea implementar la expresión.

  4. Haga clic en la pestaña Flujo de datos y arrastre una transformación División condicional o Columna derivada del Cuadro de herramientas a la superficie de diseño.

  5. Arrastre el conector verde desde el origen o desde una transformación a la transformación División condicional o Columna derivada.

  6. Haga doble clic en la transformación para abrir el cuadro de diálogo correspondiente.

  7. En el panel de la izquierda, expanda Variables para ver las variables del sistema y las definidas por el usuario, y expanda Columnas para ver las columnas de entrada de la transformación.

  8. En el panel de la derecha, expanda Funciones matemáticas, Funciones de cadena, Funciones de fecha y hora, Funciones NULL, Conversiones de tipoy Operadores para tener acceso a las funciones, las conversiones y los operadores que proporciona la gramática de expresiones.

  9. Dependiendo de la transformación, siga uno de estos procedimientos para crear una expresión:

    • En el cuadro de diálogo Editor de transformación División condicional , arrastre las variables, columnas, funciones, operadores y conversiones a la columna Condición . O bien, puede escribir una expresión directamente en la columna Condición .

    • En el cuadro de diálogo Editor de transformación Columna derivada , arrastre las variables, columnas, funciones, operadores y conversiones a la columna Expresión . O bien, puede escribir una expresión directamente en la columna Expresión .

      Nota:

      Al quitar el foco de la columna Condición o Expresión , el texto de la expresión podría resaltarse para indicar que la sintaxis de la expresión es incorrecta.

  10. Haga clic en Aceptar para salir del cuadro de diálogo.

    Nota:

    Si la expresión no es válida, aparece una alerta que describe los errores de sintaxis de la expresión.

Propiedades del flujo de datos que se pueden establecer con una expresión

Los valores de ciertas propiedades de objetos de flujo de datos se pueden especificar utilizando expresiones de propiedades disponibles en el contenedor de tareas Flujo de Datos.

Para obtener información sobre el uso de expresiones de propiedades, vea Usar expresiones de propiedad en paquetes.

Puede utilizar las expresiones de propiedades para personalizar las configuraciones de cada instancia implementada de un paquete. También puede usar expresiones de propiedades para especificar restricciones en tiempo de ejecución para un paquete mediante la opción /set con la utilidad de símbolo del sistema dtexec . Por ejemplo, puede restringir el MaximumThreads utilizado por la transformación Ordenación o bien el MaxMemoryUsage de las transformaciones Fuzzy Grouping y Fuzzy Lookup. Si no presentan restricciones, estas transformaciones pueden almacenar en memoria caché grandes cantidades de datos en memoria.

Para especificar una expresión de propiedades para una de las propiedades de los objetos de flujo de datos mencionados en este tema, muestre la ventana Propiedades para la tarea Flujo de Datos seleccionando la tarea Flujo de Datos en la superficie Flujo de control del diseñador o seleccionando la pestaña Flujo de datos del diseñador sin seleccionar ningún componente o ruta de acceso individual. Seleccione la propiedad Expresiones y haga clic en los puntos suspensivos (…) para mostrar el cuadro de diálogo Editor de expresiones de propiedad . Despliegue la lista Propiedad para seleccionar una propiedad y, después, escriba una expresión en el cuadro de texto Expresión o haga clic en los puntos suspensivos (…) para mostrar el cuadro de diálogo Generador de expresiones .

La lista Propiedad muestra las propiedades disponibles solo para aquellos objetos de flujo de datos que ya haya colocado en la superficie Flujo de datos del diseñador. Por consiguiente, no puede utilizar la lista Propiedad para ver todas las posibles propiedades de los objetos de flujo de datos que admiten expresiones de propiedades. Por ejemplo, si ha colocado un origen ADO NET en la superficie del diseñador, la lista Propiedad contiene una entrada para la propiedad [ADO NET Source].[SqlCommand] . La lista también muestra muchas propiedades de la propia tarea Flujo de Datos.

Los valores de las propiedades de la siguiente lista se pueden especificar mediante expresiones de propiedades.

Orígenes de flujos de datos

Objeto Flujo de datos Propiedad
Origen ADO NET Propiedad TableOrViewName

Propiedad SQLCommand
Origen XML Propiedad XMLData

Propiedad XMLSchemaDefinition

Transformaciones de flujos de datos

Para obtener más información acerca de estas propiedades personalizadas, vea Transformation Custom Properties.

Objeto Flujo de datos Propiedad
División condicional, transformación Propiedad FriendlyExpression
Transformación Columna derivada Propiedad FriendlyExpression
Agrupación aproximada, transformación Propiedad MaxMemoryUsage
Búsqueda aproximada, transformación Propiedad MaxMemoryUsage
Transformación de búsqueda Propiedad SQLCommand

Propiedad SqlCommandParam
transformación Comando de OLE DB Propiedad SQLCommand
Muestreo de porcentaje, transformación Propiedad SamplingValue
Dinámica, transformación Propiedad PivotKeyValue
Muestreo de fila, transformación Propiedad SamplingValue
Ordenar, transformación Propiedad MaximumThreads
Anulación de dinamización, transformación Propiedad PivotKeyValue

Destinos de flujos de datos

Objeto Flujo de datos Propiedad
Destino ADO NET Propiedad TableOrViewName

Propiedad BatchSize

Propiedad CommandTimeOut
Destino de archivo plano Propiedad Header
Destino de SQL Server Compact Propiedad TableName
Destino de SQL Server Propiedad BulkInsertTableName

Propiedad BulkInsertFirstRow

Propiedad BulkInsertLastRow

Propiedad BulkInsertOrder

Propiedad Tiempo de espera