Commande SUMMARIZE

Information de Concept

Regroupe les enregistrements en fonction des valeurs identiques d'un ou plusieurs champs caractères, numériques ou DateHeure. Compte le nombre d'enregistrements dans chaque groupe et calcule également le sous-total des champs numériques spécifiés pour chaque groupe.

Syntaxe

SUMMARIZE {ON champ_clé <...n>|ON ALL <EXCLUDE nom_champ <...n>>} <SUBTOTAL champ_numérique <...n>|SUBTOTAL ALL <EXCLUDE champ_numérique <...n>>> <OTHER champ <...n>|OTHER ALL <EXCLUDE nom_champ <...n>>> <TO {SCREEN|nom_table|PRINT}> <LOCAL> <IF test> <WHILE test> <FIRST plage|NEXT plage> <PRESORT> <APPEND> <OPEN> <HEADER texte_en_tête> <FOOTER texte_pied_page> <STATISTICS> <MODMEDQ> <STDEV> <CPERCENT> <ISOLOCALE code_paramètres_régionaux>

Paramètres

Nom	Description
ON champ_clé <...n>\| ON ALL	Un ou plusieurs champs caractères, numériques ou DateHeure à totaliser. ON champ_cléUtilisez le(s) champ(s) spécifié(s) Les champs multiples doivent être séparés par des espaces et il peut s'agir de différents types de données. Si vous calculez un sous-total en fonction de plusieurs champs, les champs sont sous-totalisés dans l'ordre dans lequel vous les faites figurer dans la liste. Si vous spécifiez PRESORT, le tri imbriqué de la table de sortie suit le même ordre. ON ALLUtilisez tous les champs dans la table Si vous effectuez un sous-total de tous les champs, les champs sont sous-totalisés dans l'ordre dans lequel ils apparaissent dans le format de table. Si vous spécifiez PRESORT, le tri imbriqué de la table de sortie suit le même ordre.
EXCLUDE nom_champ facultatif	Valide uniquement dans le cas d'une sous-totalisation à l'aide de ON ALL. Le ou les champs à exclure de la commande. EXCLUDE vous permet de personnaliser ON ALL, en excluant les champs spécifiés. EXCLUDE doit suivre immédiatement ON ALL. Par exemple : ON ALL EXCLUDE champ_1 champ_2
SUBTOTAL champ_numérique <...n> \| SUBTOTAL ALL facultatif	Un ou plusieurs champs ou expressions numériques à sous-totaliser pour chaque groupe. Les champs multiples doivent être séparés par des espaces. Indiquez ALL pour calculer le sous-total de tous les champs numériques de la table.
EXCLUDE champ_numérique facultatif	Valide uniquement lors de l'utilisation de SUBTOTAL ALL. Le ou les champs à exclure de la commande. EXCLUDE vous permet de personnaliser SUBTOTAL ALL, en excluant les champs spécifiés. EXCLUDE doit suivre immédiatement SUBTOTAL ALL. Par exemple : SUBTOTAL ALL EXCLUDE champ_1 champ_2
AUTRE champ <...n> \| OTHER ALL facultatif	Un ou plusieurs champs supplémentaires à inclure dans la sortie. OTHER champ <...n>Incluez le(s) champ(s) spécifié(s) OTHER ALLIncluez tous les champs de la table qui ne sont pas spécifiés comme champs clés ou comme champs de sous-total Utilisez OTHER uniquement avec des champs contenant la même valeur pour tous les enregistrements dans chaque groupe totalisé. Si vous spécifiez un champ qui contient des valeurs différentes pour un groupe totalisé, seule la valeur pour le premier enregistrement du groupe s'affiche, ce qui n'est pas judicieux. Par exemple : Totalisez une table par numéro clientUn « autre champ » approprié peut être le nom du client. En général, le nom du client est identique pour tous les enregistrements avec le même numéro client. Totalisez une table Fournisseur par étatUn « autre champ » approprié peut être Ville. Seule la première ville indiquée pour chaque état apparaît dans la sortie. Dans cet exemple, la meilleure méthode consiste à effectuer la totalisation avec les champs clés état et ville, dans cet ordre.
EXCLUDE nom_champ facultatif	Valide uniquement lors de l'utilisation de OTHER ALL. Le ou les champs à exclure de la commande. EXCLUDE vous permet de personnaliser OTHER ALL, en excluant les champs spécifiés. EXCLUDE doit suivre immédiatement OTHER ALL. Par exemple : OTHER ALL EXCLUDE champ_1 champ_2
TO SCREEN nom_table \| PRINT	Emplacement vers lequel envoyer les résultats de la commande : SCREENAffiche les résultats dans la zone d’affichage d’Analytics. Astuce Vous pouvez cliquer sur n'importe quelle valeur de résultat liée dans la zone d'affichage pour explorer jusqu'à l'enregistrement ou aux enregistrements associés dans la table source. nom_tableEnregistre les résultats dans une table Analytics Indiquez nom_table sous forme de chaîne entre guillemets avec une extension de fichier .FIL. Par exemple : TO "Output.FIL" Par défaut, le fichier de données de table (.FIL) est enregistré dans le dossier contenant le projet Analytics. Utilisez un chemin de fichier absolu ou relatif pour enregistrer le fichier de données dans un autre dossier existant : TO "C:\Output.FIL" TO "Results\Output.FIL" Note La longueur des noms des tables est limitée à 64 caractères alphanumériques, sans l'extension .FIL. Le nom peut inclure le caractère de soulignement ( _ ), mais aucun autre caractère spécial ni espace. Le nom ne peut pas commencer par un chiffre. PRINTEnvoie les résultats vers l’imprimante par défaut.
LOCAL facultatif	Enregistre le fichier de sortie au même emplacement que le projet Analytics. Note Applicable uniquement lorsque vous exécutez la commande sur une table de serveur avec un fichier de sortie qui est une table Analytics. Le paramètre LOCAL doit suivre immédiatement le paramètre TO.
IF test facultatif	Expression conditionnelle qui doit être vraie afin de traiter chaque enregistrement. La commande est exécutée uniquement sur les enregistrements remplissant la condition. Note La condition IF est évaluée uniquement par rapport aux enregistrements restant dans une table après application des options relevant du champ d'application (WHILE, FIRST, NEXT).
WHILE test facultatif	Expression conditionnelle qui doit être vraie afin de traiter chaque enregistrement. La commande est exécutée jusqu'à ce que la condition soit évaluée comme fausse ou lorsque la fin de la table est atteinte. Note Si vous utilisez WHILE conjointement avec FIRST ou NEXT, le traitement des enregistrements s'arrête dès qu'une limite est atteinte.
FIRST plage \| NEXT plage facultatif	Le nombre d'enregistrements à traiter : FIRSTPour commencer le traitement à partir du premier enregistrement jusqu’à ce que le nombre d’enregistrements spécifié soit atteint NEXTPour commencer le traitement à partir de l’enregistrement actuellement sélectionné jusqu’à ce que le nombre d’enregistrements spécifié soit atteint Utilisez plage pour indiquer le nombre d'enregistrements à traiter. Si vous ignorez FIRST et NEXT, tous les enregistrements sont traités par défaut.
PRESORT facultatif	Trie la table par le champ clé avant d'exécuter la commande. Note Vous ne pouvez pas utiliser PRESORT dans la commande GROUP. Si vous utilisez PRESORT Si vous utilisez l'option PRESORT, la sortie est triée et contient un seul groupe unique pour chaque jeu de valeurs identiques ou combinaison identique de valeurs dans le ou les champs clés. Astuce Si la table d'entrée est déjà triée, vous pouvez gagner du temps de traitement en évitant d'indiquer PRESORT. Si vous n'utilisez pas PRESORT Si vous n'utilisez pas la commande PRESORT, les résultats de sortie utilisent l'ordre de tri de la table d'entrée. Si le ou les champs clés contiennent des valeurs identiques non séquentielles, les résultats de sortie contiennent plusieurs groupes pour chaque jeu de valeurs identiques ou combinaison identique de valeurs. Note Plusieurs groupes pour chaque jeu de valeurs identiques ou combinaison identique de valeurs peuvent mettre en échec l'objet de la totalisation selon le contexte.
APPEND facultatif	Ajoute la sortie de commande à la fin d'un fichier existant au lieu de remplacer ce fichier. Note Vous devez vous assurer que la structure de la sortie de la commande et du fichier existant est identique : les mêmes champs le même ordre des champs les champs correspondants ont la même longueur les champs correspondants ont le même type de données Analytics ajoute la sortie à un fichier existant sans tenir compte de sa structure, ce qui peut désordonner les données si la structure de la sortie et du fichier existant ne correspond pas.
OUVRIR facultatif	Ouvre la table créée par la commande après l'exécution de la commande. Valide uniquement lorsque la commande crée une table de sortie.
HEADER texte_en-tête facultatif	Texte à insérer en haut de chaque page d'un rapport. texte_en-tête doit être indiqué sous forme de chaîne entre guillemets. La valeur remplace la variable système Analytics HEADER.
FOOTER texte_pied_page facultatif	Texte à insérer en bas de chaque page d'un rapport. texte_pied_page doit être indiqué sous forme de chaîne entre guillemets. La valeur remplace la variable système Analytics FOOTER.
STATISTICS facultatif	Note Ne peut pas être utilisée sauf si SUBTOTAL est également spécifié. Calcule les valeurs moyenne, minimale et maximale pour tous les champs SUBTOTAL.
MODMEDQ facultatif	Note Ne peut pas être utilisée sauf si SUBTOTAL est également spécifié. Calcule les valeurs du mode, de la médiane, du premier quartile et du troisième quartile pour tous les champs SUBTOTAL.
STDEV facultatif	Note Ne peut pas être utilisée sauf si SUBTOTAL est également spécifié. Calcule l'écart-type et le pourcentage des valeurs totales pour tous les champs SUBTOTAL.
CPERCENT facultatif	Calcule le pourcentage du compte d'enregistrements pour chaque groupe.
ISOLOCALE facultatif	Note Applicable dans l'édition Unicode d'Analytics uniquement. Paramètre système local au format langue_pays. Par exemple, pour utiliser le français canadien, saisissez fr_ca. Utilisez les codes suivants : LanguesCode linguistique de la norme ISO 639 PaysCode pays de la norme ISO 3166 Si vous n'indiquez pas de code pays, c'est le pays par défaut pour la langue qui est utilisé. Si vous n'utilisez pas ISOLOCALE, ce sont les paramètres système régionaux par défaut qui sont utilisés.

