Con los parámetros, puedes pedir valores para utilizar con los filtros o cálculos de una consulta cada vez que se ejecute. Al establecer estos valores en tiempo de ejecución, puedes utilizar una consulta en un contexto diferente (como cuenta, región o periodo) cada vez que se ejecute.
Puedes crear parámetros personalizados para utilizarlos con una consulta concreta, o el propietario de tu espacio de trabajo puede crear parámetros globales para utilizarlos con varias consultas.
Crear parámetros a medida para una consulta
Puedes establecer los parámetros de una consulta en el Generador o en el Editor SQL. Cuando creas un parámetro, puedes utilizarlo con varios filtros y cálculos en la consulta.
Paso 1. Crea el parámetro
- En el panel Parámetros , haz clic en Añadir, y selecciona Crear nuevo parámetro.
<!-- -
From the Parameters
panel, click
Create Parameter.
--> - Para ayudar a identificar el parámetro, introduce un nombre que sea único con solo caracteres alfanuméricos y sin espacios.
- En Tipo de filtro, selecciona el tipo de datos por el que quieres filtrar, como Texto o Entero.
Paso 2. Establecer los valores del parámetro
Cuando se ejecuta una consulta, sus parámetros pueden aceptar valores de forma libre -basados en el tipo de datos- o proporcionar una lista de valores específicos entre los que elegir.
- Para aceptar cualquier valor de forma libre, introduce el valor predeterminado (si procede) y haz clic en Crear.
- Proporcionar una lista de valores específicos:
- Activar Lista de selección.
- Para activar varios valores para el parámetro, marca la casilla Selección múltiple .
- En Opciones de lista, introduce los valores a elegir, pulsando Introducir después de cada uno.
Nota: Para un parámetro de fecha o fecha-hora, introduce cada opción en el formato
AAAA-MM-dd. - Selecciona cualquier valor predeterminado para el parámetro y haz clic en Aceptar.
Nota: Para un parámetro de selección múltiple, selecciona al menos un valor predeterminado.
- Haz clic en Crear para terminar.
Paso 3. Utilizar el parámetro en la consulta
Para aplicar el valor del parámetro a la consulta, utilízalo en un filtro o en un cálculo:
- Para establecer el valor de un filtro en función del parámetro en Generador, selecciónalo cuando definas el filtro desde el panel derecho Propiedades de filtro.
Nota: Para un parámetro de selección múltiple, selecciona un operador de filtro de Está en la lista o No está en la lista en la pestaña Filtros.
- Para utilizar el parámetro con un filtro en el Editor SQL o referenciar su valor en un cálculo, introduce su nombre después de dos puntos (
:) en la sentencia SQL, como:ReportingPeriod.
Utilizar parámetros globales en una consulta
El propietario de tu Espacio de trabajo puede configurar Parámetros globales para valores comunes utilizados con varias consultas. Para utilizar parámetros globales en una consulta:
- Desde el panel Parámetros , haz clic en Añadir, y selecciona Seleccionar parámetro global.
- Selecciona los parámetros globales que quieras utilizar en la consulta y haz clic en Agregar a.
- Para editar el parámetro global, selecciónalo y actualiza su nombre o valor según sea necesario para la consulta.
Nota: Para garantizar un análisis coherente, el propietario de tu espacio de trabajo puede bloquear un parámetro global para impedir que se edite su valor.
-
Para aplicar el valor de un parámetro global a la consulta, utilízalo en un filtro o en un cálculo:
- Para establecer el valor de un filtro en función del parámetro en Generador, selecciónalo cuando definas el filtro desde el panel derecho Propiedades de filtro.
Nota: Para un parámetro de selección múltiple, selecciona un operador de filtro de Está en la lista o No está en la lista en la pestaña Filtros.
- Para hacer referencia al parámetro en el Editor SQL, introduce su nombre después de dos puntos (
:) en la sentencia SQL, como:ReportingPeriod. - Para hacer referencia al valor de un parámetro en la sentencia SQL de un cálculo, selecciona el parámetro desde el menú Parámetros.
- Para establecer el valor de un filtro en función del parámetro en Generador, selecciónalo cuando definas el filtro desde el panel derecho Propiedades de filtro.
Editar un parámetro de consulta
Para ajustar o gestionar los detalles de un parámetro:
- Desde el panel Parámetros, selecciona el parámetro a editar.
- Edita el nombre del parámetro, el tipo de datos o los valores según sea necesario.
- Haz clic en Aplicar.
Quitar un parámetro de consulta
Si ya no necesitas un parámetro, puedes eliminarlo de la consulta. Desde el panel Parámetros, haz clic en el parámetro Eliminar , y haz clic en Guardar .