Saltar al contenido

Actividad Database Query en Jitterbit Studio

Introducción

Una actividad Database Query, utilizando su conexión Database, consulta datos de un endpoint Database y está diseñada para usarse como fuente para proporcionar datos en una operación.

Crear una actividad Database Query

Se crea una instancia de una actividad Database Query desde una conexión Database utilizando su tipo de actividad Query.

Para crear una instancia de una actividad, arrastra el tipo de actividad al lienzo de diseño o copia el tipo de actividad y pégalo en el lienzo de diseño. Para más detalles, consulta Crear una instancia de actividad o herramienta en Reutilización de componentes.

Se puede editar una actividad Database Query existente desde estas ubicaciones:

Configurar una actividad Database Query

Sigue los pasos en una de estas secciones para configurar una actividad Database Query:

Consulta de un solo objeto usando el asistente

Sigue estos pasos para usar el asistente si estás consultando un solo objeto y no necesitas crear combinaciones con otros objetos. Si necesitas combinar múltiples objetos, consulta en su lugar Consulta de múltiples objetos usando el asistente, o si ya conoces la declaración SQL y estás usando un controlador JDBC, consulta Consulta manual.

Paso 1: Ingresa un nombre y selecciona un objeto

  • Menú Endpoint: Si tienes múltiples endpoints del mismo tipo de conector configurados, un menú en la parte superior de la pantalla muestra el nombre del endpoint actual. Haz clic en el menú para cambiar a un endpoint diferente. Para más información, consulta Cambiar el endpoint asignado en Pantallas de configuración.

    • Editar endpoint: Aparece cuando pasas el cursor sobre el nombre del endpoint actual. Haz clic para editar la configuración de conexión del endpoint seleccionado actualmente.

  • Nombre: Ingresa un nombre para identificar la actividad Database. El nombre debe ser único para cada actividad Database Query y no debe contener barras diagonales (/) ni dos puntos (:).

  • Seleccionar tabla(s): Esta sección muestra las tablas disponibles en el endpoint Database utilizando los filtros aplicados, después de usar el icono actualizar para la carga inicial de objetos. Si hay muchos objetos en la base de datos, puedes filtrar los objetos usando View o Search antes de actualizar. Si la obtención de los objetos agota el tiempo de espera incluso después de aplicar filtros, usa una declaración SQL manual.

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

    • Búsqueda: Ingresa el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de objetos. La búsqueda no distingue mayúsculas de minúsculas. La lista de objetos puede filtrarse automáticamente, o puede ser necesario actualizar la lista, dependiendo de si los objetos ya se han recuperado:

      • Si se busca en objetos que ya se han recuperado de la base de datos y ya aparecen en la lista, cualquier término de búsqueda ingresado en el cuadro de búsqueda filtra automáticamente la lista.

      • Si se busca en objetos que aún no se han recuperado, por ejemplo al intentar limitar la cantidad de objetos recuperados para bases de datos con un gran número de objetos, usa el icono de actualización junto al cuadro de búsqueda para obtener los objetos de la base de datos usando el filtro.

        Nota

        Las bases de datos como Microsoft Access no admiten búsqueda de objetos y no devolverán resultados.

    • Actualizar: Haz clic en el icono de actualización para cargar o recargar tablas desde el extremo de la base de datos. Esto debe usarse para la carga inicial de cualquier objeto. Además, también puede ser útil si recientemente has agregado 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.

    • Incluir el esquema/propietario en los nombres de tabla: Selecciona esta casilla para incluir el esquema en los nombres de tabla. 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.

    • Seleccionar tabla(s): La lista de objetos se muestra en una columna a la izquierda. Haz clic en un objeto individual para agregarlo a la tabla de la derecha. Si estás consultando múltiples objetos que necesitan ser unidos, consulta Consulta de múltiples objetos usando el asistente.

      Consejo

      Si la lista no se completa con objetos disponibles incluso después de aplicar un filtro, es posible que la Conexión a base de datos no sea exitosa. Asegúrate de estar conectado reabriendo la conexión y reintentando las credenciales.

    • Tabla de objetos seleccionados: El objeto seleccionado se muestra en una tabla a la derecha. Las columnas en esta tabla no son relevantes para consultas de un solo objeto y estos campos no pueden editarse, excepto para eliminar el objeto (pasa el cursor sobre la columna más a la derecha y haz clic en el icono de eliminar ). Si estás consultando múltiples objetos que necesitan ser unidos, consulta Consulta de múltiples objetos usando el asistente.

  • 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.

  • Omitir asistente / Escribir sentencia SQL: Cambia a escribir manualmente una sentencia SQL personalizada.

    Nota

    Guardar una sentencia SQL personalizada sobrescribe cualquier consulta de asistente guardada previamente.

  • Descartar cambios: Después de hacer 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: Agregar condiciones

