Paramètres de requête

Créer un paramètre et l'utiliser dans une source ou un filtre ; changer la source d'un rapport sans réécrire les requêtes ; exporter une source en fichier PBIDS ; modifier les valeurs des paramètres après publication.

Pourquoi ?

Un rapport conçu sur un fichier de test ou une base de développement doit un jour pointer vers la production. Si le chemin ou le nom du serveur est écrit en dur dans chaque requête, il faut tout modifier à la main. Un paramètre centralise cette valeur : on la change à un seul endroit, dans Power BI Desktop ou dans le service Power BI après publication. Les paramètres servent aussi à filtrer une période, à piloter une fonction personnalisée ou à préparer l'actualisation incrémentielle.

Notions clés

Les propriétés d'un paramètre

Un paramètre est une requête particulière qui stocke une seule valeur. Il se crée par Accueil > Gérer les paramètres > Nouveau paramètre.

Propriété	Rôle
Nom	Nom utilisé dans les requêtes (par exemple paramServeur)
Description	Texte d'aide affiché à côté du nom
Obligatoire	Impose de renseigner une valeur
Type	Type de la valeur (Texte, Nombre décimal, Date...) ; à toujours renseigner
Valeurs suggérées	N'importe quelle valeur, Liste de valeurs ou Requête (une requête qui renvoie une liste)
Valeur actuelle	Valeur utilisée par les requêtes

Source

Où utiliser un paramètre ?

Dans une source : chemin de fichier, URL, nom de serveur ou de base de données. Dans la boîte de dialogue de l'étape Source, le bouton de type à gauche d'un champ propose Paramètre.
Dans un filtre : dans la boîte Filtrer les lignes, le même bouton permet de comparer la colonne à un paramètre (par exemple une date de début).
Dans une fonction : une requête qui utilise des paramètres peut être transformée en fonction (clic droit > Créer une fonction) ; les paramètres deviennent ses arguments. C'est la méthode de la page « Combiner des fichiers et des feuilles ».

Les paramètres de la source de données

Accueil > Paramètres de la source de données (ou Fichier > Options et paramètres > Paramètres de la source de données) liste toutes les sources du fichier ; une source utilisée par plusieurs requêtes n'apparaît qu'une fois. Vous pouvez y :

Changer la source : pointer toutes les requêtes concernées vers un autre fichier ou serveur en une seule opération ;
Modifier les autorisations : changer les informations d'identification et le niveau de confidentialité de la source (voir la page « Niveaux de confidentialité et erreur Firewall ») ;
Exporter PBIDS : créer un fichier de source de données Power BI.

Les fichiers PBIDS

Un fichier .pbids décrit une seule source de données. Ouvert dans Power BI Desktop, il demande les informations d'identification puis affiche directement le Navigateur : il simplifie la création d'un nouveau rapport sur une source validée. Il ne contient ni identifiants, ni tables, ni schéma. Exemple pour un fichier CSV :

{
  "version": "0.1",
  "connections": [
    {
      "details": {
        "protocol": "file",
        "address": {
          "path": "c:\\temp\\Product inventory.csv"
        },
        "authentication": null,
        "query": null
      },
      "options": {},
      "mode": null
    }
  ]
}

Source

Pas à pas

1. Dans l'éditeur Power Query, Accueil > Gérer les paramètres > Nouveau paramètre.

2. Nommez-le paramCheminFichier, type Texte, Valeurs suggérées : N'importe quelle valeur, et collez le chemin complet du fichier source dans Valeur actuelle. Validez.

3. Sélectionnez la requête qui lit le fichier, double-cliquez sur l'étape Source, cliquez sur le bouton de type à gauche de Chemin d'accès au fichier, choisissez Paramètre, puis paramCheminFichier. Validez.

4. Créez un second paramètre paramDateDebut de type Date, puis filtrez la colonne Date de la requête : Filtres de date > Après ou égal à, bouton de type > Paramètre > paramDateDebut.

5. Fermez et appliquez. Ensuite, pour changer de fichier ou de période, utilisez Accueil > Transformer les données > Modifier les paramètres dans Power BI Desktop, sans ouvrir l'éditeur.

6. Après publication, modifiez les valeurs dans le service Power BI : Paramètres (roue dentée) > Paramètres > onglet Modèles sémantiques, sélectionnez le modèle, puis développez Paramètres. On ne peut pas y créer de paramètre, seulement changer les valeurs ; les paramètres de type Any ou Binaire ne sont pas pris en charge dans le service. Source

Exemple

Dans le code M, un paramètre s'utilise comme n'importe quelle valeur. Requête vers une base SQL dont le serveur, la base et la date de début sont paramétrés :

let
    Source = Sql.Database(paramServeur, paramBase),
    Ventes = Source{[Schema = "dbo", Item = "FactVentes"]}[Data],
    Filtre = Table.SelectRows(Ventes, each [DateVente] >= paramDateDebut)
in
    Filtre

Le code d'un paramètre lui-même (visible dans l'Éditeur avancé) est une valeur accompagnée de métadonnées :

#date(2026, 1, 1) meta [IsParameterQuery = true, Type = "Date", IsParameterQueryRequired = true]

Enregistré comme modèle Power BI (Fichier > Exporter > Modèle Power BI, fichier .pbit), un rapport paramétré demande la valeur de chaque paramètre à l'ouverture. Source

Pièges et bonnes pratiques

Typez toujours vos paramètres : un paramètre Any n'est pas modifiable dans le service et peut casser un filtre de date.
Préfixez les noms (param...) et rangez les paramètres dans un groupe de requêtes « Paramètres ».
Un paramètre de chemin local (C:...) ne fonctionne plus après publication sans passerelle ; préférez un emplacement SharePoint ou OneDrive professionnel.
Les paramètres RangeStart et RangeEnd, de type Date/Heure, sont réservés à l'actualisation incrémentielle. Source

À retenir

Un paramètre centralise une valeur réutilisée par plusieurs requêtes (chemin, serveur, date).
Le bouton de type des boîtes de dialogue permet de remplacer une valeur fixe par un paramètre.
Paramètres de la source de données permet de changer une source, ses autorisations, ou de l'exporter en PBIDS.
Après publication, les valeurs se modifient dans les paramètres du modèle sémantique.

Pour aller plus loin

Paramètres dans Power Query. Source
Modifier les valeurs des paramètres dans le service Power BI. Source
Sources de données et fichiers PBIDS dans Power BI Desktop. Source
Paramètres de requête M dynamiques. Source