Les paramètres vous permettent de créer des rapports plus réactifs et personnalisables. Vous pouvez transmettre les paramètres d'une source de données à la requête sous-jacente. Pour utiliser un paramètre dans votre requête personnalisée, suivez les instructions de syntaxe pertinentes 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 :
-
Sous l'éditeur de requête, activez les paramètres que vous souhaitez utiliser.
Si vous activez le paramètre @DS_USER_EMAIL, vous êtes invité à autoriser l'accès à votre adresse e-mail. -
Dans votre requête, veillez à utiliser des majuscules pour les noms des paramètres.
Toutes les valeurs des paramètres sont transmises sous forme de chaînes. Pour les traiter sous forme de dates, de nombres ou d'autres types de données, veillez à utiliser une fonction de conversion 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 lancer des requêtes sur différentes dates de début et de fin à partir des 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 à Looker 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 Looker Studio.
Créer un paramètre sur la page de connexion
- Sous l'éditeur de requêtes personnalisées, cliquez sur+ AJOUTER UN PARAMÈTRE.
- Configurez les options des paramètres.
- Cliquez sur OK.
Masquer les paramètres personnalisés dans la source de données
Par défaut, les paramètres personnalisés peuvent être modifiés dans les rapports. Pour empêcher les éditeurs de rapports de modifier la valeur d'un paramètre, vous pouvez le masquer.
- À droite du paramètre, cliquez sur Autres options
.
- 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 personnalisée, remplacez une valeur codée en dur par un identifiant commençant par le caractère @. Exemple : @param_name.
Exemples de paramètres
Exemple de paramètre personnalisé :
SELECT word FROM `TABLE` WHERE corpus = @corpus;
Utiliser une chaîne avec une condition "contains" et un nombre :
SELECT * FROM `bigquery-public-data.baseball.games_post_wide`
WHERE REGEXP_CONTAINS(gameId, @s)
AND attendance > @attendance LIMIT 100;
Utiliser un paramètre de chaîne à sélection multiple (notez l'utilisation de UNNEST pour aplatir la liste des valeurs) :
SELECT * from user.users as user WHERE display_name in UNNEST(@name);
Exemple de paramètre de date (date au 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);
Exemple de paramètre de date (la date est un code temporel Unix en microsecondes) :
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));
Exemple de paramètre d'adresse e-mail :
Select * from Sales WHERE sales-rep-email = @DS_USER_EMAIL;