Consejo

Los campos con un icono de variable admiten el uso de variables globales, variables de proyecto, y variables de Jitterbit. Comienza escribiendo un corchete de apertura [ en el campo o haz clic en el icono de variable para mostrar un menú con las variables existentes para elegir.

  • Seleccionar campos: Esta sección muestra los campos de los objetos seleccionados que están disponibles en el endpoint de Base de datos. Los objetos que se seleccionaron en el paso anterior aparecen en negrita.

    • Búsqueda: Ingresa el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de campos. La búsqueda no distingue entre mayúsculas y minúsculas. Los resultados listados se filtran en tiempo real con cada pulsación de tecla.

    • Seleccionar todo: Cuando uses el cuadro de búsqueda para filtrar, puedes usar esta casilla de verificación para seleccionar todos los campos visibles a la vez (los objetos y campos contraídos no se seleccionan).

    • Seleccionar campos: Selecciona las casillas de verificación de los campos que deseas incluir en la consulta para que se agreguen automáticamente a la sentencia SQL de la derecha. A menos que uses el cuadro de búsqueda, también puedes seleccionar un objeto completo para seleccionar todos sus campos a la vez.

  • Sentencia SQL: La sentencia de consulta se completa automáticamente con el objeto y cualquier campo seleccionado a la izquierda.

  • Cláusula WHERE (Opcional): Para agregar una cláusula WHERE, puedes usar los campos a continuación como entrada para ayudarte a construir la cláusula, o puedes ingresar la cláusula manualmente en el cuadro de texto inferior. Hay ejemplos de cláusulas WHERE en las páginas de procedimientos que describen cómo conectarse a bases de datos de uso común. Después de agregar una cláusula WHERE, primero debes probar la consulta usando el botón Probar consulta para habilitar el botón Siguiente.

    • Objeto: Campo: Usa la lista desplegable para seleccionar un campo del objeto seleccionado.

    • Operador: Usa la lista desplegable para seleccionar el operador o los operadores apropiados:

      Aritmética
      Operador Descripción
      + Suma
      - Resta
      * Multiplicación
      / División
      % Módulo
      Bit a bit
      Operador Descripción
      & AND bit a bit
      | OR bit a bit
      ^ XOR bit a bit (OR exclusivo)
      Comparación
      Operador Descripción
      = Igual a
      > Mayor que
      \< Menor que
      >= Mayor que o igual a
      \<= Menor que o igual a
      != No igual a
      Compuesto
      Operador Descripción
      += Suma y asigna
      -= Resta y asigna
      *= Multiplica y asigna
      /= Divide y asigna
      %= Módulo y asigna
      &= AND bit a bit y asigna
      |*= OR bit a bit y asigna
      ^-= XOR bit a bit y asigna
Lógico
Operador Descripción
ALL VERDADERO si todos los valores de la subconsulta cumplen la condición
AND VERDADERO si todas las condiciones separadas por AND son VERDADERAS
ANY VERDADERO si alguno de los valores de la subconsulta cumple la condición
BETWEEN VERDADERO si el operando está dentro del rango de comparaciones
EXISTS VERDADERO si la subconsulta devuelve uno o más registros
IN VERDADERO si el operando es igual a una de las expresiones de la lista
LIKE VERDADERO si el operando coincide con un patrón
NOT Muestra un registro si la condición o condiciones NO es VERDADERA
OR VERDADERO si alguna de las condiciones separadas por OR es VERDADERA
SOME VERDADERO si alguno de los valores de la subconsulta cumple la condición

  • Valor: Ingresa el valor a usar con el campo y operador seleccionados.

    Consejo

    Al usar variables globales en una cláusula WHERE, especifica un valor predeterminado para habilitar la prueba de scripts. Sin valores predeterminados, las pruebas pueden fallar ya que las variables globales solo obtienen valores en tiempo de ejecución.

  • Agregar: Crea la cláusula a partir de tus selecciones y la añade al cuadro de texto de abajo.

    Precaución

    Al escribir cláusulas WHERE manualmente, usa la sintaxis exacta requerida por tu base de datos. También puedes agregar una cláusula ORDER BY aquí, que afectará tanto a los registros secundarios como a los principales.

    Consejo

    Para agregar múltiples condiciones a la cláusula WHERE, repite el proceso añadiendo selecciones adicionales. Ten en cuenta que puede ser necesario agregar un operador lógico como AND u OR para tener en cuenta las condiciones adicionales.

  • Probar Consulta: Valida tu consulta. Si no es válida, se muestran mensajes de error. Si es válida, muestra hasta 20 registros de ejemplo.

Paso 3: Revisa el esquema de datos

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

    Nota

    Para actualizar un esquema de datos en una actividad existente, debes 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 al final del nombre de la actividad) para forzar una actualización del esquema.

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

  • Finalizado: Haz 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.

