Ajouter une colonne à partir d’un exemple dans Power BI DesktopAdd a column from an example in Power BI Desktop

Depuis la publication de Power BI Desktop d’avril 2017, vous pouvez ajouter des colonnes de données à votre modèle à l’aide de l’Éditeur de requête en fournissant un ou plusieurs exemples de valeurs pour votre nouvelle colonne.Starting with the April 2017 release of Power BI Desktop, you can add new columns of data to your model using Query Editor by simply providing one or more sample values for your new column. Vous pouvez créer un exemple de colonne à partir d’une sélection active ou en fournissant une entrée basée sur la totalité ou une sélection des colonnes d’un tableau donné.You can create a new column example from a current selection, or from providing input based on all (or selected) columns in a given table.

Cette approche vous aide à créer rapidement et aisément des colonnes, et s’avère particulièrement utile dans les situations suivantes :This approach helps you quickly and easily create new columns, and is great for the following situations:

  • Vous connaissez le résultat de données que vous souhaitez voir apparaître dans la nouvelle colonne, mais n’êtes pas certain de la transformation (ou de la collection de transformations) permettant de l’obtenir.You know the data result you want in your new column, but you're not sure which transformation (or collection of transformations) will get you there.
  • Vous connaissez déjà les transformations nécessaires, mais ne savez pas où cliquer ou les sélections à effectuer dans l’interface utilisateur pour que les transformations opèrent.You already know which transformations you need, but you're not sure where to click or select in the UI to make them happen.
  • Vous savez tout des transformations à effectuer à l’aide d’une expression Colonne personnalisée dans M, mais une ou plusieurs de ces expressions sur lesquelles vous pourriez cliquer ou que vous pourriez ajouter ne sont pas disponibles dans l’interface utilisateur.You know all about the transformations you need using a Custom Column expression in M, but one (or more) of those expressions aren't available to click or add in the UI.

L’utilisation de la fonctionnalité Ajouter une colonne à partir d’un exemple est simple et directe.Using the add column from example feature is easy and straightforward. Les sections suivantes montrent à quel point cela est facile.In the next few sections, we see just how easy it is.

Utiliser l’Éditeur de requête pour ajouter une colonne à partir d’exemplesUse Query Editor to add a new column from examples

Pour créer une colonne à partir d’un exemple, démarrez l’Éditeur de requête.To create a new column from an example, launch Query Editor. Pour ce faire, dans le ruban Accueil de Power BI Desktop, sélectionnez Modifier les requêtes.You can do this by selecting Edit Queries from the Home ribbon in Power BI Desktop.

Dans le cadre de cet article, nous utilisons des données de l’article de Wikipedia répertoriant les États et territoires des États-Unis (il s’agit d’un lien sur lequel vous pouvez cliquer afin d’obtenir les données nécessaires pour suivre la procédure) :In this article, we'll use data from the following Wikipedia article (it's a link, so you can click it to get the data for yourself and follow along):

Une fois l’Éditeur de requête lancé et certaines données chargées, vous pouvez commencer à ajouter une colonne à partir d’exemples.Once Query Editor is launched and you have some data loaded, you can get started adding a column from examples. Pour ajouter une colonne, dans l’Éditeur de requête, sélectionnez l’onglet Ajouter une colonne dans le ruban, puis choisissez Colonne à partir d’exemples.To add a new column, in Query Editor select the Add Column tab on the ribbon and select Column from Examples. Si vous choisissez la liste déroulante, vous pouvez sélectionner À partir de toutes les colonnes (ce qui est l’option par défaut si vous choisissez le bouton au lieu de la liste déroulante) ou À partir de la sélection.If you choose the drop-down, you can select either From All Columns (the default, if you just select the button instead of the drop-down) or select From Selection. Dans le cadre de cet article, nous allons sélectionner À partir de toutes les colonnes.In this article, we'll walk through selecting From All Columns.

Volet Ajouter une colonne à partir d’exemplesThe Add Column From Examples pane

