Documentation

count() function

count() returns the number of records in each input table.

The function counts both null and non-null records.

Empty tables

count() returns 0 for empty tables. To keep empty tables in your data, set the following parameters for the following functions:

FunctionParameter
filter()onEmpty: "keep"
window()createEmpty: true
aggregateWindow()createEmpty: true
Function type signature
(<-tables: stream[A], ?column: string) => stream[B] where A: Record, B: Record
  • Copy
  • Fill window

For more information, see Function type signatures.

Parameters

column

Column to count values in and store the total count.

tables

Input data. Default is piped-forward data (<-).

Examples

Count the number of records in each input table

import "sampledata"

sampledata.string()
    |> count()
  • Copy
  • Fill window

Count the number of records with a specific value

  1. Use filter() to filter data by the specific value you want to count.
  2. Use count() to count the number of rows in the table.
import "sampledata"

data =
    sampledata.int()
        |> filter(fn: (r) => r._value > 10)

data
    |> count()
  • Copy
  • Fill window

View example input and output


Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

Now Generally Available

InfluxDB 3 Core and Enterprise

Start fast. Scale faster.

Get the Updates

InfluxDB 3 Core is an open source, high-speed, recent-data engine that collects and processes data in real-time and persists it to local disk or object storage. InfluxDB 3 Enterprise builds on Core’s foundation, adding high availability, read replicas, enhanced security, and data compaction for faster queries and optimized storage. A free tier of InfluxDB 3 Enterprise is available for non-commercial at-home or hobbyist use.

For more information, check out: