Transformación Comando de OLE DB

Actualizado: 12 de diciembre de 2006

La transformación Comando de OLE DB ejecuta una instrucción SQL para cada fila en un flujo de datos. Por ejemplo, puede ejecutar una instrucción SQL que inserte, actualice o elimine filas en una tabla de base de datos.

Puede configurar el administrador de conexión OLE DB de las maneras siguientes:

• Proporcionar la instrucción SQL que la transformación ejecuta para cada fila.
• Especifica la cantidad de segundos que tienen que transcurrir antes de que la instrucción SQL agote el tiempo de espera.
• Especificar la página de códigos predeterminada.

Normalmente, la instrucción SQL incluye parámetros. Los valores de parámetro se almacenan en columnas externas en la entrada de transformación y al asignar una columna de entrada a una columna externa se asigna una columna de entrada a un parámetro. Por ejemplo, para buscar filas en la tabla DimProduct según el valor en su columna ProductKey y luego eliminarlas, puede asignar la columna externa denominada Param_0 a la columna de entrada denominada ProductKey y, a continuación, ejecutar la instrucción SQL DELETE FROM DimProduct WHERE ProductKey = ?. La transformación Comando de OLE DB proporciona los nombres de parámetro y no puede modificarlos. Los nombres de parámetro son Param_0, Param_1 y así sucesivamente.

Si configura la transformación Comando de OLE DB mediante el cuadro de diálogo Editor avanzado, los parámetros de la instrucción SQL se pueden asignar automáticamente a las columnas externas en la entrada de transformación y las características de cada parámetro se definen haciendo clic en el botón Actualizar. Sin embargo, si el proveedor OLE DB que usa la transformación Comando de OLE DB no admite la derivación de la información de parámetros del parámetro, debe configurar las columnas externas manualmente. Esto significa que debe agregar una columna por cada parámetro a la entrada externa a la transformación, actualizar los nombres de columna para que usen nombres como Param_0, especificar el valor de la propiedad DBParamInfoFlags y asignar las columnas de entrada que contienen valores de parámetro a las columnas externas.

El valor de DBParamInfoFlags representa las características del parámetro. Por ejemplo, el valor 1 especifica que el parámetro es un parámetro de entrada, y el valor 65 especifica que el parámetro es un parámetro de entrada y puede contener un valor NULL. Los valores deben coincidir con los valores de la enumeración OLE DB DBPARAMFLAGSENUM. Para obtener más información, vea la documentación de referencia de OLE DB.

La transformación Comando de OLE DB incluye la propiedad personalizada SQLCommand. Esta propiedad se puede actualizar a través de una expresión de propiedad, al cargar el paquete. Para obtener más información, vea Referencia de expresiones de Integration Services, Usar expresiones de propiedad en paquetes y Transformation Custom Properties.

Esta transformación tiene una entrada, una salida normal y una salida de error.

Solucionar problemas de la transformación Comando de OLE DB

A partir del Service Pack 2 (SP2) de Microsoft SQL Server 2005, puede registrar las llamadas realizadas por la transformación Comando de OLE DB a proveedores de datos externos. Puede utilizar esta nueva capacidad de registro para solucionar problemas relacionados con las conexiones y los comandos a orígenes de datos externos realizados por la transformación Comando de OLE DB. Para registrar las llamadas que la transformación Comando de OLE DB realiza a un proveedor de datos externo, habilite el registro de paquetes y seleccione el evento Diagnostic en el nivel de paquete. Para obtener más información, vea Solucionar problemas de ejecución de paquetes.

Configurar la transformación Comando de OLE DB

Puede establecer propiedades a través del Diseñador SSIS o mediante programación.

Para obtener más información acerca de las propiedades que puede establecer a través del cuadro de diálogo Editor avanzado o mediante programación, haga clic en uno de los temas siguientes:

• Common Properties
• Transformation Custom Properties

Para obtener más información sobre cómo establecer valores de propiedades, haga clic en uno de los temas siguientes:

• Cómo configurar la transformación Comando de OLE DB
• Cómo establecer las propiedades de un componente de flujo de datos en la ventana Propiedades
• Cómo configurar las propiedades de un componente de flujo de datos mediante el Editor avanzado

Vea también

Conceptos

Crear un flujo de datos de paquetes
Transformaciones de Integration Services

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión	Historial
12 de diciembre de 2006	Contenido nuevo: Se ha agregado información acerca de la forma en que el SP2 de SQL Server 2005 incluye nuevos mensajes de registro que permiten a los usuarios solucionar problemas relacionados con las llamadas realizadas por la transformación a proveedores de datos externos.
5 de diciembre de 2005	Contenido nuevo: Se agregó información sobre el uso de expresiones de propiedades con la propiedad personalizada SQLCommand.