Propiedades personalizadas de los destinos

Los objetos de flujo de datos de los modelos 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 salida. Las propiedades personalizadas sólo están disponibles en tiempo de ejecución y no se incluyen en la documentación de referencia de la programación administrada de Integration Services.

En este tema se muestran y describen las propiedades personalizadas de los destinos de flujo de datos.

  • Destino ADO .NET

  • Destino de aprendizaje del modelo de minería de datos

  • Destino de DataReader

  • Destino de procesamiento de dimensiones

  • Destino de Excel

  • Destino de archivo plano

  • Destino OLE DB

  • Destino de procesamiento de particiones

  • Destino de archivo sin formato

  • Destino Conjunto de registros

  • Destino SQL Server Compact Edition

  • Destino SQL Server

Para obtener información acerca de las propiedades comunes a la mayor parte de los objetos de flujo de datos, vea Propiedades comunes.

Algunas propiedades de los destinos se pueden establecer con expresiones de propiedad, según se indica en este tema. Para obtener más información, vea Propiedades de flujo de datos que se pueden establecer utilizando expresiones.

Destino ADO .NET

El destino ADO.NET tiene propiedades personalizadas y propiedades comunes a todos los componentes de flujo de datos.

En la tabla siguiente se describen las propiedades personalizadas del destino ADO.NET. Todas las propiedades son de lectura/escritura. Estas propiedades no están disponibles en el Editor de destinos ADO .NET, pero se pueden establecer con el Editor avanzado.

Propiedad

Tipo de datos

Descripción

BatchSize

Número entero

Número de filas de un lote que se envía al servidor. El valor 0 indica que el tamaño del lote coincide con el tamaño del búfer interno. El valor predeterminado de esta propiedad es 0.

CommandTimeOut

Integer

Número máximo de segundos que el comando SQL se puede ejecutar antes de superar el tiempo de espera. Si el valor es 0, indica un tiempo infinito. El valor predeterminado de esta propiedad es 0.

TableOrViewName

String

Nombre de la tabla o vista de destino.

Para obtener más información, vea Destino ADO NET.

Propiedades personalizadas del destino de aprendizaje del modelo de minería de datos

El destino de aprendizaje del modelo de minería de datos tiene propiedades personalizadas y propiedades comunes a todos los componentes de flujo de datos.

En la tabla siguiente se describen las propiedades personalizadas del destino de aprendizaje del modelo de minería de datos. Todas las propiedades son de lectura/escritura.

Propiedad

Tipo de datos

Descripción

ASConnectionId

String

Identificador único del administrador de conexión.

ASConnectionString

String

Cadena de conexión a una instancia de Analysis Services o a un proyecto de Analysis Services.

ObjectRef

String

Etiqueta XML que identifica la estructura de minería de datos que la transformación usa:

La entrada y las columnas de entrada del destino de aprendizaje del modelo de minería de datos no tienen ninguna propiedad personalizada.

Para obtener más información, vea Destino de entrenamiento del modelo de minería de datos.

Propiedades personalizadas del destino DataReader

El destino DataReader tiene propiedades personalizadas y propiedades comunes a todos los componentes de flujo de datos.

En la tabla siguiente se describen las propiedades personalizadas del destino DataReader. Todas las propiedades excepto DataReader son de lectura/escritura.

Nombre de la propiedad

Tipo de datos

Descripción

DataReader

String

Nombre de la clase del destino DataReader.

FailOnTimeout

Boolean

Indica si generar un error cuando se produce un ReadTimeout. El valor predeterminado de esta propiedad es False.

ReadTimeout

Integer

Número de milisegundos que transcurren antes de que se agote el tiempo de espera. El valor predeterminado de esta propiedad es 30000 (30 segundos).

La entrada y las columnas de entrada del destino DataReader no tienen ninguna propiedad personalizada.

Para obtener más información, vea Destino de DataReader.

Propiedades personalizadas del destino Procesamiento de dimensiones

El destino Procesamiento de dimensiones tiene propiedades personalizadas y propiedades comunes a todos los componentes de flujo de datos.

En la tabla siguiente se describen las propiedades personalizadas del destino Procesamiento de dimensiones. Todas las propiedades son de lectura/escritura.

