Documentation

Query PostgreSQL

To query PostgreSQL with Flux:

  1. Import the sql package.

  2. Use sql.from() and provide the following parameters:

    • driverName: postgres
    • dataSourceName: See data source name
    • query: PSQL query to execute
import "sql"

sql.from(
  driverName: "postgres",
  dataSourceName: "postgresql://username:password@localhost:5432",
  query: "SELECT * FROM example_table"
)

PostgreSQL data source name

The postgres driver uses the following DSN syntax (also known as a connection string):

postgres://username:password@localhost:5432/dbname?param=value

PostgreSQL to Flux data type conversion

sql.from() converts PostgreSQL data types to Flux data types.

PostgreSQL data typeFlux data type
INT, BIGINT, SMALLINT, TINYINT, INT2, INT4, INT8, SERIAL2, SERIAL4, SERIAL8int
FLOAT4, FLOAT8float
DATE, TIME, TIMESTAMPtime
BOOLbool
TEXTstring

All other PostgreSQL data types are converted to strings.

Results structure

sql.from() returns a stream of tables with no grouping (all rows in a single table). For more information about table grouping, see Flux data model - Restructure tables.


Upgrade to InfluxDB Cloud or InfluxDB 2.0!

InfluxDB Cloud and InfluxDB OSS 2.0 ready for production.