Opciones de IU en complementos de hoja de cálculo

Los complementos de hojas de cálculo proporcionan elementos comunes de la interfaz de usuario en varias funciones y controles adicionales específicos de paneles individuales.

Información de conexión

La sección superior de la mayoría de los paneles complementarios muestra información sobre la conexión activa, incluida la URL de la base de datos, el esquema, el estado de la conexión y el tiempo de sesión restante antes de que caduque la conexión. Para las conexiones de OCI IAM, también muestra el usuario conectado.

Note:

Aunque el complemento mantiene una conexión activa con la base de datos, los datos recuperados son locales para la hoja de cálculo. En caso de inactividad o timeout de conexión, el complemento muestra una notificación y sugiere que se vuelva a conectar a la base de datos.

Uso del Editor de Consultas SQL

El editor de consultas SQL es el área en la que se escriben, editan y visualizan las sentencias SQL antes de ejecutarlas.

Puede introducir una consulta manualmente o seleccionar tablas, vistas y columnas del explorador de objetos para ayudar a crear la sentencia SQL. El editor de consultas SQL muestra los números de línea y el resaltado de sintaxis de las consultas.

Las acciones disponibles en el editor de consultas dependen de la función de complemento que esté utilizando. En general, puede utilizar las siguientes opciones con el editor de consultas SQL:

  • Ejecutar

    El primer botón, que se muestra como un círculo con un triángulo, es el botón Run (Ejecutar). Haga clic en este botón para ejecutar la sentencia SQL y mostrar los resultados de la consulta en la hoja de trabajo seleccionada.

  • Borrar Contenido SQL

    El icono de borrador junto a Ejecutar elimina la sentencia SQL actual del editor de consultas.

  • Recuperar consulta de la hoja

    Este botón recupera la consulta SQL de la hoja de trabajo activa y la muestra en el editor de consultas SQL. A continuación, puede editar y ejecutar la consulta de nuevo.

  • Compartir como hiperenlace de tabla

    Esta opción solo está disponible para los resultados de consulta generados mediante SQL directo y Análisis de datos. Cree un hipervínculo de tabla y compártalo con otros usuarios para que puedan cargar los resultados de las consultas de solo lectura en una hoja de cálculo.

Note:

Agregar para Excel proporciona un menú flotante con opciones adicionales, como volver a cargar la ventana del complemento. Haga clic en la flecha pequeña en el lado derecho de la ventana del complemento para abrir el menú flotante.

Seleccionar hoja de trabajo para resultados de consulta

Puede utilizar la hoja por defecto o seleccionar otra hoja para mostrar los resultados.

Note:

Si ejecuta otra consulta en la misma hoja de trabajo, el complemento refresca la hoja de trabajo con el resultado de la nueva consulta.

Para utilizar otra hoja para una consulta diferente, siga cualquiera de estos pasos:

  • En Complementos de hoja de cálculo, haga clic en el botón más (+), especifique un nombre en Agregar nueva hoja de trabajo y haga clic en el botón de marca. El complemento inserta la nueva hoja al ejecutar la consulta. El botón de flecha izquierda es para cancelar y volver.

  • Inserte una nueva hoja con las opciones de Excel o Google Sheets.

A continuación, puede seleccionar la nueva hoja en Seleccionar hoja de trabajo y ver los resultados.

Información de consultas

Junto con los resultados de la consulta, la hoja de trabajo también muestra la siguiente información de consulta:

  • La URL de base de datos

  • el usuario o esquema de la base de datos que crea y ejecuta la consulta

  • la consulta SQL real

  • la configuración de refrescamiento

  • la fecha y hora del proceso de consulta

Uso de Variables de Enlace en Consultas SQL

Puede utilizar variables de enlace en una consulta SQL para proporcionar valores en tiempo de ejecución. Defina una variable de enlace en la sentencia SQL utilizando dos puntos (:) seguidos de un nombre de variable.

Por ejemplo:

SELECT *
FROM employees
WHERE city = :ct;

Al ejecutar la consulta, el complemento le solicita que introduzca un valor para la variable de enlace, :ct. Después de proporcionar un valor, por ejemplo, Austin, la consulta se ejecuta con ese valor. La información de consulta que se muestra con los resultados incluye la asignación de variable de enlace, por ejemplo, :ct=Austin.

Puede incluir varias variables de enlace en una consulta. El complemento conserva los valores utilizados recientemente para cada variable de enlace. Cuando vuelva a ejecutar la consulta, puede seleccionar un valor reciente o introducir un nuevo valor. También puede borrar los valores guardados anteriormente desde el cuadro de diálogo Parámetros de Consulta.

Refrescar resultados de consulta

Puede utilizar Refrescar Consulta para volver a ejecutar una consulta guardada y actualizar los resultados en una hoja de trabajo sin abrir los paneles SQL Directo, Análisis de Datos o Lenguaje Natural.

Para refrescar los resultados de la consulta:

  1. Seleccione una hoja de trabajo que contenga los resultados de consulta generados por los complementos de hoja de cálculo.

  2. Haga clic en Refrescar consulta.

    El complemento vuelve a ejecutar la consulta guardada y actualiza la hoja de trabajo actual con los últimos resultados.

Si el libro de trabajo contiene hojas de trabajo adicionales con resultados de consulta que se pueden refrescar, el complemento muestra el número de hojas de trabajo restantes y le solicita que las actualice. Una vez finalizada la actualización, el complemento muestra un informe que indica las hojas de trabajo que se actualizaron correctamente e identifica las hojas de trabajo que no se pudieron actualizar.

Note:

Una hoja de trabajo se puede refrescar si se guarda y conecta la conexión de base de datos correspondiente. Spreadsheet Add-ins refresca cada hoja de trabajo mediante la información de conexión guardada, incluso si esa conexión no es la conexión activa.

Una operación de refrescamiento puede fallar en los siguientes escenarios:

  • La visualización guardada ya no coincide con las columnas devueltas por la consulta.

  • Ninguna conexión guardada coincide con la URL de la base de datos y el usuario asociado a la hoja de trabajo.

  • La conexión a la base de datos necesaria está desconectada.

El informe de actualización proporciona detalles de las hojas de trabajo con fallos. Según la causa, puede actualizar la consulta o la visualización, agregar o importar una conexión guardada coincidente o volver a conectar la conexión a la base de datos necesaria antes de refrescarla de nuevo.

Manejo de Datos Grandes

Para consultas con grandes conjuntos de datos, por ejemplo, un resultado que contiene más de 10 000 registros, el complemento muestra una ventana de confirmación si desea ver el resultado completo.

Note:

Al trabajar con tablas dinámicas, cargue los datos completos para obtener resultados precisos de la agregación.

Tema principal: Uso de funciones de complementos de hoja de cálculo