Fonctions de table

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.