Partager via

Fonctions de table

  • Article

Ces fonctions créent et manipulent les valeurs de table.

Création de table

Nom Description
ItemExpression.From Retourne l’arborescence de syntaxe abstraite (AST) pour le corps d’une fonction.
ItemExpression.Item Un nœud d’arborescence de syntaxe abstraite (AST) représentant l’élément dans une expression d’élément.
RowExpression.Column Retourne une arborescence de syntaxe abstraite (AST) qui représente l’accès à la colonne dans une expression de ligne.
RowExpression.From Retourne l’arborescence de syntaxe abstraite (AST) pour le corps d’une fonction.
RowExpression.Row Un nœud d’arborescence de syntaxe abstraite (AST) représentant la ligne dans une expression de ligne.
Table.FromColumns Retourne une table à partir d’une liste contenant des listes imbriquées avec les noms et les valeurs des colonnes.
Table.FromList Convertit une liste en table en appliquant la fonction de fractionnement spécifiée à chaque élément de la liste.
Table.FromRecords Retourne une table à partir d’une liste d’enregistrements.
Table.FromRows Crée une table à partir de la liste où chaque élément de la liste est une liste qui contient les valeurs de colonne pour une seule ligne.
Table.FromValue Retourne une table avec une colonne contenant la valeur ou la liste de valeurs fournie.
Table.FuzzyGroup Regroupe les lignes d’une table selon les valeurs approximativement correspondantes de la colonne spécifiée pour chaque ligne.
Table.FuzzyJoin Joint les lignes de deux tables qui correspondent approximativement en fonction des clés spécifiées.
Table.FuzzyNestedJoin Effectue une jointure approximative entre des tables selon les colonnes fournies et produit le résultat de la jointure dans une nouvelle colonne.
Table.Split Divise la table spécifiée en liste de tables à l’aide de la taille de page spécifiée.
Table.WithErrorContext Cette fonction est réservée à un usage interne uniquement.
Table.View Crée ou étend une table avec des gestionnaires définis par l’utilisateur pour les opérations de requête et d’action.
Table.ViewError Crée un enregistrement d’erreur modifié qui ne déclenche pas de secours lorsqu’il est levé par un gestionnaire défini sur une vue (via Table.View).
Table.ViewFunction Crée une fonction pouvant être interceptée par un gestionnaire défini sur une vue (via Table.View).

Conversions

Nom Description
Table.ToColumns Retourne une liste de listes imbriquées représentant chacune une colonne de valeurs dans la table d’entrée.
Table.ToList Retourne une table dans une liste en appliquant la fonction de combinaison spécifiée à chaque ligne de valeurs dans une table.
Table.ToRecords Retourne une liste d’enregistrements à partir d’une table d’entrée.
Table.ToRows Retourne une liste imbriquée de valeurs de ligne à partir d’une table d’entrée.

Information

Nom Description
Table.ApproximateRowCount Retourne le nombre approximatif de lignes dans la table.
Table.ColumnCount Retourne le nombre de colonnes d’une table.
Table.IsEmpty Retourne true si la table ne contient aucune ligne.
Table.Profile Retourne un profil des colonnes d’une table.
Table.RowCount Retourne le nombre de lignes d’une table.
Table.Schema Retourne une table contenant une description des colonnes (c’est-à-dire le schéma) de la table spécifiée.
Tables.GetRelationships Retourne les relations entre un ensemble de tables.

Opérations sur les lignes