Exemples

Montant total des transactions par client

Vous totalisez une table Comptes clients en fonction du champ Numéro_client et sous-totalisez le champ Montant_trans. La sortie est regroupée par client et inclut le montant total des transactions pour chaque client :

OPEN Comptes_clients
SUMMARIZE ON Numéro_Client SUBTOTAL Montant_Trans TO "Total_Clients.FIL" PRESORT

Montant total des transactions par client par date de transaction

Vous totalisez une table Comptes clients en fonction des champs Numéro_Client et Date_Trans. Vous sous-totalisez le champ Montant_Trans.

La sortie est regroupée par client et, à l'intérieur de chaque client, par date. Elle inclut le montant total des transactions pour chaque client à chaque date à laquelle des transactions ont été effectuées.

OPEN Comptes_clients
SUMMARIZE ON Numéro_Client Date_Trans SUBTOTAL Montant_Trans TO "Total_client_par_date.FIL" PRESORT

Montants total, moyen, minimum et maximum des transactions par client par date de transaction

Vous ajoutez STATISTICS à l'exemple précédent.

En plus du montant des transactions sous-totalisées pour chaque client pour chaque date à laquelle des transactions ont été effectuées par le client, vous calculez également les montants moyen, minimum et maximum des transactions pour chaque client pour chaque date :

