Comando SUMMARIZE

Agrupa os registros com base em valores idênticos em um ou mais campos de caracteres, numéricos ou datahora. Conta os registros em cada grupo e subtotaliza os campos numéricos especificados em cada grupo.

Sintaxe

SUMMARIZE ON campo_chave <...n> <SUBTOTAL campo_numérico <...n>|SUBTOTAL ALL> <OTHER campo <...n>|OTHER ALL> <TO {SCREEN|nome_tabela|PRINT}> <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo> <PRESORT> <APPEND> <OPEN> <LOCAL> <HEADER texto_cabeçalho> <FOOTER texto_rodapé> <STATISTICS> <MODMEDQ> <STDEV> <CPERCENT> <ISOLOCALE código_localidade>

Parâmetros

Nome	Descrição
ON campo_chave <...n>	Um ou mais campos de caracteres, numéricos ou datahora para serem sumarizados. Se houver mais de um campo, eles devem ser separados por espaços e podem ser de tipos de dados diferentes.
SUBTOTAL campo_numérico <...n> \| SUBTOTAL ALL opcional	Um ou mais campos numéricos ou expressões a serem subtotalizadas para cada grupo. Vários campos devem ser separados por espaço. Especifique ALL para subtotalizar todos os campos numéricos da tabela.
OTHER campo <...n> \| OTHER ALL opcional	Um ou mais campos adicionais a serem incluídos na saída. campo <...n> inclua o campo ou os campos especificados ALL inclua todos os campos da tabela que não são especificados como campos-chave ou de subtotal Use OTHER com campos que contêm o mesmo valor para todos os registros em cada grupo sumarizado. Se você especificar um campo que contém valores diferentes para um grupo sumarizado, apenas o valor do primeiro registro do grupo será exibido, o que não é útil. Por exemplo: sumarizar uma tabela por número do cliente um "outro campo" adequado poderia ser o nome do cliente. Normalmente, o nome do cliente é idêntico em todos os registros com o mesmo número do cliente. sumarizar uma tabela de fornecedores por estado um "outro campo" inadequado poderia ser Cidade. Apenas a primeira cidade listada para cada estado aparecerá no resultado. Nesse caso, a melhor abordagem é sumarizar tanto pelo campo estado como pelo campo cidade, nessa ordem.
TO SCREEN nome_tabela \| PRINT	A localização para onde enviar os resultados do comando: SCREEN exibe os resultados na área de exibição do Analytics nome_tabela salva os resultados em uma tabela do Analytics Especifique nome_tabela como uma cadeia entre aspas com uma extensão de arquivo .FIL. For exemplo: TO "Saída.FIL" Por padrão, o arquivo de dados da tabela (.fil) é salvo na pasta que contém o projeto do Analytics. Use um caminho de arquivo absoluto ou relativo para salvar o arquivo de dados em uma pasta diferente já existente: TO "C:\Saída.FIL" TO "Resultados\Saída.FIL" Nota Os nomes de tabela são limitados a 64 caracteres alfanuméricos, sem contar a extensão .FIL. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número. PRINT envia os resultados para a impressora padrão
IF teste opcional	Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado apenas nos registros que atendem à condição. Nota O parâmetro IF é avaliado apenas em relação aos registros restantes em uma tabela depois da aplicação dos parâmetros de escopo (WHILE, FIRST, NEXT).
WHILE teste opcional	Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado até que a condição seja avaliada como falsa ou o fim da tabela seja alcançado. Nota Se você usar WHILE juntamente com FIRST ou NEXT, o processamento de registros será interrompido assim que um limite for alcançado.
FIRST intervalo \| NEXT intervalo opcional	O número de registros a ser processado: FIRST iniciar o processamento a partir do primeiro registro até alcançar o número de registros especificado NEXT iniciar o processamento a partir do registro selecionado no momento até alcançar o número de registros especificado Use intervalo para especificar o número de registros a serem processados. Se você omitir FIRST e NEXT, todos os registros serão processados por padrão.
PRESORT opcional	Ordena a tabela pelo campo-chave antes de executar o comando. Nota Você não pode usar PRESORT dentro do comando GROUP. Se você usar PRESORT Se você usar PRESORT, a saída será classificada e conterá um único grupo para cada conjunto de valores idênticos ou combinações idênticas de valores em um ou mais campos-chave. Dica Se a tabela de entrada já estiver ordenada, você poderá economizar tempo de processamento não especificando PRESORT. Se você não usar PRESORT Se o PRESORT não for utilizado, os resultados de saída terão a mesma ordem de classificação da tabela de entrada. Caso o campo ou os campos-chave ou campos contenham valores não sequenciais idênticos, os resultados de saída conterão mais de um grupo para cada conjunto de valores idênticos ou combinações idênticas de valores. Nota Dependendo do contexto, a existência de mais de um grupo para cada conjunto de valores idênticos ou combinação de valores idênticos pode anular o propósito da sumarização.
APPEND opcional	Anexa a saída do comando ao final de um arquivo existente, em vez de sobrescrevê-lo. Nota Você deve garantir que a estrutura da saída do comando e o arquivo existente são idênticos: os mesmos campos a mesma ordem de campos os campos correspondentes têm o mesmo comprimento os campos correspondentes têm o mesmo tipo de dados O Analytics anexa a saída a um arquivo existente, seja qual for sua estrutura. Se a estrutura da saída e do arquivo existente não corresponderem, o resultado poderá ser dados misturados, ausentes ou incorretos.
OPEN opcional	Abre a tabela criada pelo comando após a execução do comando. Válido apenas se o comando criar uma tabela de saída.
LOCAL opcional	Salva o arquivo de saída no mesmo local que o projeto do Analytics. Nota Aplicável apenas na execução de um comando em uma tabela de servidor com um campo de saída que é uma tabela do Analytics.
HEADER texto_cabeçalho opcional	O texto a ser inserido na parte superior de cada página de um relatório. texto_cabeçalho deve ser especificado como uma cadeia entre aspas. O valor substitui a variável de sistema HEADER do Analytics.
FOOTER texto_rodapé opcional	O texto a ser inserido na parte inferior de cada página de um relatório. texto_rodapé deve ser especificado como uma cadeia entre aspas. O valor substitui a variável de sistema FOOTER do Analytics.
STATISTICS opcional	Nota Somente pode ser usado se SUBTOTAL também for especificado. Calcula valores médios, mínimos e máximos para todos os campos de SUBTOTAL.
MODMEDQ opcional	Nota Somente pode ser usado se SUBTOTAL também for especificado. Calcula valores de moda, mediana, primeiro quartil e terceiro quartil para todos os campos de SUBTOTAL.
STDEV opcional	Nota Somente pode ser usado se SUBTOTAL também for especificado. Calcula o desvio padrão e a porcentagem do total para todos os campos de SUBTOTAL.
CPERCENT opcional	Calcula a porcentagem da contagem de registros para cada grupo.
ISOLOCALE opcional	Nota Aplicável apenas à edição Unicode do Analytics. A localidade do sistema no formato idioma_país. Por exemplo, para usar francês canadense, insira fr_ca. Use os códigos a seguir: idioma código de idioma padrão ISO 639 país código de país padrão ISO 3166 Se você não especificar um código de país, será usado o país padrão do idioma. Se você não usar ISOLOCALE, a localidade do sistema padrão será usada.