Nom Description
Table.AlternateRows Retourne une table contenant un modèle d’alternance des lignes d’une table.
Table.Combine Retourne une table qui est le résultat de la fusion d’une liste de tables. Les tables doivent toutes avoir la même structure de type de ligne.
Table.FindText Retourne une table contenant uniquement les lignes dont le texte spécifié se trouve dans l’une de leurs cellules ou dans une partie de celles-ci.
Table.First Retourne la première ligne d’une table.
Table.FirstN Retourne la ou les premières lignes d’une table en fonction du paramètre countOrCondition.
Table.FirstValue Retourne la première colonne de la première ligne de la table ou une valeur par défaut spécifiée.
Table.FromPartitions Retourne une table qui est le résultat de la combinaison d’un ensemble de tables partitionnées en nouvelles colonnes. Le type de la colonne peut éventuellement être spécifié (la valeur par défaut est any).
Table.InsertRows Retourne une table avec la liste des lignes insérées dans la table au niveau d’un index. Chaque ligne à insérer doit correspondre au type de ligne de la table.
Table.Last Retourne la dernière ligne d’une table.
Table.LastN Retourne la ou les dernières lignes d’une table en fonction du paramètre countOrCondition.
Table.MatchesAllRows Retourne true si toutes les lignes d’une table remplissent une condition.
Table.MatchesAnyRows Retourne true si l’une des lignes d’une table remplit une condition.
Table.Partition Partitionne la table en un certain nombre (« groups ») de tables, en fonction de la valeur de la colonne de chaque ligne et d’une fonction de hachage. La fonction de hachage est appliquée à la valeur de la colonne d’une ligne pour obtenir une valeur de hachage pour la ligne. Le modulo de la valeur de hachage « groups » détermine dans laquelle des tables retournées la ligne est placée.
Table.PartitionValues Retourne les informations de partition d’une table.
Table.Range Retourne le nombre spécifié de lignes d’une table en tenant compte d’un décalage pour commencer.
Table.RemoveFirstN Retourne une table avec le nombre spécifié de lignes supprimées de la table en commençant à la première ligne. Le nombre de lignes supprimées dépend du paramètre facultatif countOrCondition.
Table.RemoveLastN Retourne une table avec le nombre spécifié de lignes supprimées de la table en commençant à la dernière ligne. Le nombre de lignes supprimées dépend du paramètre facultatif countOrCondition.
Table.RemoveRows Retourne une table avec le nombre spécifié de lignes supprimées de la table en tenant compte d’un décalage pour commencer.
Table.RemoveRowsWithErrors Retourne une table avec toutes les lignes supprimées de la table qui contiennent une erreur dans au moins une des cellules d’une ligne.
Table.Repeat Retourne une table contenant les lignes de la table répétées un certain nombre de fois.
Table.ReplaceRows Retourne une table où les lignes, en tenant compte d’un décalage pour commencer et d’un nombre défini de lignes, sont remplacées par les lignes fournies.
Table.ReverseRows Retourne une table avec les lignes dans l’ordre inverse.
Table.SelectRows Retourne une table contenant uniquement les lignes qui correspondent à une condition.
Table.SelectRowsWithErrors Retourne une table avec seulement les lignes de la table qui contiennent une erreur dans au moins une des cellules d’une ligne.
Table.SingleRow Retourne une seule ligne d’une table.
Table.Skip Retourne une table qui ne contient pas la ou les premières lignes de la table.
Table.SplitAt Renvoie une liste contenant le nombre spécifié de lignes depuis le début et les lignes restantes.

Opérations sur les colonnes

Nom Description
Table.Column Retourne les valeurs d’une colonne dans une table.
Table.ColumnNames Retourne les noms des colonnes d’une table.
Table.ColumnsOfType Retourne une liste avec les noms des colonnes qui correspondent aux types spécifiés.
Table.DemoteHeaders Abaisse la ligne d’en-tête au niveau de la première ligne d’une table.
Table.DuplicateColumn Duplique une colonne avec le nom spécifié. Les valeurs et le type sont copiés à partir de la colonne source.
Table.HasColumns Indique si la table contient la ou les colonnes spécifiées.
Table.Pivot Crée, pour une table et une colonne d’attribut données contenant des valeurs de tableau croisé dynamique, des colonnes pour chacune des valeurs de tableau croisé dynamique et leur affecte des valeurs de valueColumn. Une fonction d’agrégation (aggregationFunction) facultative peut être fournie pour gérer plusieurs occurrences de la même valeur de clé dans la colonne d’attribut.
Table.PrefixColumns Retourne une table dans laquelle les colonnes ont toutes pour préfixe une valeur de texte.
Table.PromoteHeaders Promeut la première ligne de la table en noms d’en-tête ou de colonne.
Table.RemoveColumns Retourne une table sans une ou plusieurs colonnes spécifiques.
Table.ReorderColumns Retourne une table avec des colonnes spécifiques ordonnées les unes par rapport aux autres.
Table.RenameColumns Retourne une table avec les colonnes renommées comme spécifié.
Table.SelectColumns Retourne une table qui contient uniquement des colonnes spécifiques.
Table.TransformColumnNames Transforme les noms de colonnes en utilisant la fonction donnée.
Table.Unpivot Transforme les colonnes d’une liste de colonnes de table en paires attribut-valeur.
Table.UnpivotOtherColumns Convertit toutes les colonnes autres qu’un ensemble spécifié en paires attribut-valeur, combinées avec le reste des valeurs de chaque ligne.

Transformation

Nom Description
Table.AddColumn Ajoute une colonne nommée newColumnName à une table.
Table.AddFuzzyClusterColumn Ajoute une nouvelle colonne avec les valeurs représentatives obtenues en regroupant de manière approximative les valeurs de la colonne spécifiée dans la table.
Table.AddIndexColumn Retourne une table avec une nouvelle colonne nommée qui, pour chaque ligne, contient un index de la ligne dans la table.
Table.AddJoinColumn Effectue une jointure imbriquée entre table1 et table2 à partir de colonnes spécifiques et produit le résultat de la jointure sous la forme d’une nouvelle colonne nommée pour chaque ligne de table1.
Table.AddKey Ajoute une clé à la table.
Table.AggregateTableColumn Agrège les tables imbriquées dans une colonne spécifique en plusieurs colonnes contenant des valeurs agrégées pour ces tables.
Table.CombineColumns Table.CombineColumns fusionne les colonnes à l’aide d’une fonction d’association pour produire une nouvelle colonne. Table.CombineColumns est l’inverse de Table.SplitColumns.
Table.CombineColumnsToRecord Combine les colonnes spécifiées dans une nouvelle colonne d’enregistrements où chaque enregistrement a des noms de champs et des valeurs correspondant aux noms et aux valeurs des colonnes qui ont été combinées.
Table.ConformToPageReader Cette fonction est réservée à un usage interne uniquement.
Table.ExpandListColumn En fonction d’une colonne de listes dans une table, crée une copie d’une ligne pour chaque valeur dans la liste.
Table.ExpandRecordColumn Développe une colonne d’enregistrements en colonnes avec chacune des valeurs.
Table.ExpandTableColumn Développe une colonne d’enregistrements ou de tables en plusieurs colonnes dans la table conteneur.
Table.FillDown Remplace les valeurs Null dans la ou les colonnes spécifiées de la table par la valeur non-Null la plus récente dans la colonne.
Table.FillUp Retourne une table à partir de la table spécifiée où la valeur de la cellule suivante est propagée aux cellules dont la valeur est Null au-dessus de la colonne spécifiée.
Table.FilterWithDataTable Cette fonction est réservée à un usage interne uniquement.
Table.Group Regroupe les lignes de table selon les valeurs des colonnes clés pour chaque ligne.
Table.Join Joint les lignes de table1 aux lignes de table2 en fonction de l’égalité des valeurs des colonnes clés sélectionnées par table1, key1 et table2, key2.
Table.Keys Renvoie les clés de la table spécifiée.
Table.NestedJoin Joint les lignes des tables en fonction de l’égalité des clés. Les résultats sont entrés dans une nouvelle colonne.
Table.ReplaceErrorValues Remplace les valeurs d’erreur dans les colonnes indiquées par la valeur spécifiée correspondante.
Table.ReplaceKeys Remplace les clés de la table spécifiée.
Table.ReplaceRelationshipIdentity Cette fonction est réservée à un usage interne uniquement.
Table.ReplaceValue Remplace oldValue par newValue dans les colonnes spécifiques d’une table à l’aide de la fonction de remplacement fournie, par exemple text.Replace ou Value.Replace.
Table.SplitColumn Retourne un nouvel ensemble de colonnes à partir d’une colonne unique en appliquant une fonction de fractionnement à chaque valeur.
Table.TransformColumns Transforme les valeurs d’une ou plusieurs colonnes.
Table.TransformColumnTypes Transforme les types de colonne d’une table à l’aide d’un type.
Table.TransformRows Transforme les lignes d’une table à l’aide d’une fonction de transformation.
Table.Transpose Retourne une table en convertissant les colonnes en lignes et les lignes en colonnes à partir de la table d’entrée.

Adhésion

Nom Description
Table.Contains Détermine si l’enregistrement apparaît sous forme d’une ligne dans la table.
Table.ContainsAll Détermine si tous les enregistrements spécifiés apparaissent sous forme de lignes dans la table.
Table.ContainsAny Détermine si l’un des enregistrements spécifiés apparaît sous forme de lignes dans la table.
Table.Distinct Supprime les lignes dupliquées d’une table, garantissant ainsi que toutes les lignes restantes sont distinctes.
Table.IsDistinct Détermine si une table contient uniquement des lignes distinctes.
Table.PositionOf Détermine la ou les positions d’une ligne dans une table.
Table.PositionOfAny Détermine la ou les positions de l’une des lignes spécifiées dans la table.
Table.RemoveMatchingRows Supprime toutes les occurrences des lignes d’une table.
Table.ReplaceMatchingRows Remplace les lignes spécifiques d’une table par les nouvelles lignes.

