SUMMARIZE

Article
10/20/2023

S’applique à :Colonne calculée Table calculée Mesure Calcul visuel

Retourne une table récapitulative des totaux demandés sur un ensemble de groupes.

Syntaxe

SUMMARIZE (<table>, <groupBy_columnName>[, <groupBy_columnName>]…[, <name>, <expression>]…)

Paramètres

Terme	Définition
tableau	Toute expression DAX qui retourne une table de données.
groupBy_ColumnName	(Facultatif) Nom qualifié d’une colonne existante utilisé pour créer des groupes de synthèse en fonction des valeurs qui s’y trouvent. Ce paramètre ne peut pas être une expression.
name	Nom donné à une colonne de totaux ou de synthèse, placé entre guillemets doubles.
expression	Toute expression DAX qui retourne une valeur scalaire unique où l’expression doit être évaluée plusieurs fois (pour chaque ligne/contexte).

Valeur de retour

Table avec les colonnes sélectionnées pour les arguments groupBy_columnName et les colonnes synthétisées désignées par les arguments name.

Remarques

Chaque colonne pour laquelle vous définissez un nom doit avoir une expression correspondante ; dans le cas contraire, une erreur est retournée. Le premier argument, name, définit le nom de la colonne dans les résultats. Le deuxième argument, expression, définit le calcul effectué pour obtenir la valeur de chaque ligne de cette colonne.
groupBy_columnName doit être dans la table ou dans une table associée à la table.
Chaque nom doit être placé entre guillemets doubles.
La fonction regroupe un ensemble sélectionné de lignes en un ensemble de lignes de synthèse selon les valeurs d’une ou plusieurs colonnes groupBy_columnName. Une ligne est retournée pour chaque groupe.
Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery quand elle est utilisée dans des colonnes calculées ou des règles de sécurité au niveau des lignes (RLS).

Exemple

L’exemple suivant retourne un résumé des ventes du revendeur, regroupées autour de l’année civile et du nom de la catégorie de produits. Cette table de résultats vous permet d’effectuer une analyse sur les ventes du revendeur par année et par catégorie de produits.

SUMMARIZE(ResellerSales_USD  
      , DateTime[CalendarYear]  
      , ProductCategory[ProductCategoryName]  
      , "Sales Amount (USD)", SUM(ResellerSales_USD[SalesAmount_USD])  
      , "Discount Amount (USD)", SUM(ResellerSales_USD[DiscountAmount])  
      )

La table suivante présente un aperçu des données telles qu’elles seraient reçues par toute fonction attendant de recevoir une table :

DateTime[CalendarYear]	ProductCategory[ProductCategoryName]	[Sales Amount (USD)]	[Discount Amount (USD)]
2008	Bikes	12968255.42	36167.6592
2005	Bikes	6958251.043	4231.1621
2006	Bikes	18901351.08	178175.8399
2007	Bikes	24256817.5	276065.992
2008	Composants	2008052.706	39.9266
2005	Composants	574256.9865	0
2006	Composants	3428213.05	948.7674
2007	Composants	5195315.216	4226.0444
2008	Clothing	366507.844	4151.1235
2005	Clothing	31851.1628	90.9593
2006	Clothing	455730.9729	4233.039
2007	Clothing	815853.2868	12489.3835
2008	Accessories	153299.924	865.5945
2005	Accessories	18594.4782	4.293
2006	Accessories	86612.7463	1061.4872
2007	Accessories	275794.8403	4756.6546

Avec ROLLUP

L’ajout de la syntaxe ROLLUP modifie le comportement de la fonction SUMMARIZE en ajoutant des lignes de cumul au résultat sur les colonnes groupBy_columnName. ROLLUP s’utilise uniquement dans une expression SUMMARIZE.

Exemple

L’exemple suivant ajoute des lignes de cumul aux colonnes Group-By de l’appel de fonction SUMMARIZE :

SUMMARIZE(ResellerSales_USD  
      , ROLLUP( DateTime[CalendarYear], ProductCategory[ProductCategoryName])  
      , "Sales Amount (USD)", SUM(ResellerSales_USD[SalesAmount_USD])  
      , "Discount Amount (USD)", SUM(ResellerSales_USD[DiscountAmount])  
)

Retourne la table suivante

DateTime[CalendarYear]	ProductCategory[ProductCategoryName]	[Sales Amount (USD)]	[Discount Amount (USD)]
2008	Bikes	12968255.42	36167.6592
2005	Bikes	6958251.043	4231.1621
2006	Bikes	18901351.08	178175.8399
2007	Bikes	24256817.5	276065.992
2008	Composants	2008052.706	39.9266
2005	Composants	574256.9865	0
2006	Composants	3428213.05	948.7674
2007	Composants	5195315.216	4226.0444
2008	Clothing	366507.844	4151.1235
2005	Clothing	31851.1628	90.9593
2006	Clothing	455730.9729	4233.039
2007	Clothing	815853.2868	12489.3835
2008	Accessories	153299.924	865.5945
2005	Accessories	18594.4782	4.293
2006	Accessories	86612.7463	1061.4872
2007	Accessories	275794.8403	4756.6546
2008		15496115.89	41224.3038
2005		7582953.67	4326.4144
2006		22871907.85	184419.1335
2007		30543780.84	297538.0745
		76494758.25	527507.9262

