content/flux/v0/query-data/sql/postgresql.md
To query PostgreSQL with Flux:
Import the sql package.
Use sql.from() and provide the following parameters:
import "sql"
sql.from(
driverName: "postgres",
dataSourceName: "postgresql://username:password@localhost:5432",
query: "SELECT * FROM example_table",
)
The postgres driver uses the following DSN syntax (also known as a connection string):
postgres://username:password@localhost:5432/dbname?param=value
sql.from() converts PostgreSQL data types to Flux data types.
| PostgreSQL data type | Flux data type |
|---|---|
| INT, BIGINT, SMALLINT, TINYINT, INT2, INT4, INT8, SERIAL2, SERIAL4, SERIAL8 | int |
| FLOAT4, FLOAT8 | float |
| DATE, TIME, TIMESTAMP | time |
| BOOL | bool |
| TEXT | string |
{{% caption %}} All other PostgreSQL data types are converted to strings. {{% /caption %}}