Classement

Nom Description
Table.Max Retourne la ou les lignes les plus grandes d’une table à l’aide de comparisonCriteria.
Table.MaxN Retourne les N lignes les plus grandes d’une table. Une fois les lignes triées, le paramètre countOrCondition doit être spécifié pour filtrer davantage le résultat.
Table.Min Retourne la ou les lignes les plus petites d’une table à l’aide de comparisonCriteria.
Table.MinN Retourne les N lignes les plus petites dans la table donnée. Une fois les lignes triées, le paramètre countOrCondition doit être spécifié pour filtrer davantage le résultat.
Table.AddRankColumn Ajoute une colonne avec le classement d’une ou plusieurs autres colonnes.
Table.Sort Trie les lignes d’une table à l’aide de comparisonCriteria ou d’un classement par défaut si rien n’est spécifié.

Autre

Nom Description
Table.Buffer Met une table en mémoire tampon, en l’isolant des modifications externes pendant l’évaluation.

Valeurs des paramètres

Nommage des colonnes de sortie

Ce paramètre est une liste de valeurs de texte qui spécifient les noms de colonnes de la table résultante. Ce paramètre est généralement utilisé dans les fonctions de construction Table telles que Table.FromRows et Table.FromList.

Critères de comparaison

Un critère de comparaison peut être fourni sous forme d’une des valeurs suivantes :

  • Une valeur numérique pour spécifier un ordre de tri. Plus d’informations : Ordre de tri

  • Pour calculer une clé à utiliser pour le tri, une fonction de 1 argument peut être utilisée.

  • Pour à la fois sélectionner une clé et contrôler l’ordre, le critère de comparaison peut être une liste contenant la clé et l’ordre.

  • Pour contrôler complètement la comparaison, une fonction de 1, 0 arguments peut être utilisée, qui retourne -1 ou 1 en fonction de la relation entre les entrées de gauche et de droite. Value.Compare peut être utilisée pour déléguer cette logique.

Pour obtenir des exemples, accédez à la description de Table.Sort.

Nombre ou critère de condition

Ce critère est généralement utilisé dans les opérations relatives au tri ou aux lignes. Il détermine le nombre de lignes retournées dans la table et peut prendre deux formes, un nombre ou une condition.

  • Un nombre indique le nombre de valeurs à retourner inline avec la fonction appropriée.

  • Si une condition est spécifiée, les lignes contenant des valeurs qui remplissent initialement la condition sont retournées. Si une valeur ne remplit pas la condition, aucune autre valeur n’est prise en compte.

Plus d’informations : Table.FirstN, Table.MaxN

Gestion des valeurs supplémentaires

Les valeurs supplémentaires permettent d'indiquer comment la fonction doit traiter les valeurs supplémentaires dans une ligne. Ce paramètre est spécifié sous la forme d’un nombre qui est mappé aux options suivantes :

ExtraValues.List = 0 ExtraValues.Error = 1 ExtraValues.Ignore = 2

Plus d’informations : Table.FromList, ExtraValues.Type

Gestion des colonnes manquantes

Ce paramètre permet d’indiquer comment la fonction doit gérer les colonnes manquantes. Ce paramètre est spécifié sous la forme d’un nombre qui est mappé aux options suivantes :

MissingField.Error = 0 MissingField.Ignore = 1 MissingField.UseNull = 2;

Ce paramètre est utilisé dans les opérations de colonne ou de transformation, par exemple, dans Table.TransformColumns. Plus d’informations : MissingField.Type

Ordre de tri

L'ordre de tri est utilisé pour indiquer comment les résultats doivent être triés. Ce paramètre est spécifié sous la forme d’un nombre qui est mappé aux options suivantes :

Order.Ascending = 0 Order.Descending = 1

Plus d’informations : Order.Type

Critères d’égalité

Les critères d’égalité pour les tables peuvent être spécifiés comme suit :

  • Une valeur de fonction qui peut être :

    • Un sélecteur de clé qui détermine la colonne de la table pour appliquer les critères d’égalité.

    • Une fonction de comparateur utilisée pour spécifier le type de comparaison à appliquer. Les fonctions de comparateur intégrées peuvent être spécifiées. Plus d’informations : Fonctions comparateur

  • Liste des colonnes de la table auxquelles appliquer les critères d’égalité.

Pour obtenir des exemples, accédez à la description de Table.Distinct.