Los parámetros te permiten crear informes más responsivos y personalizables. Puedes pasar parámetros de una fuente de datos a la consulta subyacente. Para usar un parámetro en tu consulta personalizada, sigue los lineamientos de sintaxis relevantes que se documentan en Ejecuta consultas con parámetros.
Parámetros estándar
Puedes usar los siguientes parámetros en cualquier consulta personalizada:
| Parámetro |
Objetivo |
|---|---|
| \@DS_START_DATE |
Obtiene el inicio del período del informe. |
| \@DS_END_DATE |
Obtiene el final del período del informe. |
| \@DS_USER_EMAIL |
Obtiene la dirección de correo electrónico del usuario que inició sesión. |
Para usar estos parámetros, haz lo siguiente:
Debajo del editor de consultas, activa los parámetros que quieras usar.
Se te pedirá que otorgues acceso a tu dirección de correo electrónico cuando actives el parámetro \@DS_USER_EMAIL.
En tu consulta, asegúrate de usar mayúsculas para los nombres de los parámetros.
Todos los valores de los parámetros se pasan como cadenas. Para manejarlos como fechas, números o algún otro tipo de datos, asegúrate de usar una función de conversión adecuada, como PARSE_DATE, PARSE_TIMESTAMP o CAST.
Usa parámetros de fecha para pasar períodos a la consulta subyacente
Si tu informe incluye un control de período, los usuarios pueden usarlo para solicitar diferentes fechas de inicio y finalización de los datos.
Usa el parámetro de correo electrónico para proporcionar acceso a los datos a nivel de la fila
El parámetro de correo electrónico te permite mostrar solo los datos asociados con el usuario que accedió a un informe, una fuente de datos o una exploración. Ese usuario debe haber accedido a una Cuenta de Google y debe dar su consentimiento para proporcionar su dirección de correo electrónico a Looker Studio. Si el usuario no otorga su consentimiento, todos los gráficos del informe basados en esta fuente de datos mostrarán un error de autorización.
Parámetros personalizados
Puedes usar cualquier parámetro que crees en la interfaz de usuario de Looker Studio en tu consulta personalizada.
Crea un parámetro en la página de conexión
- Debajo del editor de consultas personalizado, haz clic en +AGREGAR PÁRMETRO.
- Configura las opciones de parámetros.
- Haz clic en Aceptar.
Oculta los parámetros personalizados en la fuente de datos
De forma predeterminada, los parámetros personalizados se pueden modificar en los informes. Para evitar que los editores de informes cambien el valor de un parámetro, puedes ocultarlo.
- A la derecha del parámetro, haz clic en Más opciones
. - Haz clic en Ocultar.
Obtén más información para permitir parámetros de fuentes de datos en los informes.
Usa un parámetro en una consulta personalizada
En el cuerpo de tu consulta personalizada, reemplaza un valor codificado por un identificador que comience con el carácter @. Por ejemplo: \@param_name.
Ejemplos de parámetros
Ejemplo de parámetro personalizado:
SELECT word FROM `TABLE` WHERE corpus = @corpus;
Usa una cadena con el operador contiene y un número:
SELECT * FROM `bigquery-public-data.baseball.games_post_wide`
WHERE REGEXP_CONTAINS(gameId, @s)
AND attendance > @attendance LIMIT 100;
Usa un parámetro de cadena de selección múltiple. Ten en cuenta el uso de UNNEST para aplanar la lista de valores:
SELECT * from user.users as user WHERE display_name in UNNEST(@name);
Ejemplo de parámetro de fecha (la fecha está en formato estándar):
SELECT creation_date, age, display_name from user.users as user
WHERE creation_date > PARSE_DATE('%Y%m%d', @DS_START_DATE)
AND creation_date < PARSE_DATE('%Y%m%d', @DS_END_DATE);
Ejemplo de parámetro de fecha (la fecha es una marca de tiempo de Unix en microsegundos):
SELECT creation_date, age, display_name from user.users as user
WHERE creation_date > UNIX_MICROS(PARSE_TIMESTAMP('%Y%m%d', @DS_START_DATE))
AND creation_date < UNIX_MICROS(PARSE_TIMESTAMP('%Y%m%d', @DS_END_DATE));
Ejemplo de parámetro de correo electrónico:
Select * from Sales WHERE sales-rep-email = @DS_USER_EMAIL;