Consulta de múltiples objetos usando el asistente

Sigue estos pasos para consultar múltiples objetos con combinaciones:

Paso 1: Ingresa un nombre y selecciona objetos

  • Nombre: Ingresa un nombre para identificar la actividad de Base de Datos. El nombre debe ser único para cada actividad de Consulta de Base de Datos y no debe contener barras diagonales (/) ni dos puntos (:).

  • Seleccionar tabla(s): Esta sección muestra las tablas disponibles en el endpoint de base de datos utilizando los filtros aplicados, después de usar el icono de actualización para la carga inicial de objetos. Si hay muchos objetos en la base de datos, puedes filtrar los objetos usando Vista o Buscar antes de actualizar. Si la obtención de objetos agota el tiempo de espera, incluso después de aplicar filtros, utiliza una consulta SQL manual.

    • Vista: Usa el menú desplegable para filtrar la lista de objetos mostrados a una de "Tablas, Vistas", "Tablas", "Vistas" o "Tablas del sistema". De forma predeterminada, 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 mayúsculas de minúsculas. La lista de objetos puede filtrarse automáticamente, o puede ser necesario actualizar la lista, dependiendo de si los objetos ya se han recuperado:

      • Si se busca en objetos que ya se han recuperado 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 se busca en objetos que aún no se han recuperado, por ejemplo al intentar limitar la cantidad de objetos recuperados para bases de datos con una gran cantidad de objetos, usa el icono de actualización junto al cuadro de búsqueda para obtener los objetos de la base de datos usando el filtro.

        Nota

        Las bases de datos como Microsoft Access no admiten búsqueda de objetos y no devolverán resultados.

    • Actualizar: Haz clic en el icono de actualización para cargar o recargar tablas desde el endpoint de base de datos. Esto debe usarse para la carga inicial de cualquier objeto. Además, también puede ser útil si recientemente has agregado 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.

    • Incluir el esquema/propietario en los nombres de tabla: Selecciona esta casilla para incluir el esquema en los nombres de tabla. 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.

    • Seleccionar tabla(s): 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 de la derecha. Se puede seleccionar cualquier combinación de tablas, vistas y/o tablas del sistema. Si en su lugar necesitas consultar un único objeto sin combinaciones, consulta en su lugar Consulta de objeto único usando asistente.

      Consejo

      Si la lista no se completa con objetos disponibles incluso después de aplicar un filtro, es posible que la conexión de base de datos no sea exitosa. Asegúrate de estar conectado reabriendo la conexión y recomprobando 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.

        Consejo

        Las tablas con caracteres especiales como + en sus nombres requieren una consulta manual. El nombre de la tabla debe estar entre corchetes ([ ]). Por ejemplo, SELECT * FROM [table+].

      • Principal: Para cada objeto secundario que se está combinando, selecciona su objeto principal. Esto establece la jerarquía de relaciones y ayuda a derivar las claves de enlace.

      • Tipo de combinación: Después de asignar Claves de enlace, selecciona el tipo de relación para cada objeto secundario:

        • Uno o más: Cada registro principal debe tener al menos 1 registro secundario.

        • Solo uno: Cada registro principal debe tener exactamente 1 registro secundario.

        • Cero o más: Cada registro principal puede tener 0 o más registros secundarios.

        • Cero o uno: Cada registro principal puede tener 0 o 1 registro secundario.

      • Claves de enlace: Para cada objeto secundario con un Principal seleccionado, haz clic en el enlace rojo Asignar para configurar relaciones de claves:

  • Claves de enlace: En cada objeto secundario que se une, una vez que se selecciona un objeto como Principal, aparece un enlace rojo Asignar en este campo. Haz clic en Asignar para abrir una ventana separada donde asignas las claves de enlace.

    • Objeto principal: Muestra el objeto principal y sus campos a la izquierda. Las claves primarias tienen un icono de llave. Utiliza el cuadro de búsqueda para filtrar campos si es necesario.

    • Objeto secundario: Muestra el objeto secundario y sus campos a la derecha. Utiliza el cuadro de búsqueda para filtrar campos si es necesario.

    • Asignar clave(s) de enlace: Arrastra un campo del principal al secundario (o viceversa) para crear un enlace. Repite el proceso para múltiples claves.

    • Desasignar clave(s) de enlace: Para desasignar claves de enlace, haz clic en cualquier campo que ya haya sido enlazado. Los campos enlazados se deseleccionan.

    • Comenzar de nuevo: Borra todas las claves de enlace asignadas.

    • Finalizar: Guarda tus claves de enlace y muestra el recuento en la columna Claves de enlace. El menú desplegable Tipo de unión se vuelve disponible.

  • 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 icono 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. Este botón no se habilitará hasta que hayas especificado los objetos Principal, establecido el Tipo de unión y asignado las Claves de enlace. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.

  • Omitir asistente / Escribir sentencia SQL: Cambia a escribir manualmente una sentencia SQL personalizada.

    Nota

    Guardar una sentencia SQL personalizada sobrescribe cualquier consulta de asistente guardada anteriormente.

  • Descartar cambios: Después de hacer 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: Agregar condiciones

