COUNTAIF Function
Generates the count of non-null values for rows in each group that meet a specific condition.
注記
When added to a transformation, this function is applied to the current sample. If you change your sample or run the job, the computed values for this function are updated. Transformations that change the number of rows in subsequent recipe steps do not affect the values computed for this step.
To perform a simple counting of non-nulls without conditionals, use the COUNTA function. See COUNTA Function.
Wrangle vs. SQL: This function is part of Wrangle, a proprietary data transformation language. Wrangle is not SQL. For more information, see Wrangle Language.
Basic Usage
countaif(entries, entryValidation == 'Ok')
Output: Returns the count of non-null values in the entries column when the entryValidation value is 'Ok'.
Syntax and Arguments
countaif(col_ref, test_expression) [group:group_col_ref] [limit:limit_count]
Argument | Required? | Data Type | Description |
|---|---|---|---|
col_ref | Y | string | Reference to the column you wish to evaluate. |
test_expression | Y | string | Expression that is evaluated. Must resolve to |
For more information on syntax standards, see Language Documentation Syntax Notes.
For more information on the group parameter, see Pivot Transform.
col_ref
Name of the column whose values you wish to use in the calculation. Column must be a numeric (Integer or Decimal) type.
Usage Notes:
Required? | Data Type | Example Value |
|---|---|---|
Yes | String that corresponds to the name of the column | myValues |
test_expression
This parameter contains the expression to evaluate. This expression must resolve to a Boolean (true or false) value.
Usage Notes:
Required? | Data Type | Example Value |
|---|---|---|
Yes | String expression that evaluates to | (LastName == 'Mouse' && FirstName == 'Mickey') |
Examples
ヒント
For additional examples, see Common Tasks.
Example - COUNTIF Functions
This example demonstrates how to count the number of values within a group, based on a specified conditional test.
Functions:
Item | Description |
|---|---|
COUNTIF Function | Generates the count of rows in each group that meet a specific condition. Generated value is of Integer type. |
COUNTAIF Function | Generates the count of non-null values for rows in each group that meet a specific condition. |
Source:
The following data identifies sales figures by salespeople for a week:
EmployeeId | Date | Sales |
|---|---|---|
S001 | 1/23/17 | 25 |
S002 | 1/23/17 | 40 |
S003 | 1/23/17 | 48 |
S001 | 1/24/17 | 81 |
S002 | 1/24/17 | 11 |
S003 | 1/24/17 | 25 |
S001 | 1/25/17 | 9 |
S002 | 1/25/17 | 40 |
S003 | 1/25/17 | |
S001 | 1/26/17 | 77 |
S002 | 1/26/17 | 83 |
S003 | 1/26/17 | |
S001 | 1/27/17 | 17 |
S002 | 1/27/17 | 71 |
S003 | 1/27/17 | 29 |
S001 | 1/28/17 | |
S002 | 1/28/17 | |
S003 | 1/28/17 | 14 |
S001 | 1/29/17 | 2 |
S002 | 1/29/17 | 7 |
S003 | 1/29/17 | 99 |
Transformation:
You are interested in the count of dates during the week when each salesperson sold less than 50 units, not factoring the weekend. First, you try the following:
Transformation Name | |
|---|---|
Parameter: Row labels | EmployeeId |
Parameter: Values | COUNTIF(Sales < 50) |
Parameter: Max columns to create | 1 |
You notice, however, that the blank values, when employees were sick or had vacation, are being counted. Additionally, this step does not filter out the weekend. You must identify the weekend days using the WEEKDAY function:
Transformation Name | |
|---|---|
Parameter: Formula type | Single row formula |
Parameter: Formula | WEEKDAY(Date) |
Parameter: New column name | 'DayOfWeek' |
If DayOfWeek > 5, then it is a weekend date. For further precision, you can use the COUNTAIF function to remove the nulls:
Transformation Name | |
|---|---|
Parameter: Row labels | EmployeeId |
Parameter: Values | COUNTAIF(Sales, DayOfWeek<6) |
Parameter: Max columns to create | 1 |
The above counts the non-null values in Sales when the day of the week is not a weekend day, as grouped by individual employee.
Results:
EmployeeId | countaif_Sales |
|---|---|
S001 | 5 |
S002 | 4 |
S003 | 4 |