Saltar al contenido

Actividad de Inserción en Base de Datos

Introducción

Una actividad de Inserción en Base de Datos, utilizando su conexión a la base de datos, inserta nuevos datos en la base de datos configurada y está destinada a ser utilizada como un objetivo para consumir datos en una operación.

La actividad de Inserción se utiliza para crear nuevos registros en la base de datos configurada. Si en su lugar desea insertar registros si no existen ya, así como actualizar registros si existen, utilice una actividad de Upsert en Base de Datos.

Crear una actividad de Inserción en Base de Datos

Una instancia de una actividad de Inserción en Base de Datos se crea a partir de una conexión a la base de datos utilizando su tipo de actividad Inserción.

Para crear una instancia de una actividad, arrastre el tipo de actividad al lienzo de diseño o copie el tipo de actividad y péguelo en el lienzo de diseño. Para más detalles, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Una actividad de Inserción en Base de Datos existente se puede editar desde estas ubicaciones:

Configurar una actividad de Inserción en Base de Datos

Siga estos pasos para configurar una actividad de Inserción en Base de Datos:

Inserción en un solo objeto

Sigue estos pasos si la inserción en la base de datos es a un solo objeto y no necesitas crear ninguna unión con otros objetos. Si necesitas unir múltiples objetos, consulta en su lugar Inserción en múltiples objetos.

Paso 1: Ingresa un nombre y selecciona un objeto

  • Nombre: Ingresa un nombre para identificar la actividad de la base de datos. El nombre debe ser único para cada actividad de Inserción en la base de datos y no debe contener barras inclinadas (/) o dos puntos (:).

  • Proporciona la referencia de los nombres de las tablas: Esta sección muestra las tablas disponibles en el punto final de la base de datos utilizando cualquier filtro aplicado, después de usar el ícono de refresco para la carga inicial de objetos. Si hay un gran número de objetos en la base de datos, se recomienda filtrar los objetos utilizando Ver o Buscar antes de refrescar.

    • Ver: Usa el menú desplegable para filtrar la lista de objetos mostrados a uno de "Tablas, Vistas", "Tablas", "Vistas", o "Tablas del Sistema". Por defecto, se muestra la vista "Tablas, Vistas".

    • Buscar: Ingresa el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de objetos. La búsqueda no distingue entre mayúsculas y minúsculas. La lista de objetos puede filtrarse automáticamente o puede que necesites refrescar la lista, dependiendo de si los objetos ya han sido recuperados:

      • Si buscas en objetos que ya han sido recuperados de la base de datos y ya aparecen en la lista, cualquier término de búsqueda escrito en el cuadro de búsqueda filtra automáticamente la lista.

      • Si buscas en objetos que aún no han sido recuperados, por ejemplo, al intentar limitar el número de objetos recuperados para bases de datos con un gran número de objetos, utiliza el ícono de refresco junto al cuadro de búsqueda para obtener los objetos de la base de datos utilizando el filtro.

      Nota

      Para bases de datos que no admiten la búsqueda en objetos, como Microsoft Access, no se devuelven resultados.

    • Actualizar: Haga clic en el ícono de actualización para cargar o recargar tablas desde el punto final de la base de datos. Esto debe usarse para la carga inicial de cualquier objeto. Además, también puede ser útil si ha agregado recientemente objetos a la base de datos, o si tiene criterios de búsqueda adicionales que desea aplicar antes de recuperar objetos de la base de datos.

    • Permitir la truncación de campos de caracteres para evitar errores de longitud de campo: Seleccione esta casilla para permitir que los campos se trunquen según sea necesario si el campo de destino es más pequeño que el campo de origen. Está desmarcada por defecto para nuevas actividades creadas después de la versión 11.39 de Harmony. Cuando esta casilla se deja desmarcada y los datos sobredimensionados pasan, se informa un estado de operación Error. Si la casilla está seleccionada, se informa un estado de Éxito con Información en su lugar, y los registros de operación dirán que Uno o más valores fueron truncados al insertar y/o actualizar el campo.

    • Incluir el esquema/propietario en los nombres de las tablas: Seleccione esta casilla para incluir el esquema en los nombres de las tablas. Esto puede ser útil si utiliza el mismo nombre de tabla en múltiples esquemas (como para desarrollo y producción) para permitirle ver y seleccionar la tabla en el esquema correcto.

    • Proporcionar la referencia de los nombres de las tablas: La lista de objetos se muestra en una columna a la izquierda. Haga clic en un solo objeto para agregarlo a la tabla a la derecha. Si está insertando en múltiples objetos que necesitan ser unidos, consulte Inserción de múltiples objetos.

      Consejo

      Si la lista no se llena con objetos disponibles incluso después de aplicar un filtro, la conexión a la base de datos puede no ser exitosa. Asegúrese de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.

  • Tabla de objetos seleccionados: El objeto seleccionado se muestra en una tabla a la derecha. Las columnas de esta tabla no son relevantes para inserciones de un solo objeto y no se pueden editar, excepto para eliminar el objeto (pase el cursor sobre la columna de la derecha y haga clic en el ícono de eliminar ). Si está insertando en múltiples objetos que necesitan ser unidos, consulte Inserción de múltiples objetos.

  • Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Paso 2: Revisar el esquema de datos

  • Esquema de datos: Se muestra el esquema de datos de destino. Si la operación utiliza una transformación, los esquemas de datos se mostrarán nuevamente más adelante durante el proceso de mapeo de transformación, donde puede mapear a campos de destino utilizando objetos de origen, scripts, variables, valores personalizados y más.

    Nota

    Los datos se transfieren tal como se proporcionan. Si hay desajustes en la longitud de los datos entre los campos de origen y destino, puede utilizar Funciones de cadena para recortar los datos.

    Nota

    Para actualizar un esquema de datos en una actividad existente, debe avanzar a través de cada paso de configuración de actividad nuevamente, realizando al menos un cambio (como agregar y eliminar un carácter del final del nombre de la actividad) para forzar una actualización del esquema.

  • Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Finalizado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

  • Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Inserción de múltiples objetos

