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

InfluxDB 3 Core and Enterprise are now in Beta

InfluxDB 3 Core and Enterprise are now available for beta testing, available under MIT or Apache 2 license.

InfluxDB 3 Core is a high-speed, recent-data engine that collects and processes data in real-time, while persisting it to local disk or object storage. InfluxDB 3 Enterprise is a commercial product that builds on Core’s foundation, adding high availability, read replicas, enhanced security, and data compaction for faster queries. A free tier of InfluxDB 3 Enterprise will also be available for at-home, non-commercial use for hobbyists to get the full historical time series database set of capabilities.

For more information, check out: