Partager via

Fonctions de table

  • Article

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

Construction de table

Nom Description
#table Crée une valeur de table à partir de colonnes et de lignes.
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 à une 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 Crée une table à partir d’une liste de colonnes et de valeurs spécifiées.
Table.FromList Convertit une liste en tableau en appliquant la fonction de fractionnement spécifiée à chaque élément de la liste.
Table.FromRecords Convertit une liste d’enregistrements en une table.
Table.FromRows Crée une table à partir d’une liste de valeurs de ligne et de colonnes facultatives.
Table.FromValue Crée une table avec une colonne à partir de la valeur ou des valeurs fournies.
Table.WithErrorContext Cette fonction est destinée uniquement à une utilisation interne.
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 lancé 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 Crée une liste de listes imbriquées de valeurs de colonne à partir d’une table.
Table.ToList Convertit une table en liste en appliquant la fonction de combinaison spécifiée à chaque ligne de valeurs de la table.
Table.ToRecords Convertit une table en une liste d’enregistrements.
Table.ToRows Crée une liste de listes imbriquées de valeurs de ligne à partir d’une table.

Information

Nom Description
Table.ApproximateRowCount Retourne le nombre approximatif de lignes dans le tableau.
Table.ColumnCount Retourne le nombre de colonnes dans la table.
Table.IsEmpty Indique si la table contient des lignes.
Table.PartitionValues Retourne des informations sur la façon dont une table est partitionnée.
Table.Profile Retourne un profil des colonnes d’une table.
Table.RowCount Retourne le nombre de lignes du tableau.
Table.Schema Retourne une table contenant une description des colonnes (autrement dit, le schéma) de la table spécifiée.
Tables.GetRelationships Obtient les relations entre un ensemble de tables.

Opérations sur les lignes

Nom Description
Table.AlternateRows Conserve le décalage initial puis accepte et ignore de façon alternée les lignes suivantes.
Table.Combine Retourne une table qui est le résultat de la fusion d’une liste de tables.
Table.FindText Retourne toutes les lignes qui contiennent le texte donné dans le tableau.
Table.First Retourne la première ligne ou une valeur par défaut spécifiée.
Table.FirstN Retourne les premières lignes de nombre spécifiées.
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 Renvoie une table qui est le résultat de la combinaison d’un ensemble de tables partitionnées.
Table.InsertRows Insère une liste de lignes dans la table à la position spécifiée.
Table.Last Retourne la dernière ligne ou une valeur par défaut spécifiée.
Table.LastN Retourne le dernier nombre de lignes spécifié.
Table.MatchesAllRows Indique si toutes les lignes de la table répondent à la condition donnée.
Table.MatchesAnyRows Indique si les lignes de la table répondent à la condition donnée.
Table.Partition Partitionne la table en une liste de tables en fonction du nombre de groupes et de colonnes spécifiés.
Table.Range Retourne les lignes commençant au décalage spécifié.
Table.RemoveFirstN Retourne une table avec le nombre spécifié de lignes supprimées de la table à partir de la première ligne.
Table.RemoveLastN Retourne une table avec le nombre spécifié de lignes supprimées de la table à partir de la dernière ligne.
Table.RemoveRows Supprime le nombre spécifié de lignes.
Table.RemoveRowsWithErrors Retourne un tableau avec les lignes supprimées de la table d’entrée qui contiennent une erreur dans au moins une des cellules. Si une liste de colonnes est spécifiée, seules les cellules des colonnes spécifiées sont inspectées pour les erreurs.
Table.Repeat Répète les lignes des tables un nombre spécifié de fois.
Table.ReplaceRows Remplace la plage spécifiée de lignes par la ligne ou les lignes fournies.
Table.ReverseRows Retourne une table avec les lignes dans l’ordre inverse.
Table.SelectRows Sélectionne les lignes qui répondent à la fonction de condition.
Table.SelectRowsWithErrors Retourne une table avec uniquement les lignes de la table d’entrée qui contiennent une erreur dans au moins une des cellules. Si une liste de colonnes est spécifiée, seules les cellules des colonnes spécifiées sont inspectées pour les erreurs.
Table.SingleRow Retourne une seule ligne dans la table.
Table.Skip Retourne une table avec le premier nombre spécifié de lignes ignorées.
Table.SplitAt Retourne une liste contenant les premières lignes de nombre spécifiées et les lignes restantes.

Opérations de colonne

Nom Description
Table.Column Retourne une colonne de données spécifiée de la table sous forme de liste.
Table.ColumnNames Retourne les noms de colonnes sous forme de liste.
Table.ColumnsOfType Retourne une liste avec les noms des colonnes qui correspondent aux types spécifiés.
Table.DemoteHeaders Rétrograde les en-têtes des colonnes à la première ligne de valeurs.
Table.DuplicateColumn Dupliquer 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 colonne ou les colonnes spécifiées.
Table.Pivot En fonction d’une paire de colonnes qui représente des paires attribut-valeur, fait pivoter les données de la colonne d’attribut dans les en-têtes de colonne.
Table.PrefixColumns Retourne un tableau où les colonnes ont toutes été précédées par le texte donné.
Table.PromoteHeaders Promeut la première ligne de valeurs en tant que nouveaux en-têtes de colonne (autrement dit, en tant que noms de colonnes).
Table.RemoveColumns Supprime les colonnes spécifiées.
Table.ReorderColumns Retourne une table avec les colonnes dans l’ordre spécifié.
Table.RenameColumns Retourne une table avec les colonnes renommées comme indiqué.
Table.SelectColumns Retourne une table avec uniquement les colonnes spécifiées.
Table.TransformColumnNames Transforme les noms de colonnes à l’aide de la fonction donnée.
Table.Unpivot Convertit un ensemble de colonnes d’une table en paires attribut-valeur.
Table.UnpivotOtherColumns Convertit toutes les colonnes autres qu’un ensemble spécifié en paires attribut-valeur.

Transformation

Nom Description
Table.AddColumn Ajoute une colonne portant le nom spécifié. La valeur est calculée à l’aide de la fonction de sélection spécifiée avec chaque ligne prise comme entrée.
Table.AddFuzzyClusterColumn Ajoute une nouvelle colonne avec des valeurs représentatives obtenues par des valeurs de regroupement approximatives de la colonne spécifiée dans la table.
Table.AddIndexColumn Ajoute une colonne avec des valeurs de position explicites.
Table.AddJoinColumn Effectue une jointure entre des tables sur des colonnes fournies et produit le résultat de jointure dans une nouvelle colonne.
Table.AddKey Ajoute une clé à une table.
Table.AggregateTableColumn Agrège une colonne de tables en plusieurs colonnes dans la table contenante.
Table.CombineColumns Combine les colonnes spécifiées dans une nouvelle colonne à l’aide de la fonction de combinaison spécifiée.
Table.CombineColumnsToRecord Combine les colonnes spécifiées dans une nouvelle colonne à valeur d’enregistrement où chaque enregistrement a des noms de champ et des valeurs correspondant aux noms et valeurs des colonnes qui ont été combinées.
Table.ConformToPageReader Cette fonction est destinée uniquement à une utilisation interne.
Table.ExpandListColumn Étant donné une colonne de listes dans une table, créez une copie d'une ligne pour chaque valeur de chaque 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 Propage la valeur d'une cellule précédente vers les cellules vides ci-dessous dans la colonne.
Table.FillUp Propage la valeur d'une cellule aux cellules à valeur nulle situées au-dessus dans la colonne.
Table.FilterWithDataTable Cette fonction est destinée uniquement à une utilisation interne.
Table.FuzzyGroup Regroupe les lignes de la table en fonction de la correspondance approximative des clés.
Table.FuzzyJoin Associe les lignes des deux tables qui correspondent de manière approximative en fonction des clés données.
Table.FuzzyNestedJoin Effectue une jointure approximative entre les tables sur les colonnes fournies et produit le résultat de jointure dans une nouvelle colonne.
Table.Group Regroupe les lignes de la table qui ont la même clé.
Table.Join Joint les lignes des deux tables qui correspondent en fonction des clés données.
Table.Keys Retourne les clés de la table spécifiée.
Table.NestedJoin Effectue une jointure entre des tables sur des colonnes fournies et produit le résultat de jointure dans une nouvelle colonne.
Table.ReplaceErrorValues Remplace les valeurs d’erreur dans les colonnes spécifié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 destinée uniquement à une utilisation interne.
Table.ReplaceValue Remplace une valeur par une autre dans les colonnes spécifiées.
Table.Split Fractionne la table spécifiée en une liste de tables à l’aide de la taille de page spécifiée.
Table.SplitColumn Fractionne les colonnes spécifiées en un ensemble de colonnes supplémentaires à l’aide de la fonction de fractionnement spécifiée.
Table.TransformColumns Transforme les valeurs d’une ou plusieurs colonnes.
Table.TransformColumnTypes Applique la ou les transformations de type du formulaire { colonne, type } à l’aide d’une culture spécifique.
Table.TransformRows Transforme les lignes de la table à l’aide de la fonction de transformation spécifiée.
Table.Transpose Transforme les colonnes en lignes et lignes en colonnes.

