Actividad de Consulta de Base de Datos
Introducción
Una actividad de Consulta de Base de Datos, utilizando su conexión de base de datos, consulta datos de un punto final de Base de Datos y está destinada a ser utilizada como una fuente para proporcionar datos en una operación.
Crear una actividad de Consulta de Base de Datos
Una instancia de una actividad de Consulta de Base de Datos se crea a partir de una conexión de base de datos utilizando su tipo de actividad Consulta.
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 Consulta de Base de Datos existente se puede editar desde estas ubicaciones:
-
El lienzo de diseño (consulte Menú de acciones de componentes en Lienzo de diseño).
-
La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).
Configurar una actividad de Consulta de Base de Datos
Siga los pasos en una de estas secciones para configurar una actividad de Consulta de Base de Datos:
-
Consulta de un solo objeto usando asistente: Para una consulta de un solo objeto sin uniones.
-
Consulta de múltiples objetos usando asistente: Para múltiples objetos con uniones.
-
Consulta manual: Para proporcionar una declaración SQL manualmente (solo conexiones JDBC).
Consulta de un solo objeto usando asistente
Sigue estos pasos para usar el asistente si estás consultando un solo objeto y no necesitas crear uniones con otros objetos. Si necesitas unir 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 utilizando un controlador JDBC, consulta Consulta manual.
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 Consulta de Base de Datos y no debe contener barras inclinadas (
/) o dos puntos (:). -
Seleccionar Tabla(s): 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 muchos objetos en la base de datos, puedes filtrar los objetos usando Ver o Buscar antes de refrescar. Si la obtención de los objetos se agota incluso después de aplicar filtros, utiliza una declaración SQL manual.
-
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 ser filtrada 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 se busca en objetos que aún no se han recuperado, 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 actualización junto al cuadro de búsqueda para obtener los objetos de la base de datos utilizando el filtro.
Nota
Bases de datos como Microsoft Access no soportan la búsqueda de objetos y no devolverán 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, también 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.
-
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 utilizas 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 solo objeto para agregarlo a la tabla a 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 llena con objetos disponibles incluso después de aplicar un filtro, la conexión a la base de datos puede no haber sido exitosa. Asegúrate 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 en esta tabla no son relevantes para consultas de un solo objeto y estos campos no se pueden editar, excepto para eliminar el objeto (pasa el cursor sobre la columna más a la derecha y haz clic en el ícono 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, 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.
-
Omitir asistente / Escribir declaración SQL: Cambiar a escribir manualmente una declaración SQL personalizada.
Nota
Guardar una declaración SQL personalizada sobrescribe cualquier consulta de asistente guardada previamente.
-
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: Agregar condiciones
Consejo
Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú con las variables existentes para elegir.
-
Seleccionar campos: Esta sección muestra los campos para el(los) objeto(s) seleccionado(s) que están disponibles en el punto final de la base de datos. Los objetos seleccionados en el paso anterior se muestran en negrita.
-
Buscar: Ingrese 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: Al usar el cuadro de búsqueda para filtrar, puede usar esta casilla de verificación para seleccionar todos los campos visibles a la vez (los objetos y los campos colapsados no se seleccionan).
-
Seleccionar campos: Seleccione las casillas de verificación de los campos que desea incluir en la consulta para que se agreguen automáticamente a la declaración SQL a la derecha. A menos que esté utilizando el cuadro de búsqueda, también puede seleccionar un objeto completo para seleccionar todos sus campos a la vez.
-
-
Declaración SQL: La declaración 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 ayudar a construir la cláusula, o puedes ingresar manualmente la cláusula en el cuadro de texto inferior. Hay ejemplos de cláusulas WHERE en las páginas de cómo hacerlo que describen cómo conectarse a bases de datos comúnmente utilizadas. 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 el menú desplegable para seleccionar un campo del objeto seleccionado.
-
Operador: Usa el menú desplegable para seleccionar el(los) operador(es) apropiado(s):
Aritmético Operador Descripción + Sumar - Restar * Multiplicar / Dividir % Módulo A nivel de bits Operador Descripción & AND a nivel de bits | OR a nivel de bits ^ XOR a nivel de bits (OR exclusivo) Comparación Operador Descripción = Igual a > Mayor que \< Menor que >= Mayor o igual a \<= Menor o igual a != No igual a Compuesto Operador Descripción += Sumar igual -= Restar igual *= Multiplicar igual /= Dividir igual %= Módulo igual &= AND bit a bit igual |*= OR bit a bit igual ^-= XOR bit a bit igual 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 uno de una lista de expresiones LIKE VERDADERO si el operando coincide con un patrón NOT Muestra un registro si la(s) condición(es) 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 utilizar con tu campo y operador seleccionados.
Consejo
Al usar variables globales en una cláusula WHERE, especifica un valor predeterminado para habilitar la prueba del script. 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 a continuación.
Precaución
Al escribir cláusulas WHERE manualmente, utiliza la sintaxis exacta requerida por tu base de datos. También puedes agregar una cláusula ORDER BY aquí, lo 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 que necesites agregar un operador lógico como AND o OR para tener en cuenta las condiciones adicionales.
-
-
Consulta de Prueba: Valida tu consulta. Si no es válida, se muestran mensajes de error. Si es válida, se muestran hasta 20 registros de muestra.
Paso 3: Revisar el esquema de datos
-
Esquema de Datos: Se muestra el esquema de datos de origen. 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 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 la actividad nuevamente, haciendo 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: Haz clic para almacenar temporalmente la configuración de este paso y regresar 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 pedirá que confirmes que deseas descartar los cambios.
Consulta de múltiples objetos usando el asistente
Sigue estos pasos para consultar múltiples objetos con uniones:
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 Consulta de Base de Datos y no debe contener barras inclinadas (
/) ni dos puntos (:). -
Seleccionar Tabla(s): 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 muchos objetos en la base de datos, puedes filtrar los objetos usando Ver o Buscar antes de refrescar. Si la obtención de los objetos se agota, incluso después de aplicar filtros, utiliza una declaración SQL manual.
-
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
Las bases de datos como Microsoft Access no soportan la búsqueda de objetos y no devolverán 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.
-
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.
-
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 a la derecha. Se puede seleccionar cualquier combinación de tablas, vistas y/o tablas del sistema. Si en cambio necesitas consultar un solo objeto sin uniones, consulta en su lugar Consulta de un solo objeto usando el asistente.
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.
Consejo
Las tablas con caracteres especiales como
+en sus nombres requieren una consulta manual. El nombre de la tabla debe estar entre corchetes cuadrados ([]). Por ejemplo,SELECT * FROM [table+]. -
Padre: Para cada objeto hijo que se une, selecciona su objeto padre. Esto establece la jerarquía de relaciones y ayuda a derivar claves de enlace.
-
Tipo de unión: Después de asignar Claves de enlace, selecciona el tipo de relación para cada objeto hijo:
-
Uno o más: Cada registro padre debe tener al menos 1 registro hijo.
-
Solo uno: Cada registro padre debe tener exactamente 1 registro hijo.
-
Cero o más: Cada registro padre puede tener 0 o más registros hijos.
-
Cero o uno: Cada registro padre puede tener 0 o 1 registro hijo.
-
-
Claves de enlace: Para cada objeto hijo con un Padre seleccionado, haz clic en el enlace rojo Asignar para establecer relaciones clave:
-
Claves de enlace: En cada objeto hijo que se está uniendo, una vez que se selecciona un objeto como el 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: Muestra el objeto padre y sus campos a la izquierda. Las claves primarias tienen un ícono de llave . Usa el cuadro de búsqueda para filtrar campos si es necesario.
-
Objeto hijo: Muestra el objeto hijo y sus campos a la derecha. Usa el cuadro de búsqueda para filtrar campos si es necesario.
-
Asignar clave(s) de enlace: Arrastra un campo del padre al hijo (o viceversa) para crear un enlace. Repite para múltiples claves.
-
Desasignar clave(s) de enlace: Para desasignar claves de enlace, haz clic en cualquier campo que ya haya sido vinculado. Los campos vinculados se deseleccionan.
-
Comenzar de nuevo: Borra todas las claves de enlace asignadas.
-
Finalizar: Guarda tus claves de enlace y muestra el conteo 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 í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. Este botón no estará habilitado hasta que hayas especificado cualquier objeto Padre, establecido el Tipo de unión y asignado 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 Declaración SQL: Cambiar a escribir manualmente una declaración SQL personalizada.
Nota
Guardar una declaración SQL personalizada sobrescribe cualquier consulta de asistente guardada previamente.
-
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: Agregar condiciones
Consejo
Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú con las variables existentes para elegir.
-
Fuente: Muestra campos para cada objeto seleccionado. Los campos identificados como claves deben incluirse.
-
Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de campos para el 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: Seleccione la casilla de verificación para seleccionar todos los objetos y campos visibles a la vez (los objetos colapsados no se seleccionan). Este modo de selección no está disponible si se están utilizando selecciones a nivel de objeto, pero está disponible al usar el cuadro de búsqueda.
-
Seleccionar campos: Seleccione las casillas de verificación de los campos que desea incluir en la consulta para que se agreguen automáticamente a la declaración SQL a la derecha. También puede 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, ingrese una condición en forma de 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 cómo hacerlo que describen cómo conectarse a bases de datos de uso común.
Advertencia
Si proporciona una cláusula WHERE manualmente, debe ingresarla en la sintaxis que requiere la base de datos.
Consejo
Al usar variables globales en una cláusula WHERE, especifique un valor predeterminado para habilitar la prueba del script. Sin valores predeterminados, la prueba puede fallar ya que las variables globales solo obtienen valores en tiempo de ejecución.
-
Ordenar: Opcionalmente, seleccione Ninguno, Ascendente o Descendente para aplicar un orden de clasificación. Seleccionar la opción Ninguno es lo mismo que dejar este campo en blanco.
Advertencia
Usar ORDER BY en campo(s) hijo(s) también afecta los registros padre.
-
-
Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.
-
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 3: Revisar el esquema de datos
-
Esquema de Datos: Se muestra el esquema de datos de origen. 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
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.
Consulta manual
Sigue estos pasos si conoces la declaración SQL y estás utilizando 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 la Base de Datos. El nombre debe ser único para cada actividad de Consulta de Base de Datos y no debe contener barras inclinadas (
/) o 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 es aplicable solo cuando se utiliza el asistente de Consulta de Base de Datos (consulta Consulta de un solo objeto usando el asistente o Consulta de múltiples objetos usando el asistente).
-
Omitir Asistente / Escribir Declaración SQL: Haz clic para continuar al paso de entrada de SQL.
-
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: Ingresa una Declaración SQL
-
Escribir o Pegar Declaración SQL: Ingresa la declaración de consulta SQL. Nota:
-
Usa la 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 el límite de caracteres es crear vistas de base de datos.
-
Para usar variables, ingrésalas utilizando la sintaxis de corchetes cuadrados descrita en la documentación para variables globales, variables de proyecto o variables de Jitterbit.
-
Al usar variables globales en una cláusula WHERE, especifique un valor predeterminado para habilitar la prueba del 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 cómo hacerlo que describen cómo conectarse a bases de datos de uso común.
-
Al configurar una declaración SQL en un script antes de esta actividad, las variables se pueden concatenar 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 utilizando la información anterior. -
Usar cláusulas ORDER BY en campos secundarios también afecta los registros principales.
-
Puede usar Funciones Definidas por el Usuario (UDF) dentro de la declaración SQL utilizando la función
<UDF>. Esta función le permite usar cualquier función de base de datos soportada por la base de datos de destino, como la funciónTO_DATEen Oracle, o la funciónCONVERT()en SQL Server. Consulte los detalles en Funciones de base de datos. -
Para usar caracteres especiales como
+en los nombres de las tablas, el nombre de la tabla debe estar entre corchetes ([]). Por ejemplo,SELECT * FROM [Table+].
-
-
Consulta de Prueba: Valida su consulta. Si no es válida, se muestran mensajes de error. Si es válida, se muestran hasta 20 registros de muestra.
Paso 3: Revisar el esquema de datos
-
Esquema de Datos: Se muestra el esquema de datos de origen. 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
Para actualizar un esquema de datos en una actividad existente, debe avanzar a través de cada paso de configuración de la 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: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.
-
Terminado: 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.
Pasos siguientes
Después de configurar una actividad de Consulta de base de datos, puedes 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 Consulta de base de datos, completa la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puedes 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, consulta el menú de acciones de actividad en Conceptos básicos de conectores.
Las actividades de Consulta de base de datos se pueden usar como fuente con estos patrones de operación:
- Patrón de transformación
- Patrón de archivo de dos objetivos (como la primera fuente únicamente)
- Patrón de archivo HTTP de dos objetivos (como la primera fuente únicamente)
- Patrón de dos transformaciones (como la primera fuente únicamente)
Otros patrones no son válidos utilizando actividades de Consulta de base de datos. Consulta 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 se mapean campos dentro de este nodo adicional, el nodo se convierte en un nodo de bucle para permitir que se recorran todos los registros (ver 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 hija se establecen de forma predeterminada a los valores de los campos unidos de la tabla padre. Los campos unidos de una tabla hija 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 Consulta de Base de Datos también se pueden referenciar en un script para su uso con funciones de script que utilizan un databaseId como parámetro, incluyendo estas:
Funciones de Script de Jitterbit
CacheLookupCallStoredProcedureDBCloseConnectionDBExecuteDBLookupDBLookupAllDBRollbackTransaction
Funciones de Jitterbit en JavaScript
Jitterbit.DbExecuteJitterbit.DbLookup
Para más detalles sobre cómo referenciar puntos finales en scripts, consulte Puntos finales en Jitterbit Script o Puntos finales en JavaScript.
Usar fragmentación
Al utilizar fragmentación en una operación donde la fuente es una actividad de Base de Datos, los datos se fragmentan en la transformación, no cuando se recuperan los datos. Los datos de destino se escriben primero en numerosos archivos temporales (uno para cada fragmento). Luego, estos archivos se combinan en un solo archivo de destino.
Para obtener instrucciones y mejores prácticas sobre el uso de fragmentación, consulte Opciones de operación.