

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation des paramètres du jeu de données dans Amazon Quick
<a name="dataset-parameters"></a>

Dans Amazon Quick, les auteurs peuvent utiliser les paramètres des ensembles de données dans des requêtes directes pour personnaliser dynamiquement leurs ensembles de données et appliquer une logique réutilisable à leurs ensembles de données. Un *paramètre de jeu de données* est un paramètre créé au niveau du jeu de données. Il est consommé par un paramètre d'analyse par le biais de contrôles, de champs calculés, de filtres, d'actions URLs, de titres et de descriptions. Pour plus d’informations sur les paramètres d’analyse, consultez [Paramètres dans Amazon Quick](parameters-in-quicksight.md). La liste suivante décrit trois actions qui peuvent être effectuées avec des paramètres du jeu de données :
+  **SQL personnalisé dans la requête directe** – Les propriétaires de jeux de données peuvent insérer des paramètres de jeux de données dans le SQL personnalisé d’un jeu de données en requête directe. Lorsque ces paramètres sont appliqués à un contrôle de filtre dans une analyse rapide, les utilisateurs peuvent filtrer leurs données personnalisées plus rapidement et plus efficacement.
+ **Variables répétables** – Les valeurs statiques qui apparaissent à plusieurs endroits dans la page du jeu de données peuvent être modifiées en une seule action à l’aide des paramètres de jeu de données personnalisés.
+ **Déplacer des champs calculés vers des ensembles de données : les** auteurs de Quick peuvent copier des champs calculés avec des paramètres dans une analyse et les migrer au niveau du jeu de données. Les champs calculés au niveau de l’analyse sont ainsi protégés contre toute modification accidentelle et les champs calculés peuvent être partagés entre plusieurs analyses.

Dans certaines situations, les paramètres de jeu de données améliorent les performances du contrôle des filtres pour les jeux de données à interrogation directe qui nécessitent un SQL personnalisé complexe et simplifient la logique métier au niveau du jeu de données.

