Propiedades comunes

Los objetos de flujo de datos en el modelo de objetos de MicrosoftSQL ServerIntegration 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 resultados. Muchas propiedades tienen valores de sólo 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

  • Columnas de entrada

  • Salidas

  • Columnas de resultados

Propiedades de componente

En el modelo de objeto 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 sólo lectura que son asignados en tiempo de ejecución por el motor de flujo de datos.

Propiedad

Tipo de datos

Descripción

ComponentClassID

Cadena

CLSID del componente.

ContactInfo

Cadena

Información de contacto para el programador de un componente.

Description

Cadena

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

Cadena

Identifica el componente.

IsDefaultLocale

Booleano

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.

Name

Cadena

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

Booleano

Indica si un componente tiene una salida de error.

ValidateExternalMetadata

Booleano

Indica si se validan los metadatos de columnas externas. El valor predeterminado de esta propiedad es True.

Version

Entero

Versión de un componente.

Propiedades de las entradas

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 sólo lectura que el motor de flujo de datos asigna en tiempo de ejecución.

Propiedad

Tipo de datos

Descripción

Description

Cadena

Descripción de la entrada.

ErrorOrTruncationOperation

Cadena

Una 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 failure y Redirect row.

HasSideEffects

Booleano

Indica si un componente se puede quitar del plan de ejecución del flujo de datos cuando no está asociado a un componente de nivel inferior y cuando RunInOptimizedMode es true.

ID

Entero

Valor que identifica la entrada de forma inequívoca.

IdentificationString

Cadena

Cadena que identifica la entrada.

IsSorted

Booleano

Indica si los datos de la entrada están ordenados.

Name

Cadena

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 failure y Redirect row.

Los destinos y algunas transformaciones no admiten salidas de error, y las propiedades ErrorRowDisposition y TruncationRowDisposition de estos componentes son de sólo 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 sólo 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 marcadores que especifican la comparación de columnas cuyo tipo de datos es carácter. Para obtener más información, vea Comparar datos de cadena.

Description

Cadena

Describe la columna de entrada.

ErrorOrTruncationOperation

Cadena

Una 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 failure y 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

Cadena

Cadena que identifica la columna de entrada.

LineageID

Entero

El Id. de columna para la columna de nivel superior.

Name

Cadena

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 Cómo 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 failure y Redirect row.

UpstreamComponentName

Cadena

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 las salidas

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 sólo lectura que son asignados en tiempo de ejecución por el motor de flujo de datos.

Propiedad

Tipo de datos

Descripción

DeleteOutputOnPathDetached

Booleano

Valor que determina si el motor de flujo de datos elimina la salida cuando ésta se separa de una ruta.

Description

Cadena

Describe la salida.

ErrorOrTruncationOperation

Cadena

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 failure y Redirect row.

ExclusionGroup

Entero

Valor que identifica un grupo de salidas mutuamente excluyentes.

HasSideEffects

Booleano

Valor que indica si un componente puede quitarse del plan de ejecución del flujo de datos cuando no está asociado con un componente de nivel superior y cuando RunInOptimizedMode es true.

ID

Entero

Valor que identifica la salida de forma inequívoca.

IdentificationString

Cadena

Cadena que identifica la salida.

IsErrorOut

Booleano

Indica si la salida es una salida de errores.

IsSorted

Booleano

Indica si la salida está ordenada. El valor predeterminado es False.

Nota importanteImportante
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 Cómo ordenar datos para las transformaciones Mezclar y Combinación de mezcla.

Name

Cadena

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 failure y Redirect row.

Propiedades de las columnas de resultados

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 sólo 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 marcadores que especifican la comparación de columnas cuyo tipo de datos es carácter. Para obtener más información, vea Comparar datos de cadena.

Description

Cadena

Describe la columna de resultados.

ErrorOrTruncationOperation

Cadena

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 failure y 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

Cadena

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.

Name

Cadena

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 Cómo ordenar datos para las transformaciones Mezclar y Combinación de mezcla.

SpecialFlags

Entero

Un valor que contiene los marcadores 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 failure y 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 columna 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 sólo lectura que son asignados en tiempo de ejecución por el motor de flujo de datos.

Propiedad

Tipo de datos

Descripción

Description

Cadena

Describe la columna externa.

ID

Entero

Valor que identifica la columna de forma inequívoca.

IdentificationString

Cadena

Cadena que identifica la columna.

Name

Cadena

Nombre de la columna de externa.

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

Propiedades del tipo 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 sólo 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

Entero (enumeración)

Tipo de datos Integration Services de la columna. Para obtener más información, vea Tipos de datos de Integration Services.

Length

Entero

Longitud de una columna en caracteres.

Precision

Entero

Precisión de una columna numérica.

Scale

Entero

Escala de una columna numérica.