Adhésion

Nom Description
Table.Contains Indique si l’enregistrement spécifié apparaît sous forme de ligne dans la table.
Table.ContainsAll Indique si tous les enregistrements spécifiés apparaissent sous forme de lignes dans la table.
Table.ContainsAny Indique si l’un des enregistrements spécifiés apparaît sous forme de lignes dans la table.
Table.Distinct Supprime les lignes dupliquées de la table.
Table.IsDistinct Indique si la table contient uniquement des lignes distinctes (pas de doublons).
Table.PositionOf Retourne la position ou les positions de la ligne dans la table.
Table.PositionOfAny Retourne la position ou les positions de l’une des lignes spécifiées dans la table.
Table.RemoveMatchingRows Supprime toutes les occurrences des lignes spécifiées de la table.
Table.ReplaceMatchingRows Remplace toutes les lignes spécifiées par la ligne ou les lignes fournies.

Classement

Nom Description
Table.AddRankColumn Ajoute une colonne avec le classement d’une ou plusieurs autres colonnes.
Table.Max Retourne la plus grande ligne ou la valeur par défaut à l’aide des critères donnés.
Table.MaxN Retourne la plus grande ligne ou les lignes à l’aide des critères donnés.
Table.Min Retourne la plus petite ligne ou une valeur par défaut à l’aide des critères donnés.
Table.MinN Retourne la plus petite ligne ou les lignes à l’aide des critères donnés.
Table.Sort Trie la table à l’aide d’un ou plusieurs noms de colonnes et critères de comparaison.

Autre

Nom Description
Table.Buffer Place une table dans la mémoire tampon, en l’isolant des modifications externes pendant l’évaluation.
Table.StopFolding Empêche l’exécution d’opérations en aval sur la source d’origine des données.

Valeurs des paramètres

Affectation de noms aux colonnes de sortie

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

Critères de comparaison

Les critères de comparaison peuvent être fournis comme l’une des valeurs suivantes :

  • 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 d’un argument peut être utilisée.

  • Pour sélectionner une clé et un ordre de contrôle, 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 deux arguments peut être utilisée qui retourne -1, 0 ou 1 en fonction de la relation entre les entrées de gauche et de droite. Value.Compare pouvez être utilisé 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 de classement ou de ligne. 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 répondent initialement à la condition sont retournées. Une fois qu’une valeur échoue, aucune autre valeur n’est prise en compte.

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

Gestion des valeurs supplémentaires

Des valeurs supplémentaires sont utilisées pour indiquer comment la fonction doit gérer des valeurs supplémentaires dans une ligne. Ce paramètre est spécifié sous la forme d’un nombre, qui correspond 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 est utilisé pour indiquer comment la fonction doit gérer les colonnes manquantes. Ce paramètre est spécifié sous la forme d’un nombre, qui correspond 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 correspond aux options suivantes :

Order.Ascending = 0
Order.Descending = 1

Plus d’informations : Order.Type

Critères d’équation

Les critères d’équation des tables peuvent être spécifiés comme suit :

  • Valeur de fonction qui est l’une des suivantes :

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

    • Fonction 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 de comparaison

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

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