Avec ROLLUPGROUP

Toutefois, l’ajout de ROLLUPGROUP dans une syntaxe ROLLUP peut être utilisé pour empêcher les sous-totaux partiels dans les lignes de cumul. ROLLUPGROUP s’utilise uniquement dans une expression ROLLUP, ROLLUPADDISSUBTOTAL ou ROLLUPISSUBTOTAL.

Exemple

L’exemple suivant affiche uniquement le total général de toutes les années et de toutes les catégories sans le sous-total de chaque année avec toutes les catégories :

SUMMARIZE(ResellerSales_USD  
      , ROLLUP(ROLLUPGROUP( DateTime[CalendarYear], ProductCategory[ProductCategoryName]))  
      , "Sales Amount (USD)", SUM(ResellerSales_USD[SalesAmount_USD])  
      , "Discount Amount (USD)", SUM(ResellerSales_USD[DiscountAmount])  
)

Retourne la table suivante

DateTime[CalendarYear]	ProductCategory[ProductCategoryName]	[Sales Amount (USD)]	[Discount Amount (USD)]
2008	Bikes	12968255.42	36167.6592
2005	Bikes	6958251.043	4231.1621
2006	Bikes	18901351.08	178175.8399
2007	Bikes	24256817.5	276065.992
2008	Composants	2008052.706	39.9266
2005	Composants	574256.9865	0
2006	Composants	3428213.05	948.7674
2007	Composants	5195315.216	4226.0444
2008	Clothing	366507.844	4151.1235
2005	Clothing	31851.1628	90.9593
2006	Clothing	455730.9729	4233.039
2007	Clothing	815853.2868	12489.3835
2008	Accessories	153299.924	865.5945
2005	Accessories	18594.4782	4.293
2006	Accessories	86612.7463	1061.4872
2007	Accessories	275794.8403	4756.6546
		76494758.25	527507.9262

Avec ISSUBTOTAL

ISSUBTOTAL vous permet de créer une autre colonne dans l’expression SUMMARIZE qui retourne True si la ligne contient des valeurs de sous-total pour la colonne fournie comme argument de ISSUBTOTAL ; sinon, retourne false. ISSUBTOTAL s’utilise uniquement dans une expression SUMMARIZE.

Exemple

L’exemple suivant génère une colonne ISSUBTOTAL pour chacune des colonnes ROLLUP dans l’appel de fonction SUMMARIZE donné :

SUMMARIZE(ResellerSales_USD  
      , ROLLUP( DateTime[CalendarYear], ProductCategory[ProductCategoryName])  
      , "Sales Amount (USD)", SUM(ResellerSales_USD[SalesAmount_USD])  
      , "Discount Amount (USD)", SUM(ResellerSales_USD[DiscountAmount])  
      , "Is Sub Total for DateTimeCalendarYear", ISSUBTOTAL(DateTime[CalendarYear])  
      , "Is Sub Total for ProductCategoryName", ISSUBTOTAL(ProductCategory[ProductCategoryName])  
)

Retourne la table suivante

[Is Sub Total for DateTimeCalendarYear]	[Is Sub Total for ProductCategoryName]	DateTime[CalendarYear]	ProductCategory[ProductCategoryName]	[Sales Amount (USD)]	[Discount Amount (USD)]
FALSE	FAUX
FAUX	FALSE	2008	Bikes	12968255.42	36167.6592
FALSE	FALSE	2005	Bikes	6958251.043	4231.1621
FAUX	FALSE	2006	Bikes	18901351.08	178175.8399
FALSE	FALSE	2007	Bikes	24256817.5	276065.992
FALSE	FALSE	2008	Composants	2008052.706	39.9266
FALSE	FALSE	2005	Composants	574256.9865	0
FALSE	FALSE	2006	Composants	3428213.05	948.7674
FALSE	FALSE	2007	Composants	5195315.216	4226.0444
FALSE	FALSE	2008	Clothing	366507.844	4151.1235
FALSE	FALSE	2005	Clothing	31851.1628	90.9593
FALSE	FALSE	2006	Clothing	455730.9729	4233.039
FALSE	FALSE	2007	Clothing	815853.2868	12489.3835
FALSE	FALSE	2008	Accessories	153299.924	865.5945
FALSE	FALSE	2005	Accessories	18594.4782	4.293
FALSE	FALSE	2006	Accessories	86612.7463	1061.4872
FALSE	FALSE	2007	Accessories	275794.8403	4756.6546
false	VRAI
FAUX	true	2008		15496115.89	41224.3038
false	true	2005		7582953.67	4326.4144
false	true	2006		22871907.85	184419.1335
false	true	2007		30543780.84	297538.0745
VRAI	TRUE			76494758.25	527507.9262

SUMMARIZECOLUMNS

Partager via

SUMMARIZE

Syntaxe

Paramètres

Valeur de retour

Remarques

Exemple

Avec ROLLUP

Exemple

Avec ROLLUPGROUP

Exemple

Avec ISSUBTOTAL

Exemple

Commentaires

Ressources supplémentaires

Partager via

SUMMARIZE

Syntaxe

Paramètres

Valeur de retour

Remarques

Exemple

Avec ROLLUP

Exemple

Avec ROLLUPGROUP

Exemple

Avec ISSUBTOTAL

Exemple

Contenu connexe

Commentaires

Ressources supplémentaires