Utiliser des paramètres dans une requête personnalisée

Les paramètres vous permettent de créer des rapports réactifs et personnalisables en transmettant des paramètres d'une source de données à la requête SQL sous-jacente. Pour utiliser un paramètre dans votre requête personnalisée, suivez les consignes de syntaxe décrites dans la section Exécuter des requêtes paramétrées.

Paramètres standards

Vous pouvez utiliser les paramètres suivants dans n'importe quelle requête personnalisée :

Paramètre

Objectif

@DS_START_DATE

Récupère le début de la plage de dates du rapport.

@DS_END_DATE

Récupère la fin de la plage de dates du rapport.

@DS_USER_EMAIL

Récupère l'adresse e-mail de l'utilisateur connecté.

Pour utiliser ces paramètres, procédez comme suit :

  1. Dans la section Paramètres du panneau de connexion, activez les paramètres que vous souhaitez utiliser. Data Studio vous invite à autoriser l'accès à votre adresse e-mail lorsque vous activez le paramètre @DS_USER_EMAIL.
  2. Dans votre requête, utilisez des majuscules lorsque vous saisissez les noms des paramètres.

Data Studio transmet toutes les valeurs des paramètres sous forme de chaînes de texte. Pour gérer les chaînes de paramètres en tant que dates de calendrier, nombres ou autres types de données, utilisez une fonction de conversion SQL appropriée, telle que PARSE_DATE, PARSE_TIMESTAMP ou CAST.

Utiliser des paramètres de date pour transmettre des plages de dates à la requête sous-jacente

Si votre rapport inclut un sélecteur de plage de dates, les utilisateurs peuvent l'utiliser pour demander différentes dates de début et de fin directement à partir de la base de données.

Utiliser le paramètre d'adresse e-mail pour fournir un accès aux données au niveau des lignes

Le paramètre d'adresse e-mail vous permet d'afficher uniquement les données associées à l'utilisateur connecté d'un rapport, d'une source de données ou d'une exploration. Cet utilisateur doit être connecté à un compte Google et doit accepter de fournir son adresse e-mail à Data Studio. Si le lecteur ne donne pas son accord, tous les graphiques du rapport basés sur cette source de données afficheront une erreur d'autorisation.

Paramètres personnalisés

Dans votre requête personnalisée, vous pouvez utiliser n'importe quel paramètre créé dans l'interface utilisateur de Data Studio.

Créer un paramètre sur la page de connexion

  1. Dans la section Paramètres de l'éditeur de requêtes personnalisées, cliquez sur + AJOUTER UN PARAMÈTRE.
  2. Configurez les options du paramètre.
  3. Cliquez sur OK.

Masquer les paramètres personnalisés dans la source de données

Par défaut, les éditeurs de rapports peuvent modifier les paramètres personnalisés directement dans les rapports. Pour empêcher les éditeurs de rapports de modifier la valeur d'un paramètre, vous pouvez le masquer directement dans la configuration de la source de données :

  1. Cliquez sur Autres options.
  2. Cliquez sur Masquer.

Découvrez comment autoriser les paramètres de source de données dans les rapports.

Utiliser un paramètre dans une requête personnalisée

Dans le corps de votre requête SQL personnalisée, remplacez une valeur codée en dur par un identifiant commençant par le caractère @ (par exemple, @param_name).

Exemples de paramètres

Voici quelques exemples d'utilisation des paramètres :

Exemple de paramètre personnalisé

SELECT word FROM `TABLE` WHERE corpus = @corpus;

Chaîne avec CONTAINS et un seuil numérique

SELECT * FROM `bigquery-public-data.baseball.games_post_wide`
WHERE REGEXP_CONTAINS(gameId, @s)
AND attendance > @attendance LIMIT 100;

Paramètre de chaîne à sélection multiple

Notez comment UNNEST aplatit la liste de valeurs de paramètres à sélection multiple :

SELECT * from user.users as user WHERE display_name in UNNEST(@name);

Paramètre de date utilisant le format standard

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);

Paramètre de date utilisant un code temporel Unix en microsecondes

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))

Exemple de paramètre d'adresse e-mail

SELECT * FROM Sales WHERE sales-rep-email = @DS_USER_EMAIL;