Consultas personalizadas

Una consulta personalizada es una forma de seleccionar datos de un origen de datos externo en una conexión de datos, con el uso de su propia consulta de base de datos personalizada. Es una alternativa a la selección de tablas y columnas en los cuadros de diálogo de tipo apuntar y hacer clic Seleccionar datos o Vistas de la conexión. Con una consulta personalizada, puede aplicar sus conocimientos en SQL y realizar una selección de datos muy específica. El resultado de una consulta personalizada es una tabla de base de datos a la que puede acceder como una tabla de datos en Spotfire.

En esta página

Agregar una consulta personalizada en una conexión de datos

En un cliente instalado de Spotfire, puede agregar una consulta personalizada a su conexión de datos cuando selecciona datos en el cuadro de diálogo Vistas de la conexión.

Antes de empezar

Para poder agregar y editar consultas personalizadas en conexiones de datos, tenga en cuenta los siguientes requisitos:

Para agregar y editar consultas personalizadas, debe utilizar un cliente instalado de Spotfire.
No todos los conectores de datos admiten el uso de consultas personalizadas.
Se requiere una licencia de Consulta personalizada en conexiones para agregar y editar consultas personalizadas. Para poder confiar en las consultas personalizadas y que otros usuarios puedan abrirlas, también debe ser miembro del grupo de usuarios Autor de consultas personalizadas.
Las consultas personalizadas se escriben en el lenguaje de consulta de la base de datos externa. Para obtener más información, consulte Escribir consultas personalizadas.

Procedimiento

Crear una nueva conexión de datos (Archivos y datos > Conectar con) o editar una conexión de datos existente en su análisis o biblioteca.
En el cuadro de diálogo Seleccionar datos o Vistas en la conexión, haga clic en Agregar consulta personalizada (o bien Consulta personalizada > Nueva consulta personalizada).

En el cuadro de diálogo Consulta personalizada, escriba un Nombre de consulta.
En el campo Consulta, escriba su consulta de base de datos.
Cuando haya completado su consulta, haga clic en Verificar para probar la consulta y recuperar las Columnas de resultados.Si hay algún error en la consulta, se muestra información sobre el error. Corrija los errores y ejecute Verificar nuevamente para asegurarse de que los problemas se hayan resuelto.
Vaya a Columnas de resultados y asegúrese de que aparecen todas las columnas de resultados deseadas y que son del tipo de datos correcto.

Consejo: Edición de columnas de resultados
Solo las columnas de la lista de la columna Resultados se incluyen en la tabla de datos final, incluso si la consulta selecciona más columnas. Puede excluir columnas no deseadas de la consulta con el botón Eliminar, sin tener que cambiar la consulta. También puede cambiar el orden de las columnas con los botones Subir y Bajar.

El nombre y el tipo de datos de las columnas deben coincidir con el nombre y el tipo de datos del origen de datos externo. Para cambiar el nombre de una columna de la tabla de consulta personalizada resultante, hágalo en el cuadro de diálogo Vistas de la conexión, después de que haya terminado de crear la consulta personalizada.
Para finalizar la consulta personalizada y agregarla a la conexión de datos, haga clic en Aceptar.

Resultados

La tabla personalizada basada en la consulta personalizada se agrega a la lista de tablas/vistas seleccionadas de la conexión. Puede trabajar con la tabla personalizada como lo haría con otras tablas. Por ejemplo, puede combinarla con otras tablas con relaciones estructurales y puede importar o conservar los datos como datos externos en la base de datos.

Escribir consultas personalizadas

Cuando se escribe una consulta personalizada, existen requisitos, limitaciones y pautas generales que deben tenerse en cuenta.

Las consultas personalizadas se escriben en el lenguaje del origen de datos externo. Esto significa que la forma en que se escribe la consulta depende del tipo de origen de datos al que se conecte. Por ejemplo, para una base de datos de Microsoft SQL Server, la consulta personalizada se escribiría en el dialecto SQL de Microsoft SQL Server.