OPEN Comptes_clients
SUMMARIZE ON Numéro_Client Date_Trans SUBTOTAL Montant_Trans TO "Stats_client_par_date.FIL" PRESORT STATISTICS

Montants de transaction identiques, même date

Vous totalisez une table de transactions par carte de crédit sur les champs Date_trans et Montant_Trans.

La sortie est regroupée par date, et, à l'intérieur de chaque date, par montant. Vous pouvez utiliser le compte associé pour identifier les transactions ayant des montants identiques et des dates identiques :

OPEN Trans_CC
SUMMARIZE ON Date_Trans Montant_Trans TO "Transactions_par_date_montant.FIL" OPEN PRESORT
SET FILTER TO COUNT > 1

Remarques

Pour plus d'informations sur le fonctionnement de cette commande, consultez la section Totalisation des données.

Fonctionnement

SUMMARIZE regroupe les enregistrements comportant la même valeur dans un champ ou la même combinaison de valeurs dans plusieurs champs. Les résultats de sortie contiennent un seul enregistrement pour chaque groupe, avec le compte du nombre d'enregistrements de la table source inclus dans le groupe.

Sous-total et statistiques : calculs et noms des champs dans les résultats de sortie

Vous pouvez utiliser un ou plusieurs paramètres facultatifs pour effectuer des calculs statistiques sur n'importe quel champ SUBTOTAL que vous spécifiez. Les calculs statistiques sont décomposés par groupe dans la sortie :