Sigue estos pasos si la inserción en la base de datos es para múltiples objetos y necesitas crear uniones entre ellos. Para insertar solo en un único objeto, sin uniones, consulta en su lugar Inserción de un solo objeto.

Paso 1: Ingresa un nombre y selecciona objetos

  • Nombre: Ingresa un nombre para identificar la actividad de la base de datos. El nombre debe ser único para cada actividad de Inserción en la base de datos y no debe contener barras diagonales (/) ni dos puntos (:).

  • Proporciona la referencia de los nombres de las tablas: Esta sección muestra las tablas disponibles en el punto final de la base de datos utilizando cualquier filtro aplicado, después de usar el ícono de refresco para la carga inicial de objetos. Si hay un gran número de objetos en la base de datos, se recomienda filtrar los objetos utilizando Ver o Buscar antes de refrescar.

  • Ver: Usa el menú desplegable para filtrar la lista de objetos mostrados a uno de "Tablas, Vistas", "Tablas", "Vistas", o "Tablas del Sistema". Por defecto, se muestra la vista "Tablas, Vistas".

    • Buscar: Ingresa el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de objetos. La búsqueda no distingue entre mayúsculas y minúsculas. La lista de objetos puede filtrarse automáticamente o puede que necesites refrescar la lista, dependiendo de si los objetos ya han sido recuperados:

      • Si buscas en objetos que ya han sido recuperados de la base de datos y ya aparecen en la lista, cualquier término de búsqueda escrito en el cuadro de búsqueda filtra automáticamente la lista.

      • Si buscas en objetos que aún no han sido recuperados, por ejemplo, al intentar limitar el número de objetos recuperados para bases de datos con un gran número de objetos, utiliza el ícono de refresco junto al cuadro de búsqueda para obtener los objetos de la base de datos utilizando el filtro.

      Nota

      Para bases de datos que no soportan la búsqueda en objetos, como Microsoft Access, no se devuelven resultados.

    • Actualizar: Haz clic en el ícono de actualización para cargar o recargar tablas desde el punto final de la base de datos. Esto debe usarse para la carga inicial de cualquier objeto. Además, puede ser útil si has agregado recientemente objetos a la base de datos, o si tienes criterios de búsqueda adicionales que deseas aplicar antes de recuperar objetos de la base de datos.

    • Permitir truncamiento de campos de caracteres para evitar errores de longitud de campo: Selecciona esta casilla para permitir que los campos se trunquen según sea necesario si el campo de destino es más pequeño que el campo de origen. Está desmarcada por defecto. Cuando esta casilla se deja desmarcada y datos excesivos pasan, se muestra un estado de Error. Si la casilla está seleccionada, se muestra un estado de Éxito con Información en su lugar, y los registros de operación dirán que Uno o más valores fueron truncados al insertar y/o actualizar el campo.

    • Incluir el esquema/propietario en los nombres de las tablas: Selecciona esta casilla para incluir el esquema en los nombres de las tablas. Esto puede ser útil si usas el mismo nombre de tabla en múltiples esquemas (como para desarrollo y producción) para permitirte ver y seleccionar la tabla en el esquema correcto.

    • Proporcionar la referencia de los nombres de las tablas: La lista de objetos se muestra en una columna a la izquierda. Haz clic en los objetos uno a la vez para agregarlos a la tabla a la derecha. Se puede seleccionar cualquier combinación de tablas, vistas y/o tablas del sistema. Si en cambio necesitas insertar en un solo objeto sin uniones, consulta Inserción de un solo objeto.

      Consejo

      Si la lista no se llena con objetos disponibles incluso después de aplicar un filtro, la conexión a la base de datos puede no ser exitosa. Asegúrate de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.

    • Tabla de objetos seleccionados: Los objetos seleccionados se muestran en una tabla a la derecha. Cada columna se detalla a continuación:

      • Tabla: El nombre del objeto seleccionado, una tabla, vista o tabla del sistema.

        Nota

        Los nombres de las tablas con caracteres especiales como + no son compatibles con esta actividad.

      • Padre: En cada objeto hijo que se está uniendo, utiliza el menú desplegable para seleccionar el nombre del objeto que debe ser el padre. Esto es necesario para hacer cumplir la integridad transaccional de un objeto, así como para derivar la(s) clave(s) de enlace para un objeto hijo.

      • Tipo de unión: En cada objeto hijo que se está uniendo, un menú desplegable se vuelve disponible después de que hayas asignado Claves de Enlace (cubierto a continuación). Utiliza el menú desplegable para establecer el tipo de relación entre los objetos seleccionados:

        • Uno o Más: Este tipo de unión requiere que cada registro padre tenga al menos 1 registro hijo, y posiblemente más registros hijos.

        • Solo Uno: Este tipo de unión requiere que cada registro padre tenga 1 y solo 1 registro hijo.

        • Cero o Más: Este tipo de unión permite que cada registro padre tenga 0 o más registros hijos.

        • Cero o Uno: Este tipo de unión permite que cada registro padre tenga 0 registros hijos o solo 1 registro hijo.

      • Claves de Enlace: En cada objeto hijo que se está uniendo, una vez que se selecciona un objeto como Padre, aparece un enlace rojo Asignar dentro de este campo. Haz clic en Asignar para abrir una ventana separada donde asignas las claves de enlace.

        • Objeto padre: El objeto padre y la lista de campos se muestran en la columna izquierda. Cualquier campo utilizado como clave primaria dentro de la base de datos se indica con un ícono de clave . Si tienes un gran número de campos, puedes usar el cuadro de búsqueda para filtrar campos por nombre.

        • Objeto hijo: El objeto hijo y la lista de campos se muestran en la columna derecha. Si tienes un gran número de campos, puedes usar el cuadro de búsqueda para filtrar campos por nombre.

        • Asignar clave(s) de enlace: Para asignar un campo como clave de enlace, arrastra un campo del objeto padre a un campo dentro del objeto hijo a la derecha, o viceversa. Para asignar múltiples claves de enlace, repite este proceso según sea necesario.

        • Desasignar clave(s) de enlace: Para desasignar claves de enlace, haz clic en cualquier campo que ya esté vinculado. Los campos vinculados se deseleccionan.

        • Reiniciar: Para borrar todas las claves de enlace asignadas, haz clic en Reiniciar ubicado debajo de la lista de padres a la izquierda.

        • Finalizar: Haz clic en Finalizar para guardar las claves de enlace asignadas y cerrar la ventana. Bajo Claves de Enlace, ahora deberías ver el número de claves de enlace asignadas, que puedes hacer clic para reabrir la ventana de asignación de claves de enlace. Además, el menú desplegable Tipo de Unión se vuelve disponible para que configures el tipo de relación (cardinalidad) entre los objetos seleccionados.

      • Eliminar: Para eliminar un objeto seleccionado de la tabla, pasa el cursor sobre la columna más a la derecha y haz clic en el ícono de eliminar .

  • Guardar y Salir: Si está habilitado, haz clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.

  • Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Paso 2: Revisar el esquema de datos

  • Esquema de Datos: Se muestra el esquema de datos de destino. Si la operación utiliza una transformación, los esquemas de datos se mostrarán nuevamente más adelante durante el proceso de mapeo de transformación, donde puedes mapear a campos de destino utilizando objetos fuente, scripts, variables, valores personalizados y más.

  • Atrás: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Finalizado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Siguientes pasos