Exemplos

Valor total de transações por cliente

Você sumariza uma tabela de contas a receber com base no campo Numero_Cliente e calcula o subtotal do campo Valor_Trans. A saída é agrupada por cliente e inclui o valor total de transações para cada cliente:

OPEN Ar
SUMMARIZE ON Numero_Cliente SUBTOTAL Valor_Trans TO "Total_cliente.FIL" PRESORT

Valor total de transações por cliente por data de transação

Sumarize uma tabela de contas a receber com base nos campos Numero_Cliente e Valor_Trans. Você calcula o subtotal do campo Valor_Trans.

A saída é agrupada por cliente e, em cada cliente, por data, incluindo o valor total das transações de cada cliente em cada data em que o cliente teve transações.

OPEN Ar
SUMMARIZE ON Numero_Cliente Data_Trans SUBTOTAL Valor_Trans TO "Total_cliente_por_data.FIL" PRESORT

Valor de transações total, médio, mínimo e máximo por cliente por data de transação

Adicione STATISTICS ao exemplo anterior.

Além do valor subtotalizado das transações de cada cliente em cada data em que o cliente teve transações, também serão calculados os valores médio, mínimo e máximo das transações de cada cliente em cada data:

OPEN Ar
SUMMARIZE ON Numero_Cliente Data_Trans SUBTOTAL Valor_Trans TO "Estats_clientes_por_data.FIL" PRESORT STATISTICS

