Compartir a través de


Transformación Comando de OLE DB

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 conexiones 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 Expresiones de Integration Services (SSIS), Usar expresiones de propiedad en paquetes y Propiedades personalizadas de transformación.

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

Registro

Puede registrar las llamadas realizadas por la transformación Comando de OLE DB a proveedores de datos externos. Puede utilizar esta 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 los proveedores de datos externos, habilite el registro de paquetes y seleccione el evento Diagnostic en el nivel de paquete. Para obtener más información, vea Herramientas para solucionar problemas con la ejecución de paquetes.

Tareas relacionadas

Puede configurar la transformación mediante el Diseñador de SSIS o el modelo de objetos. Para obtener más información sobre cómo configurar la transformación mediante el Diseñador SSIS, vea Configurar la transformación Comando de OLE DB. Vea la Guía del desarrollador para obtener información detallada sobre la configuración mediante programación de esta transformación.

Contenido relacionado

Icono de Integration Services (pequeño) Mantenerse al día con Integration Services

Para obtener las descargas, los artículos, los ejemplos y los vídeos más recientes de Microsoft, así como una selección de soluciones de la comunidad, visite la página de Integration Services en MSDN:


Para recibir notificaciones automáticas de estas actualizaciones, suscríbase a las fuentes RSS disponibles en la página.

Vea también

Conceptos

Flujo de datos

Transformaciones de Integration Services