Actividad de Consulta de Base de Datos¶

Introducción¶

Una consulta de base de datos consulta datos desde un extremo de base de datos y está diseñada para usarse como fuente para proporcionar datos a una operación o para ser llamada 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 cópielo y péguelo en el tela de diseño. Para obtener más información, consulte Creación de una instancia de actividad en Reutilización de componentes.

Una actividad existente se puede editar desde estas ubicaciones:

• El tela de diseño (consulte Menú de acciones del componente en Tela de Diseño).
• La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña Componentes del panel de proyecto).

Configurar una Actividad de Consulta 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:

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

Consulta de Objeto Único Mediante el Asistente¶

Siga estos pasos para utilizar el asistente si está consultando un solo objeto y no necesita crear ninguna combinación con otros objetos. Si necesita unir varios objetos, consulte Consulta de múltiples objetos mediante el asistente, o si ya conoce la declaración SQL y está utilizando un controlador JDBC, consulte Consulta 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: Introduzca un nombre que se utilizará 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 usando cualquier filtro aplicado, después de usar el ícono 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 recuperación de los objetos incluso después de aplicar filtros, utilice una sentencia SQL manual.

  • Ver: Utilice 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: Ingrese cualquier parte del nombre del objeto 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 es posible 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 escrito en el cuadro de búsqueda filtrará automáticamente la lista.

    • Si busca objetos que aún no se han recuperado, por ejemplo, cuando intenta limitar la cantidad de objetos recuperados para bases de datos con una gran cantidad de objetos, use el ícono de actualización al lado del cuadro de búsqueda para recuperar los objetos de la base de datos utilizando 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 debe usarse para la carga inicial de cualquier objeto. Además, también puede resultar ú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 permitirle 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 de la derecha. Si está consultando varios objetos que deben unirse, consulte Consulta de múltiples objetos mediante el asistente.

    Consejo

    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 tener éxito. 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 (pase el cursor sobre la columna situada más a la derecha y haga clic en el icono de eliminación).icono de eliminación). Si está consultando varios objetos que deben unirse, consulte Consulta de múltiples objetos mediante el asistente.

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

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

• Omitir asistente/Escribir instrucción SQL: Si está presente, no haga clic en las palabras Omitir asistente/Escribir instrucción SQL. Esto hará que todos los objetos seleccionados en este paso se ignoren y, en su lugar, se utilice una instrucción SQL en el siguiente paso que anula cualquier selección realizada 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 pide que confirme que desea descartar los cambios.

Paso 2: Agregar Condiciones¶

• Seleccionar campos: Esta sección muestra campos para 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 cualquier parte del nombre del campo 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 enumerados 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.

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

• Cláusula WHERE (opcional): Para agregar una cláusula WHERE, puede usar los campos 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 usando 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 los operadores apropiados:

    Aritmética
    Operador	Descripción
    +	Añadir
    -	Restar
    *	Multiplicar
    /	Dividir
    %	Módulo

    Bit a bit
    Operador	Descripción
    &	Bit a bit Y
    |	Bit a bit O
    ^	XOR bit a bit (OR exclusivo)

    Comparación
    Operador	Descripción
    =	Igual a
    >	Mayor que
    \<	Menos de
    >=	Mayor o igual a
    \<=	Menor o igual a
    !=	No igual a

    Compuesto
    Operador	Descripción
    +=	Sumar iguales
    -=	Restar es igual
    *=	Multiplicar es igual
    /=	Dividir es igual
    %=	Módulo es igual a
    &=	Bit a bit Y es igual a
    |*=	Bit a bit O 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 AND son VERDADERAS
    CUALQUIER	VERDADERO si alguno de los valores de la subconsulta cumple la condición
    ENTRE	VERDADERO si el operando está dentro del rango de comparaciones
    EXISTE	VERDADERO si la subconsulta devuelve uno o más registros
    EN	VERDADERO 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 ES VERDADERA
    O	VERDADERO 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 deseado para usar con las selecciones desplegables.

    Consejo

    Cuando se utilizan 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 la prueba si no se especifica ningún valor predeterminado.

  • Agregar: Haga clic en enlace para construir automáticamente la cláusula en función de las selecciones desplegables 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 a los registros principales.

  Consejo

  Para agregar múltiples condiciones a la cláusula WHERE, repita el proceso agregando selecciones adicionales. Tenga en cuenta que es posible que necesite 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 proporcionan 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 muestran nuevamente 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 eliminar un carácter al final del nombre de la actividad ) para forzar una actualización del esquema.

• Volver: Haga clic para almacenar temporalmente la configuración de este paso y volver 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 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.

Consulta de Múltiples Objetos Mediante el Asistente¶