**Topics**
+ [Limitations des paramètres des jeux de données](#dataset-parameters-limitations)
+ [Création de paramètres de jeu de données dans Amazon Quick](dataset-parameters-SQL.md)
+ [Insertion des paramètres du jeu de données dans le code SQL personnalisé](dataset-parameters-insert-parameter.md)
+ [Ajout de paramètres de jeu de données aux champs calculés](dataset-parameters-calculated-fields.md)
+ [Ajout de paramètres de jeu de données aux filtres](dataset-parameters-dataset-filters.md)
+ [Utilisation des paramètres du jeu de données dans les analyses rapides](dataset-parameters-analysis.md)
+ [Cas d’utilisation avancée des paramètres du jeu de données](dataset-parameters-advanced-options.md)

## Limitations des paramètres des jeux de données
<a name="dataset-parameters-limitations"></a>

Cette section décrit les limites connues que vous pouvez rencontrer lorsque vous travaillez avec des paramètres d'ensembles de données dans Amazon Quick.
+ Lorsque les lecteurs de tableaux de bord programment des rapports envoyés par e-mail, les contrôles sélectionnés ne se propagent pas aux paramètres du jeu de données inclus dans le rapport joint à l’e-mail. Au lieu de cela, les valeurs par défaut des paramètres sont utilisées.
+ Les paramètres des jeux de données ne peuvent pas être insérés dans le SQL personnalisé des jeux de données stockés dans SPICE.
+ Les valeurs dynamiques par défaut ne peuvent être configurées que sur la page de l’analyse qui utilise le jeu de données. Vous ne pouvez pas configurer un défaut dynamique au niveau du jeu de données.
+ L’option **Sélectionner tout** n’est pas prise en charge sur les contrôles multivaleur des paramètres d’analyse qui sont mappés sur des paramètres de jeu de données.
+ Les contrôles en cascade ne sont pas pris en charge pour les paramètres des jeux de données.
+ Les paramètres de jeu de données ne peuvent être utilisés par les filtres de jeu de données que lorsque le jeu de données utilise la requête directe.
+ Dans une requête SQL personnalisée, seuls 128 paramètres de jeu de données peuvent être utilisés.

# Création de paramètres de jeu de données dans Amazon Quick
<a name="dataset-parameters-SQL"></a>

Suivez les procédures suivantes pour commencer à utiliser les paramètres de jeu de données.

**Pour créer un nouveau paramètre de jeu de données**

1. Sur la page de démarrage rapide, choisissez **Données** sur la gauche, choisissez les points de suspension (trois points) à côté du jeu de données que vous souhaitez modifier, puis choisissez **Modifier**.

1. Dans la page **Jeu de données** qui s’ouvre, sélectionnez **Paramètres** sur la gauche, puis cliquez sur l’icône (\$1) pour créer un nouveau paramètre de jeu de données.

1. Dans la fenêtre contextuelle **Créer un nouveau paramètre** qui s’affiche, saisissez un nom de paramètre dans la zone **Nom**.

1. Dans la liste déroulante **Type de données**, choisissez le type de données de paramètre que vous voulez. Les types de données pris en charge sont `String`, `Integer`, `Number` et `Datetime`. Cette option ne peut pas être modifiée après la création du paramètre.

1. Pour **Valeur par défaut**, saisissez la valeur par défaut que vous voulez donner au paramètre.
**Note**  
Lorsque vous mappez un paramètre du jeu de données à un paramètre d’analyse, une valeur par défaut différente peut être choisie. Dans ce cas, la valeur par défaut configurée ici est remplacée par la nouvelle valeur par défaut.

1. Pour **Valeurs**, choisissez le type de valeur que vous voulez donner au paramètre. Les paramètres **À valeur unique** prennent en charge les listes déroulantes à sélection unique, les champs de texte et les contrôles de liste. Les paramètres **À valeurs multiples** prennent en charge les contrôles déroulants à sélection multiple. Cette option ne peut pas être modifiée après la création du paramètre.

1. Lorsque vous avez terminé de configurer le nouveau paramètre, cliquez sur **Créer** pour créer le paramètre.

# Insertion des paramètres du jeu de données dans le code SQL personnalisé
<a name="dataset-parameters-insert-parameter"></a>

Vous pouvez insérer des paramètres de jeu de données dans le code SQL personnalisé d’un jeu de données en mode d’interrogation directe en le référençant avec `<<$parameter_name>>` dans l’instruction SQL. Lors de l’exécution, les utilisateurs du tableau de bord peuvent saisir des valeurs de contrôle de filtre associées à un paramètre de jeu de données. Ils peuvent ensuite voir les résultats dans les représentations visuelles du tableau de bord après la propagation des valeurs dans la requête SQL. Vous pouvez utiliser des paramètres pour créer des filtres de base basés sur les données du client dans les clauses `where`. Vous pouvez également ajouter des clauses `case when` ou `if else` pour modifier dynamiquement la logique de la requête SQL en fonction de l’entrée d’un paramètre.

Par exemple, disons que vous voulez ajouter une clause `WHERE` à votre requête SQL personnalisée qui filtre les données en fonction du nom de la région d’un utilisateur final. Dans ce cas, vous créez un paramètre à valeur unique appelé `RegionName` :

```
SELECT *
FROM transactions
WHERE region = <<$RegionName>>
```

Vous pouvez également laisser les utilisateurs fournir plusieurs valeurs au paramètre :

```
SELECT *
FROM transactions
WHERE region in (<<$RegionNames>>)
```

Dans l’exemple plus complexe suivant, un auteur de jeu de données renvoie deux fois à deux paramètres du jeu de données basés sur le prénom et le nom d’un utilisateur qui peuvent être sélectionnés dans un contrôle de filtre de tableau de bord :

```
SELECT Region, Country, OrderDate, Sales
FROM transactions
WHERE region=
(Case
WHEN <<$UserFIRSTNAME>> In 
    (select firstname from user where region='region1') 
    and <<$UserLASTNAME>> In 
    (select lastname from user where region='region1') 
    THEN 'region1'
WHEN <<$UserFIRSTNAME>> In 
    (select firstname from user where region='region2') 
    and <<$UserLASTNAME>> In 
    (select lastname from user where region='region2') 
    THEN 'region2'
ELSE 'region3'
END)
```

Vous pouvez également utiliser des paramètres dans des clauses `SELECT` pour créer de nouvelles colonnes dans un jeu de données à partir des entrées de l’utilisateur :

```
SELECT Region, Country, date, 
    (case 
    WHEN <<$RegionName>>='EU'
    THEN sum(sales) * 0.93   --convert US dollar to euro
    WHEN <<$RegionName>>='CAN'
    THEN sum(sales) * 0.78   --convert US dollar to Canadian Dollar
    ELSE sum(sales) -- US dollar
    END
    ) as "Sales"
FROM transactions
WHERE region = <<$RegionName>>
```

Pour créer une requête SQL personnalisée ou pour modifier une requête existante avant d’ajouter un paramètre de jeu de données, consultez la rubrique [Utilisation de SQL pour personnaliser les données](adding-a-SQL-query.md).

Lorsque vous appliquez une requête SQL personnalisée avec un paramètre du jeu de données, `<<$parameter_name>>` est utilisé comme valeur de remplacement. Lorsqu'un utilisateur choisit l'une des valeurs de paramètres dans un contrôle, Quick remplace l'espace réservé par les valeurs que l'utilisateur sélectionne sur le tableau de bord.

Dans l’exemple suivant, l’utilisateur saisit une nouvelle requête SQL personnalisée qui filtre les données par état :

```
select * from all_flights
where origin_state_abr = <<$State>>
```

La valeur par défaut du paramètre est appliquée à la requête SQL et les résultats apparaissent dans le **Volet Aperçu**.

# Ajout de paramètres de jeu de données aux champs calculés
<a name="dataset-parameters-calculated-fields"></a>

Vous pouvez également ajouter des paramètres de jeu de données aux expressions de champ calculé en utilisant le format `${parameter_name}`.

Lorsque vous créez un calcul, vous pouvez choisir parmi les paramètres existants dans la liste des **Paramètres**. Vous ne pouvez pas créer un champ calculé qui contient un paramètre à valeurs multiples.

Pour plus d’informations sur l’ajout de champs calculés, consultez la rubrique [Utilisation de champs calculés avec paramètres dans Amazon Quick](parameters-calculated-fields.md).

# Ajout de paramètres de jeu de données aux filtres
<a name="dataset-parameters-dataset-filters"></a>

Pour les jeux de données en mode d’interrogation directe, les auteurs des jeux de données peuvent utiliser les paramètres des jeux de données dans les filtres sans utiliser de code SQL personnalisé. Les paramètres du jeu de données ne peuvent pas être ajoutés aux filtres si le jeu de données est en mode SPICE.

**Pour ajouter un paramètre de jeu de données à un filtre**

1. Ouvrez la page du jeu de données pour lequel vous voulez créer un filtre. Choisissez **Filtres** sur la gauche, puis choisissez **Ajouter un filtre**.

1. Saisissez le nom que vous souhaitez donner au filtre et choisissez le champ que vous voulez filtrer dans la liste déroulante.

1. Après avoir créé le nouveau filtre, accédez au filtre dans le panneau de navigation **Filtres**, cliquez sur l’ellipse (trois points) en regard du filtre, puis sélectionnez **Modifier**.

1. Pour **Type de filtre**, choisissez **Filtre personnalisé**.

1. Pour **Condition du filtre**, sélectionnez la condition que vous voulez.

1. Cochez la case **Utiliser un paramètre** et sélectionnez le paramètre du jeu de données que vous voulez que le filtre utilise.

1. Lorsque vous avez terminé les modifications, cliquez sur **Appliquer**.

# Utilisation des paramètres du jeu de données dans les analyses rapides
<a name="dataset-parameters-analysis"></a>

Une fois que vous avez créé un paramètre de jeu de données, après avoir ajouté le jeu de données à une analyse, mappez le paramètre de jeu de données à un paramètre d’analyse nouveau ou existant. Une fois que vous avez mappé un paramètre du jeu de données à un paramètre d’analyse, vous pouvez les utiliser avec des filtres, des contrôles et toute autre fonction de paramètre d’analyse.

Vous pouvez gérer vos paramètres de jeu de données dans le volet **Paramètres** de l’analyse qui utilise le jeu de données auquel les paramètres appartiennent. Dans la section **Paramètres du jeu de données** du volet **Paramètres**, vous pouvez choisir de n’afficher que les paramètres du jeu de données non mappés (par défaut). Vous pouvez également choisir d’afficher tous les paramètres des jeux de données mappés et non mappés en sélectionnant **TOUT** dans le menu déroulant **Affichage**.

## Cartographie des paramètres du jeu de données dans les nouvelles analyses rapides
<a name="dataset-parameters-map-to-analysis"></a>

Lorsque vous créez une nouvelle analyse à partir d’un jeu de données contenant des paramètres, vous devez mapper les paramètres du jeu de données à l’analyse avant de pouvoir les utiliser. C’est également le cas lorsque vous ajoutez un jeu de données avec des paramètres à une analyse. Vous pouvez afficher tous les paramètres non mappés d’une analyse dans le volet **Paramètres** de l’analyse. Vous pouvez également sélectionner **VISUALISER** dans le message de notification qui s’affiche en haut à droite de la page lorsque vous créez l’analyse ou ajoutez le jeu de données.

**Pour mapper un paramètre du jeu de données à un paramètre d’analyse**

1. Ouvrez la [console Quick](https://quicksight.aws.amazon.com/).

1. Choisissez l’analyse que vous voulez modifier.

1. Cliquez sur l’icône **Paramètres** pour ouvrir le volet **Paramètres**.

1. Cliquez sur l’ellipse (trois points) située à côté du paramètre du jeu de données que vous souhaitez mapper, sélectionnez **Mapper le paramètre**, puis choisissez le paramètre d’analyse auquel vous voulez mapper le paramètre du jeu de données.

   Si votre analyse ne possède pas de paramètres d’analyse, vous pouvez sélectionner **Mapper le paramètre** et **Créer un nouveau** pour créer un paramètre d’analyse qui sera automatiquement mappé au paramètre du jeu de données lors de sa création.

   1. (Facultatif) Dans la fenêtre contextuelle **Créer un nouveau paramètre** qui s’affiche, pour **Nom**, entrez un nom pour le nouveau paramètre d’analyse.

   1. (Facultatif) Pour **Valeur statique par défaut**, choisissez la valeur statique par défaut que vous voulez donner au paramètre.

   1. (Facultatif) Sélectionnez **Définir une valeur par défaut dynamique** pour définir une valeur par défaut dynamique pour le nouveau paramètre.

   1. Dans le tableau **Paramètres du jeu de données mappés**, vous verrez le paramètre du jeu de données que vous mappez au nouveau paramètre d’analyse. Vous pouvez ajouter d’autres paramètres de jeu de données à ce paramètre d’analyse en sélectionnant le menu déroulant **AJOUTER UN PARAMÈTRE DE JEU DE DONNÉES**, puis en choisissant le paramètre que vous voulez mapper. Vous pouvez annuler le mappage d’un paramètre du jeu de données en cliquant sur le bouton **Supprimer** situé à côté du paramètre du jeu de données que vous voulez supprimer.

   Pour plus d’informations sur la création de paramètres d’analyse, consultez la rubrique [Configuration des paramètres dans Amazon Quick](parameters-set-up.md).

Lorsque vous mappez un paramètre du jeu de données à un paramètre d’analyse, le paramètre d’analyse représente le paramètre du jeu de données partout où il est utilisé dans l’analyse.

Vous pouvez également mapper et démapper des paramètres du jeu de données vers des paramètres d’analyse dans la fenêtre **Modifier le paramètre**. Pour ouvrir la fenêtre **Modifier le paramètre**, accédez au panneau de navigation **Paramètres**, cliquez sur l’ellipse (trois points) située à côté du paramètre d’analyse que vous voulez modifier, puis sélectionnez **Modifier le paramètre**. Vous pouvez ajouter d’autres paramètres de jeu de données à ce paramètre d’analyse en sélectionnant le menu déroulant **AJOUTER UN PARAMÈTRE DE JEU DE DONNÉES**, puis en choisissant le paramètre que vous voulez mapper. Vous pouvez annuler le mappage d’un paramètre du jeu de données en cliquant sur le bouton **Supprimer** situé à côté du paramètre du jeu de données que vous voulez supprimer. Vous pouvez également supprimer tous les paramètres du jeu de données mappées en sélectionnant **SUPPRIMER TOUT**. Une fois les modifications terminées, sélectionnez **Mettre à jour**.

Lorsque vous supprimez un paramètre d’analyse, tous les paramètres du jeu de données ne sont plus mappés dans l’analyse et apparaissent dans la section **NON MAPPÉS** du volet **Paramètres**. Vous ne pouvez mapper un paramètre du jeu de données qu’à un seul paramètre d’analyse à la fois. Pour mapper un paramètre du jeu de données à un autre paramètre d’analyse, démappez le paramètre du jeu de données, puis mappez-le au nouveau paramètre d’analyse.

## Ajout de contrôles de filtre aux paramètres d’analyse mappés
<a name="dataset-parameters-analysis-filter-control"></a>

Après avoir mappé un paramètre de jeu de données à un paramètre d'analyse dans Quick, vous pouvez créer des contrôles de filtre pour les filtres, les actions, les champs calculés, les titres, les descriptions et URLs.

**Pour ajouter un contrôle à un paramètre mappé**

1. Dans le volet **Paramètres** de la page d’analyse, cliquez sur l’ellipse (trois points) en regard du paramètre d’analyse mappé que vous voulez, puis sélectionnez **Ajouter un contrôle**.

1. Dans la fenêtre **Ajouter un contrôle** qui s’affiche, entrez le **Nom** que vous voulez et choisissez le **Style** que vous voulez donner au contrôle. Pour les contrôles à valeur unique, choisissez entre `Dropdown`, `List` et `Text field`. Pour les contrôles multivaleur, choisissez `Dropdown`.

1. Sélectionnez **Ajouter** pour créer le contrôle.

# Cas d’utilisation avancée des paramètres du jeu de données
<a name="dataset-parameters-advanced-options"></a>

Cette section couvre des options et des cas d’utilisation plus avancés des paramètres du jeu de données et des contrôles déroulants. Utilisez les démonstrations suivantes pour créer des contrôles déroulants dynamiques avec des paramètres du jeu de données.

## Utilisation de contrôles multivaleur avec des paramètres du jeu de données
<a name="dataset-parameters-dropdown"></a>

Lorsque vous utilisez des paramètres de jeu de données insérés dans le Custom SQL d’un jeu de données, les paramètres de jeu de données filtrent généralement les données en fonction des valeurs d’une colonne spécifique. Si vous créez un contrôle déroulant et que vous attribuez le paramètre comme valeur, le contrôle déroulant n’affiche que la valeur filtrée par le paramètre. La procédure suivante montre comment vous pouvez créer un contrôle qui est mappé à un paramètre de jeu de données et qui affiche toutes les valeurs non filtrées.

**Pour remplir toutes les valeurs attribuées dans un contrôle déroulant**

1. Créez un nouveau jeu de données à colonne unique dans SPICE ou dans une requête directe qui inclut toutes les valeurs uniques du jeu de données d’origine. Par exemple, supposons que votre jeu de données d’origine utilise le SQL personnalisé suivant :

   ```
   select * from all_flights
           where origin_state_abr = <<$State>>
   ```

   Pour créer un tableau à colonne unique avec tous les états d’origine uniques, appliquez le SQL personnalisé suivant au nouveau jeu de données :

   ```
   SELECT distinct origin_state_abr FROM all_flights
           order by origin_state_abr asc
   ```

   L’expression SQL renvoie tous les états uniques par ordre alphabétique. Le nouveau jeu de données n’a pas de paramètres de jeu de données.

1. Saisissez un **Nom** pour le nouveau jeu de données, puis enregistrez et publiez le jeu de données. Dans notre exemple, le nouveau jeu de données s’appelle `State Codes`.

1. Ouvrez l’analyse qui contient le jeu de données original et ajoutez le nouveau jeu de données à l’analyse. Pour plus d’informations sur l’ajout de jeux de données à une analyse existante, consultez la rubrique [Ajout d’un jeu de données à une analyse](adding-a-data-set-to-an-analysis.md).

1. Naviguez jusqu’au panneau de navigation **Contrôle** et trouvez le contrôle déroulant que vous voulez modifier. Cliquez sur l’ellipse (trois points) en regard du contrôle, puis sélectionnez **Modifier**.

1. Dans **Formater le contrôle** qui apparaît sur la gauche, sélectionnez **Lier à un champ du jeu de données** dans la section **Valeurs**.

1. Dans le menu déroulant **Jeu de données** qui apparaît, choisissez le nouveau jeu de données que vous avez créé. Dans notre exemple, nous avons choisi le jeu de données `State Codes`.

1. Dans la liste déroulante **Champ** qui s’affiche, choisissez le champ approprié. Dans notre exemple, nous avons choisi le champ `origin_state_abr`.

Une fois que vous avez fini de lier le contrôle au nouveau jeu de données, toutes les valeurs uniques apparaissent dans la liste déroulante du contrôle. Celles-ci comprennent les valeurs filtrées par le paramètre du jeu de données.

## Utilisation de contrôles avec l’option Sélectionner tout
<a name="dataset-parameters-controls-select-all"></a>

Par défaut, lorsqu’un ou plusieurs paramètres du jeu de données sont mappés à un paramètre d’analyse et ajoutés à un contrôle, l’option `Select all` n’est pas disponible. La procédure suivante montre une solution de contournement qui utilise le même scénario d’exemple de la section précédente.

**Note**  
Cette démonstration concerne les jeux de données qui sont suffisamment petits pour être chargés en requête directe. Si vous disposez d’un jeu de données important et que vous voulez utiliser l’option `Select All`, il est recommandé de charger le jeu de données dans SPICE. Toutefois, si vous voulez utiliser l’option `Select All` avec des paramètres de jeu de données, cette démonstration décrit une façon de procéder.

Pour commencer, disons que vous avez un jeu de données à interrogation directe avec un SQL personnalisé qui contient un paramètre multivaleur appelé `States` :

```
select * from all_flights
where origin_state_abr in (<<$States>>)
```

**Pour utiliser l’option Sélectionner tout dans un contrôle qui utilise des paramètres du jeu de données**

1. Dans le volet **Paramètres** de l’analyse, recherchez le paramètre de jeu de données que vous voulez utiliser et sélectionnez **Modifier** dans l’ellipse (trois points) située à côté du paramètre.

1. Dans la fenêtre **Modifier le paramètre** qui s’affiche, saisissez une nouvelle valeur par défaut dans la section **Valeurs par défaut multiples statiques**. Dans notre exemple, la valeur par défaut est ` All States`. Notez que l’exemple utilise un espace en tête pour que la valeur par défaut apparaisse comme le premier élément du contrôle.

1. Sélectionnez **Mettre à jour** pour actualiser le paramètre.

1. Accédez à l'ensemble de données qui contient le paramètre d'ensemble de données que vous utilisez dans le analysis-by-analysis. Modifiez le SQL personnalisé du jeu de données afin d’inclure un cas d’utilisation par défaut pour vos nouvelles valeurs statiques multiples par défaut. En utilisant l’exemple ` All States`, l’expression SQL se présente comme suit :

   ```
   select * from public.all_flights
   where
       ' All States' in (<<$States>>) or
       origin_state_abr in (<<$States>>)
   ```

   Si l’utilisateur choisit ` All States` dans le contrôle, la nouvelle expression SQL renvoie tous les enregistrements uniques. Si l’utilisateur choisit une valeur différente dans le contrôle, la requête renvoie les valeurs qui ont été filtrées par le paramètre du jeu de données.

### Utilisation de contrôles avec les options Sélectionner tout et Multivaleur
<a name="dataset-parameters-controls-multi-select-all"></a>

Vous pouvez combiner la procédure `Select all` précédente avec la méthode de contrôle multivaleur discutée précédemment pour créer des contrôles déroulants qui contiennent une valeur `Select all` en plus de plusieurs valeurs que l’utilisateur peut sélectionner. Cette démonstration suppose que vous avez suivi les procédures précédentes, que vous savez comment mapper les paramètres du jeu de données aux paramètres de l’analyse et que vous pouvez créer des contrôles dans une analyse. Pour plus d’informations sur le mappage des paramètres d’analyse, consultez la rubrique [Cartographie des paramètres du jeu de données dans les nouvelles analyses rapides](dataset-parameters-analysis.md#dataset-parameters-map-to-analysis). Pour plus d’informations sur la création de contrôles dans une analyse qui utilise des paramètres de jeux de données, consultez la rubrique [Ajout de contrôles de filtre aux paramètres d’analyse mappés](dataset-parameters-analysis.md#dataset-parameters-analysis-filter-control).

**Pour ajouter plusieurs valeurs à un contrôle doté d’une option Sélectionner tout et d’un paramètre de jeu de données mappé**

1. Ouvrez l’analyse qui possède le jeu de données original avec une expression SQL personnalisée `Select all` et un deuxième jeu de données qui inclut toutes les valeurs possibles de la colonne filtrée qui existe dans le jeu de données original.

1. Naviguez vers le jeu de données secondaire qui a été créé précédemment pour renvoyer toutes les valeurs d’une colonne filtrée. Ajoutez une expression SQL personnalisée qui ajoute à la requête l’option `Select all` que vous avez configurée précédemment. L’exemple suivant ajoute l’enregistrement ` All States` en tête de la liste des valeurs renvoyées du jeu de données :

   ```
   (Select ' All States' as origin_state_abr)
       Union All
       (SELECT distinct origin_state_abr FROM all_flights
       order by origin_state_abr asc)
   ```

1. Retournez à l’analyse à laquelle appartiennent les jeux de données et mappez le paramètre de jeu de données que vous utilisez au paramètre d’analyse que vous avez créé à l’étape 3 de la procédure précédente. Le paramètre d’analyse et le paramètre du jeu de données peuvent avoir le même nom. Dans notre exemple, le paramètre d’analyse est appelé `States`.

1. Créez un nouveau contrôle de filtre ou modifiez un contrôle de filtre existant et sélectionnez **Masquer Sélectionner tout** pour masquer l’option désactivée **Sélectionner tout** qui apparaît dans les contrôles multivaleur.

Une fois que vous avez créé le contrôle, les utilisateurs peuvent utiliser le même contrôle pour sélectionner toutes les valeurs ou plusieurs valeurs d’une colonne filtrée dans un jeu de données.