Actividad de Consultar de Base de Datos¶

Introducción¶

Una consulta de base de datos consulta datos de un extremo de base de datos y está destinada a utilizarse como fuente para proporcionar datos a una operación o para ser invocada en un secuencia de comandos. Después de configurar una conexión de base de datos, puede configurar tantas actividades de base de datos como desee para cada conexión de base de datos.

Crear una Actividad de Base de Datos¶

Una instancia de una actividad se crea a partir de una conexión utilizando un tipo de actividad.

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

Se puede editar una actividad existente desde estas ubicaciones:

• El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestaña Componentes del panel Proyecto).

Configurar una Actividad de Consultar de Base de Datos¶

Los pasos para configurar una actividad de consulta de base de datos difieren según el caso de uso y si ya conoce la declaración SQL:

• consultar de un solo objeto mediante asistente: Siga estos pasos para consultar solo un único objeto sin uniones cuando la declaración SQL es desconocida.
• consultar de múltiples objetos mediante asistente: Siga estos pasos para consultar varios objetos con uniones cuando la declaración SQL es desconocida.
• consultar manual: Siga estos pasos para consultar uno o varios objetos proporcionando manualmente una declaración SQL. Esta opción solo está disponible con conexiones de base de datos que utilicen un controlador JDBC y no está disponible para aquellas configuradas con ODBC.

Consultar de un Único Objeto Mediante Asistente¶

Siga estos pasos para utilizar el asistente si está consultando un solo objeto y no necesita crear ninguna unión con otros objetos. Si necesita unir varios objetos, consulte consultar de varios objetos mediante el asistente, o si ya conoce la declaración SQL y está utilizando un controlador JDBC, consulte consultar manual.

• Paso 1: Ingrese un nombre y seleccione un objeto
• Paso 2: Agregar condiciones
• Paso 3: Revisar el esquema de datos

Paso 1: Ingrese un Nombre y Seleccione un Objeto¶

• Nombre: Ingrese 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 diagonales (/) o dos puntos (:).

• Seleccionar tabla(s): Esta sección muestra las tablas disponibles en el extremo de la base de datos utilizando cualquier filtro aplicado, después de usar el icono de actualización para la carga inicial de objetos. Si hay muchos objetos en la base de datos, puede filtrarlos usando Ver o Buscar antes de actualizar. Si la recuperación de los objetos se agota incluso después de aplicar filtros, use una declaración SQL manual.

  • Ver: Use el menú desplegable para filtrar la lista de objetos mostrados por uno de los siguientes: "Tablas, Vistas", "Tablas", "Vistas" o "Tablas del sistema". De manera predeterminada, se muestra la vista "Tablas, Vistas".

  • Buscar: Ingrese 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 se puede filtrar automáticamente o puede que necesite actualizar la lista, dependiendo de si los objetos ya se han recuperado:

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

    • Si busca 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, use el ícono de actualización junto al cuadro de búsqueda para recuperar los objetos de la base de datos usando el filtro.

      Nota

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

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

  • Incluir el esquema/propietario en los nombres de las tablas: Seleccione esta casilla de verificación para incluir el esquema en los nombres de las tablas. Esto puede resultar útil si utiliza el mismo nombre de tabla en varios esquemas (por ejemplo, para desarrollo y producción) para poder ver y seleccionar la tabla en el esquema correcto.

  • Seleccionar tabla(s): 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á consultando varios objetos que necesitan unirse, consulte consultar de varios objetos mediante el asistente.

    Sugerencia

    Si la lista no se completa con los objetos disponibles incluso después de aplicar un filtro, la Conexión de base de datos puede no funcionar correctamente. 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 consultas de un solo objeto y estos campos no se pueden editar, excepto para eliminar el objeto (coloque el cursor sobre la columna más a la derecha y haga clic en el botón eliminar icono). Si está consultando varios objetos que necesitan unirse, consulte consultar de varios objetos mediante 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 con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.

• Omitir asistente/Escribir declaración SQL: Si está presente, no haga clic en las palabras Omitir asistente/Escribir declaración SQL. Esto hará que se ignoren los objetos seleccionados en este paso y, en su lugar, se utilice una declaración SQL en el siguiente paso que anule las selecciones realizadas aquí.

• 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 solicitará que confirme que desea descartar los cambios.

Paso 2: Agregar Condiciones¶