Valores de transação idênticos, mesma data

Você sumariza uma tabela de transações de cartão de crédito com base nos campos Data_Trans e Valor_Trans.

A saída é agrupada por data e, dentro de data, por valor. Você pode usar a contagem associada para identificar transações com valores e datas idênticos:

OPEN CC_Trans
SUMMARIZE ON Data_Trans Valor_Trans TO "Transações_por_data_valor.FIL" OPEN PRESORT 
SET FILTER TO COUNT > 1

Observações

Nota

Para obter mais informações sobre o funcionamento desse comando, consulte a Ajuda do Analytics.

Como funciona?

SUMMARIZE agrupa registros com o mesmo valor, ou a mesma combinação de valores, em um ou mais campos de caracteres, numéricos ou datahora. A saída consiste em um único registro para cada grupo, com uma contagem do número de registros na tabela de origem que pertencem ao grupo.

Subtotal e estatísticas: cálculos e nomes de campos nos resultados de saída

Você pode usar um ou mais parâmetros opcionais para executar cálculos estatísticos em qualquer campo SUBTOTAL especificado. Os cálculos estatísticos são divididos por grupo na saída:

Parâmetro opcional	Título alternativo de coluna (nome de exibição) na tabela de saída	Nome do campo na tabela de saída	Cálculo executado em campo subtotalizado
SUBTOTAL	Total + título alternativo da coluna subtotalizada	nome do campo subtotalizado	Valores subtotalizados para cada grupo
STATISTICS	Média + título alternativo da coluna subtotalizada	a_nome do campo subtotalizado	Valor médio para cada grupo
	Mínimo + título alternativo da coluna subtotalizada	m_nome do campo subtotalizado	Valor mínimo para cada grupo
	Máximo + título alternativo da coluna subtotalizada	x_nome do campo subtotalizado	Valor máximo para cada grupo
MODMEDQ	Mediana + título alternativo da coluna subtotalizada	c_nome do campo subtotalizado	Valor de mediana para cada grupo Conjuntos ímpares de valores: o valor do meio Conjuntos pares de valores: a média dos dois valores do meio
	Moda + título alternativo da coluna subtotalizada	o_nome do campo subtotalizado	O valor que ocorre com maior frequência em cada grupo Exibe "N/A" se nenhum valor ocorrer mais de uma vez Em caso de valores que ocorrem o mesmo número de vezes, exibe o valor mais baixo
	Q25 + título alternativo da coluna subtotalizada	q_nome do campo subtotalizado	O valor do primeiro quartil para cada grupo (valor do quartil inferior) O resultado é um valor interpolado com base em um algoritmo do Analytics Gera o mesmo resultado que as funções QUARTILE e QUARTILE.INC no Microsoft Excel
	Q75 + título alternativo da coluna subtotalizada	p_nome do campo subtotalizado	O valor do terceiro quartil para cada grupo (valor do quartil superior) O resultado é um valor interpolado com base em um algoritmo do Analytics Gera o mesmo resultado que as funções QUARTILE e QUARTILE.INC no Microsoft Excel
STDEV	STDDEV + título alternativo da coluna subtotalizada	d_nome do campo subtotalizado	O desvio padrão para cada grupo
STDEV	Campo % + título alternativo da coluna subtotalizada	f_nome do campo subtotalizado	O subtotal de cada grupo, expresso como uma porcentagem do total do campo
CPERCENT	Porcentagem da contagem	COUNT_PERCENTAGE	A porcentagem de registros da tabela de origem que pertence a cada grupo Note Não exige um campo de subtotal

[ Voltar ao início ]

Guia de scripting do ACL 14.1