Después de configurar una actividad de Inserción de base de datos, puede usarla dentro de una operación o script como se describe a continuación.

Completar la operación

Después de configurar una actividad de Inserción de base de datos, complete la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puede configurar la configuración de la operación, que incluye la capacidad de encadenar operaciones que están en los mismos o diferentes flujos de trabajo.

Las acciones del menú para una actividad son accesibles desde el panel del proyecto y el lienzo de diseño. Para más detalles, consulte el menú de acciones de actividad en Conceptos básicos de conectores.

Las actividades de Inserción de base de datos se pueden usar como un objetivo con estos patrones de operación:

Otros patrones no son válidos utilizando actividades de Inserción de base de datos. Consulte los patrones de validación en la página de Validez de operación.

Dentro de una transformación, si se utiliza la opción de reflejar un esquema proporcionada por una actividad de base de datos utilizando una sola tabla (sin uniones), el esquema reflejado resultante se crea automáticamente con un nodo adicional llamado row. Cuando los campos dentro de este nodo adicional se mapean, el nodo se convierte en un nodo de bucle para permitir que todos los registros se recorran (consulte Nodos de bucle bajo Estructuras de datos).

Además, si se están uniendo tablas de base de datos, tenga en cuenta que los valores de los campos unidos de una tabla secundaria se establecen de forma predeterminada en los valores de los campos unidos de la tabla principal. Los campos unidos de una tabla secundaria no se pueden mapear.