Paramètre facultatif	Autre titre de la colonne (nom d'affichage) dans la table de sortie	Nom du champ dans la table de sortie	Calcul effectué sur le champ sous-totalisé
SUBTOTAL	Total + autre titre de la colonne sous-totalisé	nom du champ sous-totalisé	Valeurs sous-totalisées pour chaque groupe
STATISTICS	Moyenne + autre titre de la colonne sous-totalisé	a_nom du champ sous-totalisé	La valeur moyenne pour chaque groupe
	Minimum + autre titre de la colonne sous-totalisé	m_nom du champ sous-totalisé	La valeur minimale pour chaque groupe
	Maximum + autre titre de la colonne sous-totalisé	x_nom du champ sous-totalisé	La valeur maximale pour chaque groupe
MODMEDQ	Médiane + autre titre de la colonne sous-totalisé	c_nom du champ sous-totalisé	La valeur médiane pour chaque groupe Jeux de valeurs impaires : la valeur du milieu Jeux de valeurs paires : la moyenne des deux valeurs du milieu
	Mode + autre titre de la colonne sous-totalisé	o_nom du champ sous-totalisé	La valeur la plus fréquente pour chaque groupe Affiche « N/A » si aucune valeur n'apparaît plusieurs fois En cas d'égalité, affiche la valeur la plus faible
	Q25 + autre titre de la colonne sous-totalisé	q_nom du champ sous-totalisé	La valeur du premier quartile pour chaque groupe (valeur du quartile inférieur) Le résultat est une valeur interpolée calculée sur un algorithme Analytics Produit le même résultat que les fonctions QUARTILE et QUARTILE.INC dans Microsoft Excel
	Q75 + autre titre de la colonne sous-totalisé	p_nom du champ sous-totalisé	La valeur du troisième quartile pour chaque groupe (valeur du quartile supérieur) Le résultat est une valeur interpolée calculée sur un algorithme Analytics Produit le même résultat que les fonctions QUARTILE et QUARTILE.INC dans Microsoft Excel
STDEV	STDDEV + autre titre de la colonne sous-totalisé	d_nom du champ sous-totalisé	L'écart-type pour chaque groupe
STDEV	% Champ + autre titre de la colonne sous-totalisé	f_nom du champ sous-totalisé	Le sous-total de chaque groupe exprimé sous forme du pourcentage du total du champ
CPERCENT	Pourcentage du compte	COUNT_PERCENTAGE	Le pourcentage d'enregistrements de la table source qui appartiennent à chaque groupe Note N'exige pas de champ de sous-total