Artículo
03/30/2012

Propiedades personalizadas de los destinos

Los objetos de flujo de datos de los modelos 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. Las propiedades personalizadas solo 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	Número entero	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	Cadena	Nombre de la tabla o vista de destino.
UseBulkInsertWhenAvailable	Booleano	Un valor que especifica si se debe utilizar la interfaz System.Data.SqlClient..::..SqlBulkCopy para mejorar el rendimiento de las operaciones de inserción masiva. Solo determinados proveedores de ADO.NET admiten esta interfaz. El valor predeterminado es True.

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 conexiones.
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. Nota 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 solo 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 solo 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	Colecció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. Nota 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.

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. Nota 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 solo 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 solo 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, 2147483647, indica una operación de confirmación única después de que se procesen todas las filas.
FastLoadOptions	String	Colecció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. Nota 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.

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 de la misma en el 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.