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.

• Componentes

• Entradas

• Input columns

• Salidas

• Columnas de salida

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.

• Propiedades personalizadas de ADO NET

• Propiedades personalizadas de la tarea de control CDC

• Propiedades personalizadas del origen de CDC

• Propiedades personalizadas del destino de entrenamiento del modelo de minería de datos

• Propiedades personalizadas del destino DataReader

• Propiedades personalizadas del destino de procesamiento de dimensiones

• Propiedades personalizadas de Excel

• Propiedades personalizadas de archivo plano

• Propiedades personalizadas de los destinos de ODBC

• ODBC Source Custom Properties

• OLE DB Custom Properties Propiedades personalizadas de OLE DB

• Propiedades personalizadas del destino de procesamiento de particiones

• Propiedades personalizadas de archivo sin formato

• Propiedades personalizadas del destino de conjunto de registros

• Propiedades personalizadas del destino SQL Server Compact Edition

• Propiedades personalizadas del destino SQL Server

• Propiedades personalizadas de transformación

• Propiedades personalizadas del origen XML

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