Consejo

Los campos con un icono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comienza escribiendo un corchete de apertura [ en el campo o haz clic en el icono de variable para mostrar un menú con las variables existentes entre las que elegir.

  • Origen: Muestra campos para cada objeto seleccionado. Los campos identificados como claves deben incluirse.

    • Búsqueda: Ingresa el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de campos del objeto seleccionado. La búsqueda no distingue entre mayúsculas y minúsculas. Los resultados listados se filtran en tiempo real con cada pulsación de tecla.

    • Seleccionar todo: Marca la casilla para seleccionar todos los objetos y campos visibles a la vez (los objetos contraídos no se seleccionan). Este modo de selección no está disponible si se utilizan selecciones a nivel de objeto, pero está disponible cuando se utiliza el cuadro de búsqueda.

    • Seleccionar campos: Marca las casillas de los campos que deseas incluir en la consulta para que se agreguen automáticamente a la sentencia SQL a la derecha. También puedes seleccionar un objeto completo para seleccionar todos sus campos a la vez.

  • Tabla de campos de objeto: Los objetos seleccionados y sus campos se muestran en tablas a la derecha, con campos opcionales para agregar condiciones y ordenamiento:

    • Condición de filtro: Opcionalmente, ingresa una condición en forma del argumento de una cláusula WHERE; es decir, operador(es) seguido(s) de valor(es). Hay ejemplos de cláusulas WHERE en las páginas de procedimientos que describen cómo conectarse a bases de datos de uso común.

      Precaución

      Si proporcionas una cláusula WHERE manualmente, debes ingresarla en la sintaxis que requiere la base de datos.

Consejo

Al usar variables globales en una cláusula WHERE, especifica un valor predeterminado para habilitar las pruebas de script. Sin valores predeterminados, las pruebas pueden fallar ya que las variables globales solo obtienen valores en tiempo de ejecución.

  • Ordenar: Opcionalmente, selecciona Ninguno, Ascendente o Descendente para aplicar un orden. Seleccionar la opción Ninguno es lo mismo que dejar este campo en blanco.

    Precaución

    Usar ORDER BY en campo(s) secundario(s) también afecta los registros principales.

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

  • 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 hacer 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 3: Revisar el esquema de datos

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

    Nota

    Para actualizar un esquema de datos en una actividad existente, debes 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 al final del nombre de la actividad) para forzar una actualización del esquema.

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

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

  • Descartar cambios: Después de hacer 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.

Consulta manual

Sigue estos pasos si conoces la declaración SQL y estás usando una conexión de controlador JDBC (no disponible para ODBC):

