Comando COUNT

Hace un recuento del número total de registros en la vista actual o solo de los registros que cumplen con la condición especificada.

Sintaxis

COUNT <IF prueba> <WHILE prueba> <FIRST rango|NEXT rango>

Parámetros

Nombre	Descripción
IF prueba opcional	Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta únicamente en los registros que cumplen la condición. Nota El parámetro IF se evalúa únicamente con los registros que quedan en la tabla después de aplicar los parámetros de alcance (WHILE, FIRST, NEXT).
WHILE prueba opcional	Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta hasta que la condición se evalúa como falsa o hasta que se llega al final de la tabla. Nota Si usa WHILE junto con FIRST o NEXT, el procesamiento de registros se detiene al llegar a un límite.
FIRST rango \| NEXT rango opcional	La cantidad de registros que se procesarán: FIRST comienza a procesar desde el primer registro hasta que se llega al número de registros especificado NEXT comienza a procesar desde el registro seleccionado actualmente hasta que se llega al número de registros especificado Utilice intervalo para especificar la cantidad de registros que se deben procesar. Si omite FIRST y NEXT, se procesan todos los registros de forma predeterminada.

Nombre

Descripción

IF prueba

opcional

Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta únicamente en los registros que cumplen la condición.

Nota

El parámetro IF se evalúa únicamente con los registros que quedan en la tabla después de aplicar los parámetros de alcance (WHILE, FIRST, NEXT).

WHILE prueba

opcional

Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta hasta que la condición se evalúa como falsa o hasta que se llega al final de la tabla.

Nota

Si usa WHILE junto con FIRST o NEXT, el procesamiento de registros se detiene al llegar a un límite.

FIRST rango | NEXT rango

opcional

La cantidad de registros que se procesarán:

FIRST comienza a procesar desde el primer registro hasta que se llega al número de registros especificado
NEXT comienza a procesar desde el registro seleccionado actualmente hasta que se llega al número de registros especificado

Utilice intervalo para especificar la cantidad de registros que se deben procesar.

Si omite FIRST y NEXT, se procesan todos los registros de forma predeterminada.

Variables de salida de Analytics

Nombre	Contiene
COUNTn	El conteo de registros calculado por el comando. Si el nombre de la variable es COUNT1, almacenará el conteo de registros del último comando ejecutado. Si el nombre de la variable es COUNTn donde n es mayor que 1, la variable almacenará el conteo de registros de un comando ejecutado dentro de un comando GROUP. El valor de n se asigna de acuerdo con el número de línea del comando dentro de GROUP. Por ejemplo, si el comando está una línea debajo del comando GROUP, se le asigna el valor COUNT2. Si el comando está cuatro líneas debajo del comando GROUP, se le asigna el valor COUNT5.

Nombre

Contiene

COUNTn

El conteo de registros calculado por el comando.

Si el nombre de la variable es COUNT1, almacenará el conteo de registros del último comando ejecutado.
Si el nombre de la variable es COUNTn donde n es mayor que 1, la variable almacenará el conteo de registros de un comando ejecutado dentro de un comando GROUP.
El valor de n se asigna de acuerdo con el número de línea del comando dentro de GROUP. Por ejemplo, si el comando está una línea debajo del comando GROUP, se le asigna el valor COUNT2. Si el comando está cuatro líneas debajo del comando GROUP, se le asigna el valor COUNT5.

Ejemplos

Almacenamiento de COUNT1

El resultado del comando COUNT se almacena en la variable de salida COUNT1. Puede recuperar y almacenar este valor en una variable definida por el usuario.

El comando COUNT sobrescribe la variable COUNT1 cada vez que se ejecuta, por lo que el valor se debe almacenar en una variable definida por el usuario antes de que el comando se ejecute por segunda vez después de la aplicación del filtro a la tabla:

OPEN DirecciónCliente 
COUNT 
TotalReg = COUNT1 
SET FILTER TO FechaModificación > ‘20100101‘ 
COUNT 
TotalRegFiltrados = COUNT1

Observaciones

Cuándo usar COUNT

Utilice el comando COUNT para contar el número de registros de una tabla de Analytics o para contar el número de registros que cumplen con una condición de prueba en particular. En caso de no especificarse ninguna prueba, aparece la cantidad total de registros de la tabla de Analytics.

De qué manera afectan los filtros a COUNT

Si se aplicó un filtro a una vista, el comando cuenta la cantidad de registros que quedan en la tabla una vez aplicada la condición de filtro.

[ Volver al inicio ]