Lorsque vous opérez une sélection pour ajouter une colonne à partir d’exemples, un nouveau volet contenant les colonnes du tableau actif (il se peut que vous deviez faire défiler pour les voir toutes) s’affiche.Once you make a selection to add a new column from examples, a new pane appears that shows the columns in the current table (you may need to scroll to see them all). La nouvelle colonne (Colonne1) s’affiche du côté droit. Il s’agit de la colonne que Power BI Desktop va créer à partir de vos exemples.The new Column1 is also shown to the right, which is the column that Power BI Desktop will create based on your examples. Sous le nouvel en-tête Colonne1 figurent des cellules vides dans lesquelles vous pouvez entrer les exemples que Power BI doit utiliser pour créer les règles et transformations correspondantes.Below the new Column1 header are blank cells, where you can type in your examples that Power BI uses to create rules and transformations to match your example.

Notez également qu’il s’agit de l’une des Étapes appliquées dans le volet Paramètres d’une requête.Notice too that this is an Applied Step in the Query Settings pane. Comme toujours, l’Éditeur de requête enregistre vos étapes de transformation, puis les applique à la requête dans le même ordre.As always, Query Editor will record your transformation steps and apply them to the query, in order.

Ci-dessous figure le volet Ajouter une colonne à partir d’exemples qui comprend quatre zones principales :This is called the Add Columns From Examples pane, and it consists of four primary areas:

  1. La Barre de commandes qui contient une brève description de la fonctionnalité ou de la transformation.The Command bar which includes a brief description of the feature, or the transformation.
  2. L’option Envoyer des commentaires qui vous d’aider Power BI à améliorer cette fonctionnalité.The Send Feedback option to help Power BI improve this feature.
  3. Les boutons OK et Annuler qui vous permettent respectivement de valider vos transformations pour ajouter la colonne ou d’annuler l’opération.The OK and Cancel buttons, which lets you commit your transformations and add the column, or cancel.
  4. La zone de la nouvelle colonne dans laquelle vous pouvez entrer vos exemples de valeurs dans les lignes de votre choix (pour fournir l’exemple à Power BI), en rapport avec d’autres colonnes de cette ligne.The new column area, where you can type your sample values in any of the rows (to provide Power BI with your example), relating to other columns in that row.

À mesure que vous tapez votre exemple dans la nouvelle colonne, Power BI affiche un aperçu de la façon dont la colonne en cours de création s’affichera, en fonction des transformations qu’il détecte.As you type your example in the new column, Power BI gives you a preview of how the column it's creating will appear, based on the transformations it detects. Par exemple, nous avons tapé Alabama dans la première ligne, ce qui correspond à la valeur Alabama dans la première colonne du tableau.For example, we typed Alabama in the first row, corresponding to the Alabama value in the first column of the table. Dès que nous appuyons sur Entrée, Power BI remplit la colonne sur la base de cette valeur.As soon as we hit Enter Power BI fills in the column based on that value.