Siga estos pasos si está consultando varios objetos y creando uniones entre ellos. Si necesita consultar un solo objeto, consulte Consulta de un solo objeto mediante el asistente, o si ya conoce la declaración SQL y está utilizando un controlador JDBC, consulte Consulta 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: Introduzca un nombre que se utilizará 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 usando cualquier filtro aplicado, después de usar el ícono 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 recuperación de los objetos, incluso después de aplicar filtros, utilice una instrucción SQL manual.

  • Ver: Utilice 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: Ingrese cualquier parte del nombre del objeto 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 es posible 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 escrito en el cuadro de búsqueda filtrará automáticamente la lista.

    • Si busca objetos que aún no se han recuperado, por ejemplo, cuando intenta limitar la cantidad de objetos recuperados para bases de datos con una gran cantidad de objetos, use el ícono de actualización al lado del cuadro de búsqueda para recuperar los objetos de la base de datos utilizando 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 debe usarse para la carga inicial de cualquier objeto. Además, también puede resultar ú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 permitirle 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 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 cambio, necesita consultar un único objeto sin uniones, consulte Consulta de objeto único mediante el asistente.

    Consejo

    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 tener éxito. 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.

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

    • Tipo de unión: En cada objeto secundario que se une, aparece un menú desplegable disponible después de haber asignado Claves de enlace (que se explica 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.

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

      

      • Objeto principal: El objeto principal y la lista de campos se muestran en la columna de la izquierda. Cualquier campo utilizado como clave principal dentro de la base de datos se indica mediante un icono de clave . 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 utilizar el cuadro de búsqueda para filtrar los campos por nombre.

      • Asignar clave(s) de enlace: Para asignar un campo como clave de enlace, arrastre un campo desde el objeto principal a la izquierda a 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 enlace: Para cancelar la asignación de claves de enlace, haga clic en cualquier campo que ya haya sido vinculado. Los campos vinculados quedan deseleccionados.

      • 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 enlace, ahora debería ver 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 está disponible para que usted establezca el tipo de relación (cardinalidad) entre los objetos seleccionados:

        

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

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

    • Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el siguiente. Este botón no se habilitará hasta que haya especificado cualquier objeto Padre, establezca el Tipo de unión y asigne 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 instrucción SQL: Si está presente, no haga clic en las palabras Omitir asistente/Escribir instrucción SQL. Esto hará que todos los objetos seleccionados en este paso se ignoren y, en su lugar, se utilice una instrucción SQL en el siguiente paso que anula cualquier selección realizada 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 pide que confirme que desea descartar los cambios.

Paso 2: Agregar Condiciones¶

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

  • Buscar: Ingrese cualquier parte del nombre del campo 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 enumerados 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 están seleccionados). 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: 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(s) 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 en la sintaxis que requiere la base de datos.

    Consejo

    Cuando se utilizan 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 la prueba si no se especifica ningún valor predeterminado.

  • Ordenar: Si lo desea, use el menú desplegable para seleccionar entre 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 los registros principales.

• Volver: 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 para este paso y continuar con el siguiente. 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 muestran nuevamente 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 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 al final del nombre de la actividad ) para forzar una actualización del esquema.

• Volver: Haga clic para almacenar temporalmente la configuración de este paso y volver 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 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.

Consulta Manual¶

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

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

Paso 1: Ingrese un Nombre y Omita el Asistente¶

• Nombre: Introduzca un nombre que se utilizará 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 (:).

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

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

• Siguiente: Este botón no debe estar habilitado, ya que solo se aplica cuando se utiliza el asistente de consulta de base de datos (consulte Consulta de un solo objeto mediante el asistente o Consulta de múltiples objetos mediante el asistente).

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

  Advertencia

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

• 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: Ingrese una Declaración SQL¶

• Escribir o pegar declaración SQL: Ingrese la declaración de consultar SQL en el cuadro de texto. Nota:

  • Todas las declaraciones SQL deben ser compatibles con ANSI-SQL para el controlador ODBC o 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 declaraciones SQL que exceden la limitación de caracteres es crear vistas de bases de datos.

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

  • Cuando se utilizan 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 la prueba si no se especifica ningún 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 usando el <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 el 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, los mensajes de error proporcionan 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 muestran nuevamente 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 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 al final del nombre de la actividad ) para forzar una actualización del esquema.

• Volver: Haga clic para almacenar temporalmente la configuración de este paso y volver 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 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.

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 objetivo, es posible que desee utilizar fragmentación de datos.

Completa 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 flujo de trabajo o en diferentes flujos de trabajo.

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 actividad para 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)

Otros patrones no son válidos al utilizar 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 para reflejar un esquema proporcionado 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 asignan campos dentro de este nodo adicional, el nodo se convierte en un nodo de bucle para permitir que se realicen bucles en todos los registros (consulte Nodos de bucle en Nodos y campos).

Además, si une tablas de bases de datos, tenga en cuenta que los valores de los campos unidos de una tabla secundaria son los valores predeterminados de los campos unidos de la tabla principal. No se pueden asignar los campos unidos de una tabla secundaria.

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

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

También se puede hacer referencia a las actividades de consulta de base de datos en un secuencia de comandos para usar con funciones de secuencia de comandos que utilizan un databaseId como parámetro, incluidos 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.

Usar Fragmentación¶

Cuando se utiliza 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 archivo de destino.

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