Paso 1: Ingresa un nombre y omite el asistente

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

  • Seleccionar tabla(s): Omite esta sección, ya que no es relevante para consultas manuales. Especificarás las tablas en tu declaración SQL.

  • Siguiente: Este botón no debe estar habilitado, ya que solo es aplicable cuando se usa el asistente de Consulta de Base de datos (consulta Consulta de un solo objeto usando asistente o Consulta de múltiples objetos usando asistente).

  • Omitir asistente / Escribir declaración SQL: Haz clic para continuar al paso de entrada de SQL.

  • Descartar cambios: Después de hacer 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: Ingresa una declaración SQL

  • Escribir o pegar declaración SQL: Ingresa la declaración de consulta SQL. Nota:

    • Usa sintaxis compatible con ANSI-SQL para el controlador JDBC de tu base de datos específica.

    • Hay un límite de 2,000 caracteres para las declaraciones SQL.

      Nota

      Una solución alternativa para las declaraciones SQL que exceden la limitación de caracteres es crear vistas de base de datos.

    • Para usar variables, ingrésalas usando la sintaxis de corchetes descrita en la documentación de variables globales, variables de proyecto o variables de Jitterbit.

  • Al usar variables globales en una cláusula WHERE, especifica un valor predeterminado usando sintaxis en línea (por ejemplo, [customer_id{123}]) para habilitar pruebas de script. Sin valores predeterminados, las pruebas pueden fallar ya que las variables globales solo obtienen valores en tiempo de ejecución. Hay ejemplos de cláusulas WHERE en las páginas de procedimientos que describen cómo conectarse a bases de datos de uso común.

  • Al configurar una sentencia SQL en un script anterior a esta actividad, se pueden concatenar variables con otras cadenas para crear SQL válido. Por ejemplo, "SELECT * FROM " + $databaseName + ".Table". La cadena resultante se puede almacenar en otra variable y aplicarse directamente a este campo usando la información anterior.

  • El uso de cláusulas ORDER BY en campos secundarios también afecta los registros principales.

  • Se pueden usar Funciones Definidas por el Usuario (UDF) dentro de la sentencia SQL usando la función <UDF>. Esta función permite usar cualquier función de base de datos compatible con la base de datos de destino, como la función TO_DATE en Oracle o la función CONVERT() en SQL Server. Consulta los detalles en Funciones de base de datos.

  • Para usar caracteres especiales como + en nombres de tabla, el nombre de la tabla debe estar entre corchetes ([ ]). Por ejemplo, SELECT * FROM [Table+].

  • Consulta de prueba: Valida tu consulta. Si no es válida, se muestran mensajes de error. Si es válida, muestra hasta 20 registros de ejemplo.

Paso 3: Revisa el esquema de datos

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

    Nota

    Para actualizar un esquema de datos en una actividad existente, debes 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 al final del nombre de la actividad) para forzar una actualización del esquema.

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

  • Finalizado: Haz 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.

Próximos pasos

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

Completa la operación

Después de configurar una actividad de Consulta de base de datos, completa la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de operación. También se pueden configurar los parámetros de la operación, que incluyen la capacidad de encadenar operaciones que se encuentran en los mismos flujos de trabajo o en flujos de trabajo diferentes.

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

Las actividades de Consulta de base de datos se pueden usar como origen con estos patrones de operación:

Los otros patrones no son válidos al usar actividades de Consulta de base de datos. Consulta los patrones de validación en la página Validez de operaciones.

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

Además, si se combinan tablas de base de datos, ten en cuenta que los valores de los campos combinados de una tabla secundaria toman por defecto los valores de los campos combinados de la tabla principal. Los campos combinados de una tabla secundaria no se pueden asignar.

Cuando esté listo, implementa y ejecuta la operación y valida el comportamiento consultando los registros de operación.

Usar actividades de base de datos en scripts

Las actividades de Consulta de base de datos también se pueden referenciar en un script para usarlas con funciones de script que utilizan un databaseId como parámetro, incluyendo estas:

Funciones de Jitterbit Script

  • CacheLookup
  • CallStoredProcedure
  • DBCloseConnection
  • DBExecute
  • DBLookup
  • DBLookupAll
  • DBRollbackTransaction

Funciones Jitterbit de JavaScript

  • Jitterbit.DbExecute
  • Jitterbit.DbLookup

Para más detalles sobre cómo referenciar puntos de conexión en scripts, consulta Puntos de conexión en Jitterbit Script o Puntos de conexión en JavaScript.

Usar fragmentación

Al usar fragmentación en una operación donde el origen es una actividad de base de datos, los datos se fragmentan en la transformación, no cuando se recuperan. Los datos de destino se escriben primero en numerosos archivos temporales (uno para cada fragmento). Estos archivos se combinan luego en un archivo de destino único.

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