Ensuite, quand nous sommes passés à la ligne contenant Massachusetts [E] et avons supprimé les caractères [E] (parce que nous ne les voulions pas), Power BI a détecté la modification et utilisé l’exemple pour créer une transformation.But then we went to the row that included Massachusetts[E] and deleted that last [E] portion (because we didn't want it) and Power BI detected the change, and used the example to create a transformation. Vous pouvez voir l’explication de la transformation dans le volet central supérieur.Notice the explanation of the transform in the upper middle pane.

À mesure que vous continuez à fournir des exemples, l’Éditeur de requête complète les transformations.As you continue to provide examples, Query Editor adds to the transformations. Lorsque vous êtes satisfait, vous pouvez sélectionner OK pour valider vos modifications.When you're satisfied, you can select OK to commit your changes.

Voir la fonctionnalité Ajouter une colonne à partir d’exemples en actionSee Add Column from Examples in action

Vous voulez voir la fonctionnalité opérer ?Want to see this working? La vidéo suivante montre son exécution à l’aide de la source de données fournie précédemment dans cet exemple.The following video shows this feature being put to use, using the data source provided earlier in this example. Jetez-y un coup de œil et suivez la procédure de votre côté.Take a look, and follow along for yourself!

Considérations et limitationsConsiderations and limitations

De nombreuses transformations sont disponibles lorsque vous utilisez la fonctionnalité Ajouter une colonne à partir d’exemples, mais certaines d’entre elles ne sont pas incluses.There are many transformations that are available when using Add column from Examples, but not every transformation is included. La liste suivante répertorie toutes les transformations qui sont prises en charge.The following list provides all the transformations that are supported.

  • RéférenceReference

    • Référence à une colonne spécifique (incluant les transformations Supprimer les espaces, Nettoyer et Casse)Reference to a specific column (including trim, clean, and case transformations)
  • Transformations TextText transformations

    • Combiner (prend en charge la combinaison de chaînes littérales et de valeurs de colonne entière)Combine (supports combination of literal strings and entire column values)
    • RemplacerReplace
    • LongueurLength
    • ExtraireExtract
      • Premiers caractèresFirst Characters
      • Derniers caractèresLast Characters
      • PlageRange
      • Texte avant le délimiteurText before Delimiter
      • Texte après le délimiteurText after Delimiter
      • Texte entre les délimiteursText between Delimiters
      • LongueurLength
  • Les transformations Texte prises en charge suivantes sont disponibles depuis la publication de Power BI Desktop du mois de novembre 2017 :The following supported text transformations are available beginning with the November 2017 release of Power BI Desktop:

    • Supprimer des caractèresRemove Characters
    • Conserver des caractèresKeep Characters

Note

Toutes les transformations Texte prennent en compte le besoin potentiel de supprimer les espaces, de nettoyer ou d’appliquer une transformation de casse aux valeurs de la colonne.All Text transformations take into account the potential need to trim, clean, or apply a case transformation to the column value.

  • Transformations DateDate transformations

    • JourDay
    • Jour de la semaineDay of Week
    • Nom du jour de la semaineDay of Week Name
    • Jour de l’annéeDay of Year
    • MoisMonth
    • Nom du moisMonth Name
    • Trimestre de l’annéeQuarter of Year
    • Semaine du moisWeek of Month
    • Semaine de l’annéeWeek of Year
    • AnnéeYear
    • ÂgeAge
    • Début de l’annéeStart of Year
    • Fin de l’annéeEnd of Year
    • Début du moisStart of Month
    • Fin du moisEnd of Month
    • Début du trimestreStart of Quarter
    • Jours du moisDays in Month
    • Fin du trimestreEnd of Quarter
    • Début de semaineStart of Week
    • Fin de semaineEnd of Week
    • Jour du moisDay of Month
    • Début de journéeStart of Day
    • Fin de journéeEnd of Day
  • Transformations TimeTime transformations

    • HeureHour
    • MinuteMinute
    • SecondeSecond
    • Vers Heure localeTo Local Time

Note

Toutes les transformations Date et Time prennent en compte le besoin potentiel de convertir les valeurs de la colonne en Date, Time ou DateTime.All Date and Time transformations take into account the potential need to convert the column value to Date or Time or DateTime.

  • Transformations NombreNumber transformations

    • Valeur absolueAbsolute Value
    • ArccosinusArccosine
    • ArcsinusArcsine
    • ArctangenteArctangent
    • Convertir en nombreConvert to Number
    • CosinusCosine
    • CubeCube
    • DiviserDivide
    • ExposantExponent
    • FactorielleFactorial
    • Diviser par entierInteger Divide
    • Est pairIs Even
    • Est impairIs Odd
    • LnLn
    • Logarithme de base 10Base-10 Logarithm
    • ModuloModulo
    • MultiplierMultiply
    • Arrondi à l’entier inférieurRound Down
    • Arrondi à l’entier supérieurRound Up
    • SigneSign
    • SinSin
    • Racine carréeSquare Root
    • CarréSquare
    • SoustraireSubtract
    • SommeSum
    • TangenteTangent
  • La transformation Nombre prise en charge suivante est disponible depuis la publication de Power BI Desktop du mois de novembre 2017 :The following supported number transformation is available beginning with the November 2017 release of Power BI Desktop:

    • Création de compartiments/plagesBucketing/Ranges
  • GénéralGeneral

    • Colonne conditionnelleConditional Column