• Seleccionar campos: Esta sección muestra los campos de los objetos seleccionados que están disponibles en el extremo de la base de datos. Los objetos que se seleccionaron 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 de la lista 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 contraídos no se seleccionan).
  • Seleccionar campos: Seleccione las casillas de verificación de los campos que desea incluir en la consultar para que se agreguen automáticamente a la declaración SQL de la derecha. A menos que utilice el cuadro de búsqueda, también puede seleccionar un objeto completo para seleccionar todos sus campos a la vez.

• Sentencia SQL: La declaración de consultar se rellena automáticamente con el objeto y cualquier campo seleccionado a la izquierda.

• Cláusula WHERE (opcional): Para agregar una cláusula WHERE, puede utilizar los campos que se encuentran a continuación como entrada para ayudar a construir la cláusula, o puede ingresar manualmente la cláusula en el cuadro de texto inferior. Para ver ejemplos de cláusulas WHERE, consulte Información específica de la base de datos. Después de agregar una cláusula WHERE, primero debe probar la consultar utilizando el botón Probar consulta para habilitar el botón Siguiente.

  • Objeto: Campo: Utilice el menú desplegable para seleccionar un campo del objeto seleccionado.

  • Operador: Utilice el menú desplegable para seleccionar el o los operadores adecuados:

    Aritmética
    Operador	Descripción
    +	Agregar
    -	Restar
    *	Multiplicar
    /	Dividir
    %	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 o igual que
    \<=	Menor o igual que
    !=	No es igual a

    Compuesto
    Operador	Descripción
    +=	Sumar igual
    -=	Restar es igual a
    *=	Multiplicar es igual a
    /=	Dividir es igual a
    %=	Módulo igual a
    &=	AND bit a bit es igual a
    |*=	OR bit a bit es igual a
    ^-=	OR exclusivo bit a bit es igual a

    Lógico
    Operador	Descripción
    TODOS	VERDADERO si todos los valores de la subconsulta cumplen la condición
    Y	VERDADERO si todas las condiciones separadas por Y son VERDADERAS
    CUALQUIERA	VERDADERO si alguno de los valores de la subconsulta cumple la condición
    ENTRE	VERDADERO si el operando está dentro del rango de comparaciones
    EXISTS	VERDADERO si la subconsulta devuelve uno o más registros
    IN	TRUE si el operando es igual a una de una lista de expresiones
    ME GUSTA	VERDADERO si el operando coincide con un patrón
    NO	Muestra un registro si la(s) condición(es) NO SON VERDADERAS
    OR	TRUE si alguna de las condiciones separadas por OR es VERDADERA
    ALGUNOS	VERDADERO si alguno de los valores de la subconsulta cumple la condición

  • Valor: Ingrese el valor que desea utilizar con las selecciones del menú desplegable.

    Consejo

    Al utilizar variables globales en una cláusula WHERE, se recomienda especificar un valor predeterminado para que sea posible realizar pruebas de secuencia de comandos. De lo contrario, dado que las variables globales obtienen su valor en tiempo de ejecución, la sintaxis puede invalidarse durante las pruebas si no se especifica un valor predeterminado.

  • Agregar: Construye automáticamente la cláusula en función de las selecciones del menú desplegable y el valor ingresado. La cláusula construida automáticamente aparece en el cuadro de texto inferior.

  Precaución

  Si proporciona una cláusula WHERE manualmente, debe ingresarla en la sintaxis que requiere la base de datos. También puede incluir manualmente una cláusula ORDER BY en esta sección. El uso de ORDER BY en campos secundarios también afecta los registros principales.

  Consejo

  Para agregar varias condiciones a la cláusula WHERE, repita el proceso agregando selecciones adicionales. Tenga en cuenta que es posible que deba agregar un operador lógico como AND u OR para tener en cuenta las condiciones adicionales.

