docs-v2/content/flux/v0/write-data/sql/postgresql.md

2.1 KiB

title list_title description menu weight related list_code_example
Write to PostgreSQL PostgreSQL Use [`sql.to()`](/flux/v0/stdlib/sql/to/) with the `postgres` driver to write data to PostgreSQL.
flux_v0
name parent identifier
PostgreSQL write-to-sql write-postgres
101
/flux/v0/stdlib/sql/to/
```js import "sql" data |> sql.to( driverName: "postgres", dataSourceName: "postgresql://username:password@localhost:5432", table: "example_table" ) ```

To write data to PostgreSQL with Flux:

  1. Import the sql package.

  2. Pipe-forward data into sql.to() and provide the following parameters:

    • driverName: postgres
    • dataSourceName: See data source name
    • table: Table to write to
    • batchSize: Number of parameters or columns that can be queued within each call to Exec (default is 10000)
import "sql"
  
data
    |> sql.to(
        driverName: "postgres",
        dataSourceName: "postgresql://username:password@localhost:5432",
        table: "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

Flux to PostgreSQL data type conversion

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

Flux data type PostgreSQL data type
float FLOAT
int BIGINT
uint BIGINT
string TEXT
bool BOOL
time TIMESTAMP