Cuando esté listo, despliegue y ejecute la operación y valide el comportamiento revisando los registros de operación.

Usar actividades de base de datos en scripts

Las actividades de Inserción de base de datos también se pueden referenciar en un script para su uso con funciones de script que utilizan un target de base de datos como parámetro, incluyendo estas:

  • DBLoad
  • DBWrite

Para más detalles sobre cómo referenciar actividades en scripts, consulte Puntos finales en Jitterbit Script.

Además, es posible que pueda utilizar funciones adicionales de base de datos en la transformación. Por ejemplo, al mapear a un objetivo de base de datos, si tiene un objetivo de múltiples tablas con relaciones padre-hijo y está insertando datos, puede utilizar las funciones de transformación <SQLIDENTITY> y <SEQUENCE>.

  • <SQLIDENTITY> se utiliza para todas las bases de datos de destino que no son Oracle y que admiten claves de generación de números automáticos o de identidad. Después de que se inserta el padre, el hijo puede heredar el número generado del padre al mapear esta función a la clave externa en la tabla secundaria.

  • <SEQUENCE> realiza una acción similar con bases de datos Oracle.

Usar fragmentación

Al utilizar fragmentación en una operación donde el objetivo es una actividad de base de datos, tenga en cuenta que los datos de destino se escriben primero en numerosos archivos temporales (uno para cada fragmento). Estos archivos se combinan luego en un solo archivo de destino, que se envía a la base de datos para inserción/actualización.

Si establece la variable de Jitterbit jitterbit.target.db.commit_chunks en 1 o true cuando la fragmentación está habilitada, cada fragmento se confirma en la base de datos a medida que se vuelve disponible. Esto puede mejorar significativamente el rendimiento, ya que las inserciones/actualizaciones en la base de datos se realizan en paralelo.

Para obtener instrucciones y mejores prácticas sobre el uso de la fragmentación, consulte Opciones de operación.