COUNT aggregate function

The schema is SYSIBM.

The COUNT function returns the number of rows or values in a set of rows or values.

If DISTINCT is specified, the resulting data type of expression cannot be a BLOB, CLOB, DBCLOB, XML, distinct type on any of these types, or structured type (SQLSTATE 42907). Otherwise the result data type of expression can be any data type.

The result of the function is a large integer. The result cannot be null.

The argument of COUNT(*) is a set of rows. The result is the number of rows in the set. A row that includes only null values is included in the count.

The argument of COUNT(DISTINCT expression) is a set of values. The function is applied to the set of values derived from the argument values by the elimination of null and duplicate values. The result is the number of different non-null values in the set.

The argument of COUNT(expression) or COUNT(ALL expression) is a set of values. The function is applied to the set of values derived from the argument values by the elimination of null values. The result is the number of non-null values in the set, including duplicates.

Examples:

• Using the EMPLOYEE table, set the host variable FEMALE (int) to the number of rows where the value of the SEX column is 'F'.

     SELECT COUNT(*)
       INTO :FEMALE
       FROM EMPLOYEE
       WHERE SEX = 'F'

  Results in FEMALE being set to 13 when using the sample table.

• Using the EMPLOYEE table, set the host variable FEMALE_IN_DEPT (int) to the number of departments (WORKDEPT) that have at least one female as a member.

     SELECT COUNT(DISTINCT WORKDEPT)
       INTO :FEMALE_IN_DEPT
       FROM EMPLOYEE
       WHERE SEX = 'F'

  Results in FEMALE_IN_DEPT being set to 5 when using the sample table. (There is at least one female in departments A00, C01, D11, D21, and E11.)