Propiedad

Tipo de datos

Descripción

ASConnectionString

String

Cadena de conexión a una instancia de Analysis Services o a un proyecto de Analysis Services.

KeyDuplicate

Integer (enumeración)

Cuando UseDefaultConfiguration es False, valor que indica cómo administrar los errores de clave duplicada. Los valores posibles son IgnoreError (0), ReportAndContinue (1) y ReportAndStop (2). El valor predeterminado de esta propiedad es IgnoreError (0).

KeyErrorAction

Integer (enumeración)

Cuando UseDefaultConfiguration es False, valor que indica cómo administrar los errores de clave. Los valores posibles son ConvertToUnknown (0) y DiscardRecord (1). El valor predeterminado de esta propiedad es ConvertToUnknown (0).

KeyErrorLimit

Integer

Cuando UseDefaultConfiguration es False, el límite superior de los errores de clave que están habilitados.

KeyErrorLimitAction

Integer (enumeración)

Cuando UseDefaultConfiguration es False, valor que indica la acción que se realizará cuando se alcance KeyErrorLimit. Los valores posibles son StopLogging (1) y StopProcessing (0). El valor predeterminado de esta propiedad es StopProcessing (0).

KeyErrorLogFile

String

Cuando UseDefaultConfiguration es False, ruta de acceso y nombre del archivo de registro de errores.

KeyNotFound

Integer (enumeración)

Cuando UseDefaultConfiguration es False, valor que indica cómo administrar los errores de clave que falta. Los valores posibles son IgnoreError (0), ReportAndContinue (1) y ReportAndStop (2). El valor predeterminado de esta propiedad es IgnoreError (0).

NullKeyConvertedToUnknown

Integer (enumeración)

Cuando UseDefaultConfiguration es False, valor que indica cómo administrar las claves Null convertidas al valor Unknown. Los valores posibles son IgnoreError (0), ReportAndContinue (1) y ReportAndStop (2). El valor predeterminado de esta propiedad es IgnoreError (0).

NullKeyNotAllowed

Integer (enumeración)

Cuando UseDefaultConfiguration es False, valor que indica cómo administrar los valores NULL no permitidos. Los valores posibles son IgnoreError (0), ReportAndContinue (1) y ReportAndStop (2). El valor predeterminado de esta propiedad es IgnoreError (0).

ProcessType

Integer (enumeración)

Tipo de procesamiento de dimensiones utilizado por la transformación. Los valores posibles son ProcessAdd (1) (incremental), ProcessFull (0) y ProcessUpdate (2).

UseDefaultConfiguration

Boolean

Valor que especifica si la transformación usa la configuración de errores predeterminada. Si esta propiedad es False, la transformación incluye información sobre el procesamiento de los errores.

La entrada y las columnas de entrada del destino Procesamiento de dimensiones no tienen ninguna propiedad personalizada.

Para obtener más información, vea Destino de procesamiento de dimensiones.

Propiedades personalizadas del destino Excel

El destino Excel tiene propiedades personalizadas y propiedades comunes a todos los componentes de flujo de datos.

En la tabla siguiente se describen las propiedades personalizadas del destino Excel. Todas las propiedades son de lectura/escritura.

Nombre de la propiedad

Tipo de datos

Descripción

AccessMode

Integer (enumeración)

Valor que especifica cómo tiene acceso el destino a su base de datos de destino.

Esta propiedad admite cualquiera de los siguientes valores:

  • OpenRowset (0): se proporciona el nombre de una tabla o vista.

  • OpenRowset from Variable (1): se proporciona el nombre de una variable que contiene el nombre de una tabla o vista.

  • OpenRowset Using Fastload (3): se proporciona el nombre de una tabla o vista.

  • OpenRowset Using Fastload from Variable (4): se proporciona el nombre de una variable que contiene el nombre de una tabla o vista.

  • SQL Command (2): se proporciona una instrucción SQL.

CommandTimeout

Integer

Número máximo de segundos que puede ejecutarse el comando SQL antes de superar el tiempo de espera. Si el valor es 0, indica un tiempo infinito. El valor predeterminado de esta propiedad es 0.