• Consulta de prueba: Haga clic en este botón para validar si la consultar es válida. Si la consultar no es válida, los mensajes de error brindan detalles adicionales. Si la consultar es válida, se muestra una muestra de hasta 20 registros en una tabla similar a la que se muestra a continuación:

  

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 vuelven a mostrar más adelante durante la asignación de transformación proceso, donde puede asignar campos de destino utilizando objetos de origen, secuencias de comandos, variables, valores personalizados y más.

  Nota

  Para actualizar un esquema de datos en una actividad existente, debe avanzar nuevamente a través de cada paso de configuración de la actividad, realizando al menos un cambio (como agregar y quitar 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.

• Terminado: 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 los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Consultar de Múltiples Objetos Mediante Asistente¶

Siga estos pasos si va a consultar varios objetos y crear uniones entre ellos. Si necesita consultar un solo objeto, consulte consultar de un solo objeto mediante el asistente, o si ya conoce la declaración SQL y está utilizando un controlador JDBC, consulte consultar manual.

• Paso 1: Ingrese un nombre y seleccione objetos
• Paso 2: Agregar condiciones
• Paso 3: Revisar el esquema de datos

Paso 1: Ingrese un Nombre y Seleccione Objetos¶

• Nombre: Ingrese 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 diagonales (/) o dos puntos (:).

• Seleccionar tabla(s): Esta sección muestra las tablas disponibles en el extremo de la base de datos utilizando cualquier filtro aplicado, después de usar el icono de actualización para la carga inicial de objetos. Si hay muchos objetos en la base de datos, puede filtrarlos usando Ver o Buscar antes de actualizar. Si se agota el tiempo de espera para obtener los objetos, incluso después de aplicar filtros, use una declaración SQL manual.

  • Ver: Use el menú desplegable para filtrar la lista de objetos mostrados por uno de los siguientes: "Tablas, Vistas", "Tablas", "Vistas" o "Tablas del sistema". De manera predeterminada, se muestra la vista "Tablas, Vistas".

  • Buscar: Ingrese 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 se puede filtrar automáticamente o puede que necesite actualizar la lista, dependiendo de si los objetos ya se han recuperado:

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

    • Si busca 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, use el ícono de actualización junto al cuadro de búsqueda para recuperar los objetos de la base de datos usando el filtro.

    Nota

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

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

  • Incluir el esquema/propietario en los nombres de las tablas: Seleccione esta casilla de verificación para incluir el esquema en los nombres de las tablas. Esto puede resultar útil si utiliza el mismo nombre de tabla en varios esquemas (por ejemplo, para desarrollo y producción) para poder ver y seleccionar la tabla en el esquema correcto.

  • Seleccionar tabla(s): La lista de objetos se muestra en una columna a la izquierda. Haga clic en los objetos de a uno por 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 cambio, necesita consultar un solo objeto sin uniones, consulte consultar de un solo objeto mediante el asistente.

    Sugerencia

    Si la lista no se completa con los objetos disponibles incluso después de aplicar un filtro, la Conexión de base de datos puede no funcionar correctamente. Asegúrese 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.

    • Principal: En cada objeto secundario que se une, use el menú desplegable para seleccionar el nombre del objeto que debe ser el principal. Esto es necesario para aplicar la integridad transaccional de un objeto, así como para derivar las claves de enlace para un objeto secundario.

    • Tipo de unión: En cada objeto secundario que se une, aparece un menú desplegable después de haber asignado Teclas de enlace (que se explican a continuación). Utilice 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 principal tenga al menos 1 registro secundario y posiblemente más registros secundarios.

      • Solo uno: Este tipo de unión requiere que cada registro principal tenga 1 y solo 1 registro secundario.

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

      • Cero o Uno: Este tipo de unión permite que cada registro principal tenga 0 registros secundarios o solo 1 registro secundario.

    • Teclas de enlace: En cada objeto secundario que se une, una vez que se selecciona un objeto como Principal, aparece un enlace rojo Asignar dentro de este campo. Haga clic en Asignar para abrir una ventana independiente donde puede asignar las teclas de enlace:

      

      • Objeto principal: El objeto principal y la lista de campos se muestran en la columna de la izquierda. Los campos utilizados como claves principales dentro de la base de datos se indican mediante un icono de llave. Si tiene una gran cantidad de campos, puede utilizar el cuadro de búsqueda para filtrar los campos por nombre.

      • Objeto secundario: El objeto secundario y la lista de campos se muestran en la columna de la derecha. Si tiene una gran cantidad de campos, puede usar el cuadro de búsqueda para filtrar los campos por nombre.

      • Asignar clave(s) de vínculo: Para asignar un campo como clave de enlace, arrastre un campo desde el objeto principal a la izquierda hasta un campo dentro del objeto secundario a la derecha, o viceversa. Para asignar varias claves de enlace, repita este proceso según sea necesario.

      • Desasignar clave(s) de vínculo: Para desasignar claves de enlace, haga clic en cualquier campo que ya se haya vinculado. Los campos vinculados se deseleccionan.

      • Comenzar de nuevo: Para borrar todas las claves de enlace asignadas, haga clic en Comenzar de nuevo ubicado debajo de la lista principal a la izquierda.

      • Finalizar: Haga clic en Finalizar para guardar las claves de enlace asignadas y cerrar la ventana. En Claves de vínculo, debería ver ahora la cantidad de claves de enlace asignadas, en las que puede hacer clic para volver a abrir la ventana de asignación de claves de enlace. Además, el menú desplegable Tipo de unión estará disponible para que establezca el tipo de relación (cardinalidad) entre los objetos seleccionados:

        

    • Eliminar: Para eliminar un objeto seleccionado de la tabla, pase el cursor sobre la columna más a la derecha y haga clic en el eliminar icono.

    • 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 con el siguiente paso. Este botón no se habilitará hasta que haya especificado los objetos principales, haya establecido el tipo de unión y haya asignado claves de enlace. 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: Si está presente, no haga clic en las palabras Omitir asistente/Escribir declaración SQL. Esto hará que se ignoren todos los objetos seleccionados en este paso y, en su lugar, se utilice una declaración SQL en el siguiente paso que anule las selecciones realizadas aquí.

    • 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 solicitará que confirme que desea descartar los cambios.

Paso 2: Agregar Condiciones¶

• Fuente: Esta sección muestra los campos del objeto seleccionado que están disponibles en el extremo de la base de datos. Si la base de datos identifica un campo como una clave, entonces se debe incluir dicho campo.

  • Buscar: Ingrese 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 de la lista 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 contraídos no se seleccionan). Este modo de selección no está disponible si se utilizan selecciones a nivel de objeto, pero sí está disponible cuando se utiliza el cuadro de búsqueda.
  • Seleccionar campos: Seleccione las casillas de verificación de los campos que desea incluir en la consultar para que se agreguen automáticamente a la declaración SQL de la derecha. También puede seleccionar un objeto completo para seleccionar todos sus campos a la vez.

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

  • Condición de filtro: Si lo desea, ingrese una condición en forma de argumento de una cláusula WHERE; es decir, operador(es) seguido de valor(es). Para ver ejemplos de cláusulas WHERE, consulte Información específica de la base de datos.

    Precaución

    Si proporciona una cláusula WHERE manualmente, debe ingresarla con la sintaxis que requiere la base de datos.

    Consejo

    Al utilizar variables globales en una cláusula WHERE, se recomienda especificar un valor predeterminado para que sea posible realizar pruebas de secuencia de comandos. De lo contrario, dado que las variables globales obtienen su valor en tiempo de ejecución, la sintaxis puede invalidarse durante las pruebas si no se especifica un valor predeterminado.

  • Ordenar: Si lo desea, utilice el menú desplegable para seleccionar 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.

    Precaución

    El uso de ORDER BY en los campos secundarios también afecta a los registros principales.

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

• Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Terminado 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 solicitará 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 vuelven a mostrar más adelante durante la asignación de transformación proceso, donde puede asignar campos de destino utilizando objetos de origen, secuencias de comandos, variables, valores personalizados y más.

  Nota

  Para actualizar un esquema de datos en una actividad existente, debe avanzar nuevamente a través de cada paso de configuración de la actividad, realizando al menos un cambio (como agregar y quitar 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.

• Terminado: 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 los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Consultar Manual¶

Siga estos pasos si conoce la declaración SQL para la consultar y desea proporcionarla manualmente. Esta opción solo está disponible con conexiones de base de datos que utilizan un controlador JDBC y no está disponible para aquellas configuradas con ODBC. Si aún no conoce la declaración o si la conexión utiliza ODBC, siga cualquiera de las siguientes instrucciones: consultar de un solo objeto mediante el asistente o consultar de múltiples objetos mediante asistente arriba.

• Paso 1: Ingrese un nombre y omita el asistente
• Paso 2: Ingresar una declaración SQL
• Paso 3: Revisar el esquema de datos

Paso 1: Ingrese un Nombre y Omita el Asistente¶

• Nombre: Ingrese 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 diagonales (/) o dos puntos (:).

• Seleccionar tabla(s): No utilice esta sección, ya que no es relevante para consultas manuales. Esta sección es aplicable únicamente cuando se utiliza el asistente de consulta de base de datos (consulte consultar de un solo objeto mediante el asistente o consultar de múltiples objetos mediante asistente). En su lugar, especificará las tablas (si se requiere alguna) cuando ingrese la declaración SQL en el siguiente paso.

• 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: Este botón no debe estar habilitado, ya que solo es aplicable cuando se utiliza el asistente de consulta de base de datos (consulte consultar de un solo objeto mediante el asistente o consultar de múltiples objetos mediante asistente).

• Omitir asistente/Escribir declaración SQL: Haga clic en Omitir asistente/Escribir declaración SQL para continuar con el siguiente paso y proporcionar la declaración SQL manual.

  Advertencia

  Si ha seleccionado alguna tabla, se perderán sus selecciones.

• 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 solicitará que confirme que desea descartar los cambios.

Paso 2: Ingrese una Declaración SQL¶

• Escribir o pegar una sentencia SQL: Introduzca la consultar SQL en el cuadro de texto. Nota:

  • Todas las declaraciones SQL deben ser compatibles con ANSI-SQL para el controlador JDBC de la base de datos a la que está accediendo.

  • Hay un límite de 2000 caracteres para la declaración SQL.

    Nota

    Una solución alternativa para las sentencias SQL que exceden el límite de caracteres es crear vistas de base de datos.

  • Para utilizar variables, introdúzcalas utilizando la sintaxis de corchetes que se describe en la documentación para variables globales, variables del proyecto, o variables Jitterbit.

  • Al utilizar variables globales en una cláusula WHERE, recomendamos especificar un valor predeterminado para que sea posible realizar pruebas de secuencia de comandos. De lo contrario, dado que las variables globales obtienen su valor en tiempo de ejecución, la sintaxis puede invalidarse durante las pruebas si no se especifica un valor predeterminado. Para ver ejemplos de cláusulas WHERE, consulte Información específica de la base de datos.

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

  • También puede utilizar funciones definidas por el usuario (UDF) dentro de la declaración SQL utilizando <udf> función. Esta función le permite utilizar cualquier función de base de datos compatible con la base de datos de destino, como la TO_DATE función en Oracle, o la CONVERT() Función en SQL Server. Ver detalles en Funciones de base de datos.

• Consulta de prueba: Haga clic en este botón para validar si la consultar es válida. Si la consultar no es válida, aparecerán mensajes de error con detalles adicionales. Si la consultar es válida, se mostrará una muestra de hasta 20 registros en una tabla similar a la que se muestra a continuación:

  

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 vuelven a mostrar más adelante durante la asignación de transformación proceso, donde puede asignar campos de destino utilizando objetos de origen, secuencias de comandos, variables, valores personalizados y más.

  Nota

  Para actualizar un esquema de datos en una actividad existente, debe avanzar nuevamente a través de cada paso de configuración de la actividad, realizando al menos un cambio (como agregar y quitar 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.

• Terminado: 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 los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Próximos Pasos¶

Después de configurar una actividad de consulta de base de datos, puede usarla dentro de una operación o secuencia de comandos como se describe a continuación. Además, si se encuentra con límites de registros impuestos por el destino, es posible que desee utilizar la fragmentación de datos.

Completar la Operación¶

Después de configurar una actividad de consulta de base de datos, complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar los ajustes de operación de una operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujos de trabajo o en flujos de trabajo diferentes.

Una vez que se ha creado una actividad de consulta de base de datos, se puede acceder a las acciones del menú para esa actividad desde el panel del proyecto en las pestañas Flujos de Trabajo o Componentes, y desde el tela de diseño. Consulte menú de acciones de la actividad para más detalles.

Las actividades de consulta de base de datos se pueden utilizar como fuente con estos patrones de operación:

• Patrón de Transformación
• Patrón de archivo de dos objetivos (solo como primera fuente)
• Patrón de archivo HTTP de dos destinos (solo como primera fuente)
• Patrón de dos transformaciones (solo como primera fuente)

No son válidos otros patrones si se utilizan actividades de consulta de base de datos. Consulte los patrones de validación en Validez de la operación página.

Dentro de una transformación, si se utiliza la opción duplicar un esquema proporcionada por una actividad de base de datos que utiliza una sola tabla (sin uniones), 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 todos los registros pasen por él (consulte Nodos de bucle en Nodos y campos).

Además, si se unen tablas de bases de datos, tenga en cuenta que los valores de los campos unidos de una tabla secundaria son, de manera predeterminada, los valores de los campos unidos de la tabla principal. Los campos unidos de una tabla secundaria no se pueden asignar a.

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

Uso de Actividades de Base de Datos en Secuencias de Comandos¶

Las actividades de consulta de base de datos también se pueden referenciar en un secuencia de comandos para usar con funciones de secuencia de comandos que utilizan un databaseId como parámetro, incluyendo estos:

Funciones de Jitterbit Script

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

Funciones Jitterbit de JavaScript

• Jitterbit.DbExecute- Jitterbit.DbLookup

Para obtener más detalles sobre cómo hacer referencia a extremos en secuencias de comandos, consulte Extremos en Jitterbit Script o Extremos en JavaScript.

Utilice Fragmentación de Datos¶

Al utilizar la fragmentación de datos 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). Luego, estos archivos se combinan en un solo archivo de destino.

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