Usar parámetros en una consulta personalizada

Los parámetros te permiten crear informes adaptables y personalizables transfiriendo parámetros de una fuente de datos a la consulta de SQL subyacente. Para usar un parámetro en una consulta personalizada, sigue las directrices de sintaxis de la documentación para ejecutar consultas con parámetros.

Parámetros estándar

Puedes usar los siguientes parámetros en cualquier consulta personalizada:

Parámetro

Finalidad

@DS_START_DATE

Obtiene el inicio del periodo del informe.

@DS_END_DATE

Obtiene el final del periodo del informe.

@DS_USER_EMAIL

Obtiene la dirección de correo del usuario que ha iniciado sesión.

Para utilizar estos parámetros, sigue estos pasos:

  1. En la sección Parámetros del panel de conexión, habilita los parámetros que quieras usar. Data Studio te pedirá que des acceso a tu dirección de correo cuando habilites el parámetro @DS_USER_EMAIL.
  2. En la consulta, escribe los nombres de los parámetros en mayúsculas.

Data Studio transfiere todos los valores de parámetro como cadenas de texto. Para gestionar las cadenas de parámetros como fechas de calendario, números u otros tipos de datos, usa una función de conversión de SQL adecuada, como PARSE_DATE, PARSE_TIMESTAMP o CAST.

Usar los parámetros de fecha para transferir periodos a la consulta subyacente

Si tu informe incluye un filtro por periodo, los usuarios pueden solicitar a través de él diferentes fechas de inicio y finalización directamente de la base de datos.

Usar el parámetro de correo electrónico para proporcionar acceso a filas de datos

El parámetro de correo electrónico permite mostrar únicamente los datos asociados al usuario que ha iniciado sesión en un informe, una fuente de datos o una exploración. Dicho usuario debe iniciar sesión con una cuenta de Google y dar su consentimiento para que su dirección de correo se proporcione a Data Studio. Si el usuario no da su consentimiento, todos los gráficos del informe que estén basados en esa fuente de datos mostrarán un error de autorización.

Parámetros personalizados

Puedes usar los parámetros que crees en la interfaz de usuario de Data Studio en tu consulta personalizada.

Crear un parámetro en la página de conexiones

  1. En la sección Parámetros del editor de consultas personalizadas, haz clic en + AÑADIR PARÁMETRO.
  2. Configura las opciones del parámetro.
  3. Haz clic en Aceptar.

Ocultar 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. Puedes ocultar un parámetro para evitar que los editores de informes lo modifiquen directamente en la configuración de la fuente de datos:

  1. Haz clic en Más opciones.
  2. Haz clic en Ocultar.

Más información sobre cómo permitir parámetros de fuentes de datos en los informes

Usar un parámetro en una consulta personalizada

En el cuerpo de la consulta de SQL personalizada que estés creando, sustituye un valor predefinido en el código con un identificador que comience por el carácter @ (por ejemplo, @param_name).

Ejemplos de parámetros

A continuación, se muestran algunos ejemplos de 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

Fíjate en cómo UNNEST unifica la lista de arrays 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 que usa una 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;