NotaNota
Esta propiedad no está disponible en el Editor de destino de Excel, pero se puede establecer con el Editor avanzado.

FastLoadKeepIdentity

Boolean

Valor que especifica si se copian los valores de identidad cuando se cargan los datos. Esta propiedad sólo está disponible cuando se usa una de las opciones de carga rápida. El valor predeterminado de esta propiedad es False.

FastLoadKeepNulls

Boolean

Valor que especifica si se copian los valores Null cuando se cargan los datos. Esta propiedad sólo está disponible con una de las opciones de carga rápida. El valor predeterminado de esta propiedad es False.

FastLoadMaxInsertCommitSize

Integer

Valor que especifica el tamaño de lote que el destino Excel intenta confirmar en operaciones de carga rápida. El valor predeterminado, 0, indica una operación de confirmación única después de que se procesen todas las filas.

FastLoadOptions

String

Recopilación de opciones de carga rápida. Las opciones de carga rápida incluyen el bloqueo de las tablas y la comprobación de las restricciones. Puede especificar una, ambas o ninguna.

NotaNota
Algunas opciones de esta propiedad no están disponibles en el Editor de destino de Excel, pero pueden establecerse con el Editor avanzado.

OpenRowset

String

Cuando AccessMode es OpenRowset, nombre de la tabla o vista a la que el destino Excel tiene acceso.

OpenRowsetVariable

String

Cuando AccessMode es OpenRowset from variable, nombre de la variable que contiene el nombre de la tabla o vista a la que el destino Excel tiene acceso.

SqlCommand

String

Cuando AccessMode es SQL Command, instrucción Transact-SQL que el destino Excel utiliza para especificar las columnas de destino para los datos.

La entrada y las columnas de entrada del destino Excel no tienen ninguna propiedad personalizada.

Para obtener más información, vea Destino de Excel.

Propiedades personalizadas del destino Archivo plano

El destino Archivo plano tiene propiedades personalizadas y propiedades comunes a todos los componentes de flujo de datos.

En la tabla siguiente se describen las propiedades personalizadas del destino Archivo plano. Todas las propiedades son de lectura/escritura.

Nombre de la propiedad

Tipo de datos

Descripción

Header

String

Bloque de texto que se inserta en el archivo antes de que se escriban datos.

Puede especificar el valor de esta propiedad con una expresión de propiedad.

Overwrite

Boolean

Valor que especifica si sobrescribir o anexar a un archivo de destino existente que tiene el mismo nombre. El valor predeterminado de esta propiedad es True.

La entrada y las columnas de entrada del destino Archivo plano no tienen ninguna propiedad personalizada.

Para obtener más información, vea Destino de archivo plano.

Propiedades personalizadas del destino OLE DB

El destino OLE DB tiene propiedades personalizadas y propiedades comunes a todos los componentes de flujo de datos.

En la tabla siguiente se describen las propiedades personalizadas del destino OLE DB. Todas las propiedades son de lectura/escritura.

[!NOTA]

Las opciones de carga rápida enumeradas aquí (FastLoadKeepIdentity, FastLoadKeepNulls y FastLoadOptions) corresponden a las propiedades con nombre similar que expone la interfaz IRowsetFastLoad implementada por el proveedor Microsoft OLE DB para SQL Server (SQLOLEDB). Para obtener más información, busque IRowsetFastLoad en la MSDN Library.

Nombre de la propiedad

Tipo de datos

Descripción

AccessMode

Integer (enumeración)

Valor que especifica cómo tiene acceso el destino a su base de datos de destino.

Esta propiedad admite cualquiera de los siguientes valores:

  • OpenRowset (0): se proporciona el nombre de una tabla o vista.

  • OpenRowset from Variable (1): se proporciona el nombre de una variable que contiene el nombre de una tabla o vista.

  • OpenRowset Using Fastload (3): se proporciona el nombre de una tabla o vista.

  • OpenRowset Using Fastload from Variable (4): se proporciona el nombre de una variable que contiene el nombre de una tabla o vista.

  • SQL Command (2): se proporciona una instrucción SQL.

AlwaysUseDefaultCodePage

Boolean

Valor que indica si usar el valor de la propiedad DefaultCodePage para cada columna, o intentar derivar la página de códigos de la configuración regional de cada columna. El valor predeterminado de esta propiedad es False.

CommandTimeout

Integer

Número máximo de segundos que el comando SQL se puede ejecutar antes de superar el tiempo de espera. Si el valor es 0, indica un tiempo infinito. El valor predeterminado de esta propiedad es 0.

NotaNota
Esta propiedad no está disponible en el Editor de destino OLE DB, pero se puede establecer con el Editor avanzado.

DefaultCodePage

Integer

Página de códigos predeterminada asociada al destino OLE DB.

FastLoadKeepIdentity

Boolean

Valor que especifica si se copian los valores de identidad cuando se cargan los datos. Esta propiedad sólo está disponible con una de las opciones de carga rápida. El valor predeterminado de esta propiedad es False. Esta propiedad corresponde a SSPROP_FASTLOADKEEPIDENTITY de la propiedad IRowsetFastLoad (OLE DB) de OLE DB.

FastLoadKeepNulls

Boolean

Valor que especifica si se copian los valores Null cuando se cargan los datos. Esta propiedad sólo está disponible con una de las opciones de carga rápida. El valor predeterminado de esta propiedad es False. Esta propiedad corresponde a SSPROP_FASTLOADKEEPNULLS de la propiedad IRowsetFastLoad (OLE DB) de OLE DB.

FastLoadMaxInsertCommitSize

Integer

Valor que especifica el tamaño de lote que el destino OLE DB intenta confirmar en operaciones de carga rápida. El valor predeterminado, 0, indica una operación de confirmación única después de que se procesen todas las filas.

FastLoadOptions

String

Recopilación de opciones de carga rápida. Las opciones de carga rápida incluyen el bloqueo de las tablas y la comprobación de las restricciones. Puede especificar una, ambas o ninguna. Esta propiedad corresponde a SSPROP_FASTLOADOPTIONS de la propiedad IRowsetFastLoad de OLE DB y acepta opciones de cadena como CHECK_CONSTRAINTS y TABLOCK.

NotaNota
Algunas opciones de esta propiedad no están disponibles en el Editor de destino de Excel, pero pueden establecerse con el Editor avanzado.

OpenRowset

String

Cuando AccessMode es OpenRowset, nombre de la tabla o vista a la que el destino OLE DB tiene acceso.

OpenRowsetVariable

String

Cuando AccessMode es OpenRowset from variable, nombre de la variable que contiene el nombre de la tabla o vista a la que el destino OLE DB tiene acceso.

SqlCommand

String

Cuando AccessMode es SQL Command, instrucción Transact-SQL que el destino OLE DB utiliza para especificar las columnas de destino para los datos.

La entrada y las columnas de entrada del destino OLE DB no tienen ninguna propiedad personalizada.

Para obtener más información, vea Destino de OLE DB.

Propiedades personalizadas del destino Procesamiento de particiones

El destino Procesamiento de particiones tiene propiedades personalizadas y propiedades comunes a todos los componentes de flujo de datos.

En la tabla siguiente se describen las propiedades personalizadas del destino Procesamiento de particiones. Todas las propiedades son de lectura/escritura.

Propiedad

Tipo de datos

Descripción

ASConnectionString

String

Cadena de conexión a un proyecto de Analysis Services o a una instancia de Analysis Services.

KeyDuplicate

Integer (enumeración)

Cuando UseDefaultConfiguration es False, valor que indica cómo administrar los errores de clave duplicada. Los valores posibles son IgnoreError (0), ReportAndContinue (1) y ReportAndStop (2). El valor predeterminado de esta propiedad es IgnoreError (0).

KeyErrorAction

Integer (enumeración)

Cuando UseDefaultConfiguration es False, valor que indica cómo administrar los errores de clave. Los valores posibles son ConvertToUnknown (0) y DiscardRecord (1). El valor predeterminado de esta propiedad es ConvertToUnknown (0).

KeyErrorLimit

Integer

Cuando UseDefaultConfiguration es False, el límite superior de errores de clave permitidos.

KeyErrorLimitAction

Integer (enumeración)

