Los parámetros te permiten crear informes responsivos y personalizables pasando parámetros de una fuente de datos a la consulta en SQL subyacente. Para usar un parámetro dentro de tu consulta personalizada, sigue los lineamientos de sintaxis 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 |
|---|---|
|
Obtiene el inicio del período del informe. |
|
Obtiene el final del período del informe. |
|
Obtiene la dirección de correo electrónico del usuario que accedió. |
Para usar estos parámetros, sigue estos pasos:
- En la sección Parameters del panel de conexión, habilita los parámetros que quieres usar. Data Studio te solicitará que otorgues acceso a tu dirección de correo electrónico cuando habilites el parámetro
@DS_USER_EMAIL. - En tu consulta, usa el formato de mayúsculas cuando escribas los nombres de los parámetros.
Data Studio pasa todos los valores de los parámetros como cadenas de texto. Para controlar las cadenas de parámetros como fechas de calendario, números o cualquier otro tipo de datos, usa una función de conversión de SQL 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 lectores pueden usarlo para solicitar diferentes fechas de inicio y finalización directamente desde la base de datos.
Usa el parámetro de correo electrónico para proporcionar acceso a los datos a nivel de filas
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 estar conectado a una Cuenta de Google y debe aceptar proporcionar su dirección de correo electrónico a Data Studio. Si el lector no da su consentimiento, todos los gráficos del informe que se basen 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 Data Studio dentro de tu consulta personalizada.
Crea un parámetro en la página de conexión
- En la sección Parameters del editor de consultas personalizadas, haz clic en +ADD PARAMETER.
- Configura las opciones del parámetro.
- Haz clic en Aceptar.
Oculta parámetros personalizados en la fuente de datos
De forma predeterminada, los editores de informes pueden modificar los parámetros personalizados directamente en los informes. Para evitar que los editores de informes cambien el valor de un parámetro, puedes ocultarlo directamente en la configuración de la fuente de datos:
- Haz clic en More options.
- Haz clic en Ocultar.
Obtén más información para permitir parámetros de fuentes de datos en informes.
Usa un parámetro en una consulta personalizada
En el cuerpo de tu consulta en SQL personalizada, reemplaza un valor codificado con un identificador que comience con el carácter @ (por ejemplo, @param_name).
Ejemplos de parámetros
A continuación, se muestran algunos ejemplos del uso de parámetros:
Ejemplo de parámetro personalizado
SELECT word FROM `TABLE` WHERE corpus = @corpus;
Cadena con CONTAINS y un umbral numérico
SELECT * FROM `bigquery-public-data.baseball.games_post_wide`
WHERE REGEXP_CONTAINS(gameId, @s)
AND attendance > @attendance LIMIT 100;
Parámetro de cadena de selección múltiple
Observa cómo UNNEST aplana la lista de array de valores de parámetros de selección múltiple:
SELECT * from user.users as user WHERE display_name in UNNEST(@name);
Parámetro de fecha con 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);
Parámetro de fecha con marca de tiempo de Unix en microsegundos
SELECT creation_date, age, display_name from user.users as use
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;