Parámetros en consultas personalizadas

Si desea que la consulta recupere distintos resultados dependiendo del valor de una o más variables, puede configurar la consulta para utilizar parámetros. Puede asignar un parámetro, por ejemplo, a un control de propiedad en un área de texto.

Se hace referencia a un parámetro mediante la sintaxis ?parametername, donde parametername es un nombre que se selecciona para el parámetro. El tipo de datos se define en la ficha Parámetros del cuadro de diálogo Consulta personalizada.

Ejemplo

SELECT Col1, Col2 FROM Table WHERE Col1 > ?Param1

Nota: No puede utilizar parámetros para controlar de qué tabla de base de datos se seleccionarán los datos. Por ejemplo, no es posible escribir una consulta personalizada como esta:

SELECT * FROM ?parametername

La razón es que un parámetro no puede almacenar identificadores de tabla. Las cadenas y los identificadores de tabla normalmente se controlan de forma diferente en las consultas SQL.

Agregar parámetros a una consulta personalizada

Para utilizar parámetros en una consulta personalizada, debe llamar al parámetro en la consulta y configurar los parámetros en el cuadro de diálogo Consulta personalizada.

Antes de empezar

Para obtener más información sobre cómo crear y escribir consultas personalizadas, consulte Consultas personalizadas.

Procedimiento

Para crear una consulta personalizada, siga los pasos de Agregar una consulta personalizada en una conexión de datos.
En el cuadro de diálogo Consulta personalizada, escriba su consulta. Si desea llamar al parámetro de la consulta, especifíquelo con un signo de interrogación delante del nombre del parámetro.
Por ejemplo:
```
SELECT Col1, Col2 FROM Table WHERE Col1 > ?Param1
```
En la ficha Parámetros, agregue y especifique todos los parámetros de su consulta. Para agregar un parámetro, haga clic en Nuevo...
En el cuadro de diálogo Nuevo parámetro, escriba la información del parámetro: el nombre, el tipo de datos de Spotfire y el tipo de datos en el origen de datos externo.
Para guardar los cambios y cerrar el cuadro de diálogo Consulta personalizada, haga clic en Aceptar.

Usar consultas personalizadas con parámetros

Tipos de datos y parámetros

En muchos casos, varios tipos de datos de base de datos se asignarán a un único tipo de datos de Spotfire. Por ejemplo, los tipos de datos de Microsoft SQL Server varchar, nvarchar, text y ntext se asignarán al tipo de datos String (Cadena) de Spotfire. En esos casos, cuando declara el tipo de parámetro, también puede especificar el tipo de datos en el sistema externo. Es decir, puede tener un parámetro del tipo de datos String (Cadena) de Spotfire que sea un nvarchar en el sistema externo. Aunque Spotfire no puede asignar automáticamente el tipo externo del parámetro, una especificación manual del tipo externo puede hacer que la consulta sea más eficaz. Si hay una asignación uno a uno entre el tipo de Spotfire y el tipo externo, se deshabilitará la lista desplegable de tipo externo.

Parámetros personalizados

Siempre que usted y los usuarios finales del análisis hayan iniciado sesión en Spotfire Server, también podrá utilizar uno o varios de los parámetros predefinidos de las consultas personalizadas: current_user, current_groups y current_user_domain, que se activan al seleccionar la casilla de verificación Utilizar parámetros para las consultas personalizadas (usuarios y grupos). Estos parámetros funcionan del mismo modo que cuando se utilizan en el Diseñador de información, proceso que se describe en Vínculos de información personalizados.

Una vez activada la casilla de verificación puede utilizar los parámetros de consulta personalizada en la consulta personalizada. El tipo de estos parámetros es siempre de String (Cadena) en Spotfire y el tipo externo es el valor predeterminado, por ejemplo, NVARCHAR en Microsoft SQL Server.