Cuando UseDefaultConfiguration es False, valor que indica la acción que se realizará cuando se alcance KeyErrorLimit. Los valores posibles son StopLogging (1) y StopProcessing (0). El valor predeterminado de esta propiedad es StopProcessing (0).

KeyErrorLogFile

String

Cuando UseDefaultConfiguration es False, ruta de acceso y nombre del archivo de registro de errores.

KeyNotFound

Integer (enumeración)

Cuando UseDefaultConfiguration es False, valor que indica cómo administrar los errores de clave que falta. Los valores posibles son IgnoreError (0), ReportAndContinue (1) y ReportAndStop (2). El valor predeterminado de esta propiedad es ReportAndContinue (1).

NullKeyConvertedToUnknown

Integer (enumeración)

Cuando UseDefaultConfiguration es False, valor que indica cómo administrar las claves Null convertidas al valor Unknown. Los valores posibles son IgnoreError (0), ReportAndContinue (1) y ReportAndStop (2). El valor predeterminado de esta propiedad es IgnoreError (0).

NullKeyNotAllowed

Integer (enumeración)

Cuando UseDefaultConfiguration es False, valor que indica cómo administrar los valores NULL no permitidos. Los valores posibles son IgnoreError (0), ReportAndContinue (1) y ReportAndStop (2). El valor predeterminado de esta propiedad es ReportAndContinue (1).

ProcessType

Integer (enumeración)

Tipo de procesamiento de particiones utilizado por la transformación. Los valores posibles son ProcessAdd (1) (incremental), ProcessFull (0) y ProcessUpdate (2).

UseDefaultConfiguration

Boolean

Valor que especifica si la transformación usa la configuración de errores predeterminada. Si esta propiedad es False, la transformación utiliza los valores de propiedades personalizadas de control de errores que se enumeran en esta tabla, incluidos KeyDuplicate, KeyErrorAction, etc.

La entrada y las columnas de entrada del destino Procesamiento de particiones no tienen ninguna propiedad personalizada.

Para obtener más información, vea Destino de procesamiento de particiones.

Propiedades personalizadas del destino de archivo sin formato

El destino de archivo sin formato tiene propiedades personalizadas y propiedades comunes a todos los componentes de flujo de datos.

En la tabla siguiente se describen las propiedades personalizadas del destino de archivo sin formato. Todas las propiedades son de lectura/escritura.

Nombre de la propiedad

Tipo de datos

Descripción

AccessMode

Integer (enumeración)

Valor que especifica si la propiedad FileName contiene un nombre de archivo, o el nombre de una variable que contiene un nombre de archivo. Las opciones son File name (0) y File name from variable (1).

FileName

String

Nombre del archivo donde escribe el destino de archivo sin formato.

WriteOption

Integer (enumeración)

Valor que especifica si el destino de archivo sin formato elimina un archivo existente que tiene el mismo nombre. Las opciones son Create Always (0), Create Once (1), Truncate and Append (3) y Append (2). El valor predeterminado de esta propiedad es Create Always (0).

[!NOTA]

Una operación de anexión requiere que los metadatos de los datos anexados coincidan con los metadatos de los datos que ya están en el archivo.

La entrada y las columnas de entrada del destino de archivo sin formato no tienen ninguna propiedad personalizada.

Para obtener más información, vea Destino de archivo sin formato.

Propiedades personalizadas del destino Conjunto de registros

El destino Conjunto de registros tiene propiedades personalizadas y propiedades comunes a todos los componentes de flujo de datos.

En la tabla siguiente se describen las propiedades personalizadas del destino Conjunto de registros. Todas las propiedades son de lectura/escritura.

Nombre de la propiedad

Tipo de datos

Descripción

VariableName

String

Nombre de la variable que contiene el conjunto de registros ADO.

La entrada y las columnas de entrada del destino Conjunto de registros no tienen ninguna propiedad personalizada.

Para obtener más información, vea Destino de conjunto de registros.

Propiedades personalizadas del destino SQL Server Compact Edition

El destino de SQL Server Compact tiene propiedades personalizadas y propiedades comunes a todos los componentes de flujo de datos.