Cuando se usa una consulta personalizada para acceder a los datos de un origen de datos externo, la consulta personalizada se envuelve como una subconsulta en una cláusula FROM de la consulta final que Spotfire envía el origen de datos externo. Por ejemplo, a continuación se muestra una consulta personalizada para una conexión de Microsoft SQL Server:

SELECT Country,AVG(Sales) AS AvgCountrySales FROM "World Sales" GROUP BY Country

Si importa la vista resultante de esta consulta personalizada como una tabla de datos en Spotfire, Spotfire enviará la siguiente consulta al origen de datos externo. Observe cómo la consulta personalizada original se incluye como una subconsulta en la cláusula FROM de la instrucción SELECT:

SELECT [SpotfireCustomQuery1].[Country] AS [Country], [SpotfireCustomQuery1].[AvgCountrySales] AS [AvgCountrySales] FROM (SELECT Country,AVG(Sales) AS AvgCountrySales FROM "World Sales" GROUP BY Country) AS [SpotfireCustomQuery1]

Consejo: Para inspeccionar las consultas que Spotfire envía a orígenes de datos externos, puede habilitar el registro y revisar el registro de consultas del conector.

La consulta personalizada se evalúa cada vez que se realiza una consulta normal desde Spotfire. Si utiliza la consulta personalizada para una tabla de datos en la base de datos (externa), la consulta personalizada se ejecuta cada vez que se actualiza una visualización o un filtro. Para las tablas de datos (importadas) en la memoria, es decir, cuando los datos se cargan en el motor de datos de Spotfire, la consulta solo se ejecutará cuando los datos se importen o se actualicen de forma explícita.

Requisitos y limitaciones de la consulta

Las consultas se escriben en el lenguaje de la base de datos externa. Por ejemplo, para una base de datos de Microsoft SQL Server, la consulta personalizada se escribiría en el dialecto SQL de Microsoft SQL Server. Para obtener información específica sobre cómo escribir consultas para un determinado tipo de origen de datos, consulte siempre la documentación oficial de ese origen de datos externo. Las capacidades, las limitaciones y las reglas de sintaxis dependen del tipo de origen de datos al que se conecte.
La consulta personalizada debe poder ejecutarse como una subconsulta en una cláusula FROM. Consulte la documentación oficial del origen de datos externo para obtener más información.
Nota: Las subconsultas en cláusulas FROM a veces se denominan tablas derivadas.
La consulta personalizada debe estar formada por una sola instrucción. No se pueden encadenar varias instrucciones separadas por punto y coma ";".
Las consultas personalizadas no admiten procedimientos almacenados.
No se admiten expresiones de tabla comunes (CTE) porque requieren la palabra clave WITH.

Tipos de datos

Cuando cree una consulta personalizada, incluya únicamente columnas con tipos de datos que realmente sean compatibles con Spotfire. Consulte la documentación para el conector que se utiliza actualmente para obtener una lista de los tipos de datos admitidos.

Si se incluye una columna no compatible en la consulta, se marca como no válida en el paso de verificación y no se puede utilizar la tabla resultante. Para resolver estos problemas, vuelva a escribir la consulta para excluir las columnas no admitidas o elimine las columnas de la tabla resultante. Siempre se puede asignar un tipo de datos arbitrarios a una columna de consulta personalizada. Sin embargo, no hay ninguna garantía de que la tabla Spotfire resultante de una consulta personalizada funcione.

Seguridad: confiar en consultas personalizadas

Ningún otro usuario podrá ejecutar una consulta personalizada que usted haya creado, a menos que se cumplan dos condiciones:

Debe guardar la consulta personalizada en la biblioteca como parte de un análisis o de una conexión de datos.
Debe ser miembro del grupo Autor de consultas personalizadas, lo que implica que tiene autorización para crear consultas personalizadas en nombre de otros usuarios, y confiar en ellas.

Se pueden compartir consultas personalizadas que se hayan creado con otro usuario, pero dicho usuario deberá revisar la consulta personalizada y confiar en ella. Un usuario puede confiar en una consulta personalizada abriendo el cuadro de diálogo Consulta personalizada, examinando el texto de la consulta personalizada y haciendo clic en Aceptar.