En la tabla siguiente se describen las propiedades personalizadas del destino de SQL Server Compact. Todas las propiedades son de lectura/escritura.

Nombre de la propiedad

Tipo de datos

Descripción

TableName

String

Nombre de la tabla de destino de una base de datos de SQL Server Compact.

Puede especificar el valor de esta propiedad con una expresión de propiedad.

La entrada y las columnas de entrada del destino de SQL Server Compact no tienen ninguna propiedad personalizada.

Para obtener más información, vea Destino de SQL Server Compact Edition.

Propiedades personalizadas del destino SQL Server

El destino SQL Server tiene propiedades personalizadas y propiedades comunes a todos los componentes de flujo de datos.

En la tabla siguiente se describen las propiedades personalizadas del destino SQL Server. Todas las propiedades son de lectura/escritura.

Nombre de la propiedad

Tipo de datos

Descripción

AlwaysUseDefaultCodePage

Boolean

Obliga a usar el valor de la propiedad DefaultCodePage. El valor predeterminado de esta propiedad es False.

BulkInsertCheckConstraints

Boolean

Valor que especifica si la inserción masiva comprueba las restricciones. El valor predeterminado de esta propiedad es True.

BulkInsertFireTriggers

Boolean

Valor que especifica si la inserción masiva activa desencadenadores en las tablas. El valor predeterminado de esta propiedad es False.

BulkInsertFirstRow

Integer

Valor que especifica la primera fila que insertar. El valor predeterminado de esta propiedad es -1, lo que indica que no se ha asignado ningún valor.

BulkInsertKeepIdentity

Boolean

Valor que especifica si los valores se pueden insertar en las columnas de identidad. El valor predeterminado de esta propiedad es False.

BulkInsertKeepNulls

Boolean

Valor que especifica si la inserción masiva mantiene los valores Null. El valor predeterminado de esta propiedad es False.

BulkInsertLastRow

Integer

Valor que especifica la última fila que insertar. El valor predeterminado de esta propiedad es -1, lo que indica que no se ha asignado ningún valor.

BulkInsertMaxErrors

Integer

Valor que especifica el número de errores que se pueden producir antes de que se detenga la inserción masiva. El valor predeterminado de esta propiedad es -1, lo que indica que no se ha asignado ningún valor.

BulkInsertOrder

String

Nombres de las columnas de orden. Las columnas se pueden ordenar en sentido ascendente o descendente. Si se utilizan varias columnas de orden, los nombres de columna están separados por comas.

BulkInsertTableName

String

Tabla o vista de SQL Server en la base de datos a la que se copian los datos.

BulkInsertTablock

Boolean

Valor que especifica si la tabla se bloquea durante la inserción masiva. El valor predeterminado de esta propiedad es True.

DefaultCodePage

Integer

Página de códigos que se usa cuando no hay información disponible del origen de datos.

MaxInsertCommitSize

Integer

Valor que especifica el número máximo de filas que insertar en un lote. Cuando el valor es cero, todas las filas se insertan en un único lote.

Timeout

Integer

Valor que especifica el número de segundos que el destino SQL Server espera antes de la terminación si no hay ningún dato disponible para la inserción. El valor 0 significa que el destino SQL Server no agotará el tiempo de espera. El valor predeterminado de esta propiedad es 30.

La entrada y las columnas de entrada del destino SQL Server no tienen ninguna propiedad personalizada.

Para obtener más información, vea Destino de SQL Server.

Historial de cambios

Contenido actualizado

  • Se han agregado valores numéricos para las siguientes propiedades:

    • Las propiedades KeyDuplicate, KeyErrorAction, KeyErrorLimitAction, KeyNotFound, NullKeyConvertedToUnknown, NullKeyNotAllowed y ProcessType del destino de procesamiento de dimensiones.

    • La propiedad AccessMode del destino Excel.

    • La propiedad AccessMode del destino OLE DB.

    • Las propiedades KeyDuplicate, KeyErrorAction, KeyErrorLimitAction, KeyNotFound, NullKeyConvertedToUnknown, NullKeyNotAllowed y ProcessType del destino de procesamiento de particiones.

    • Las propiedades AccessMode y WriteOption del destino de archivo sin formato.