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

2.2 KiB

title list_title description menu weight related list_code_example
Write to MariaDB MariaDB Use [`sql.to()`](/flux/v0/stdlib/sql/to/) with the `mysql` driver to write data to MariaDB.
flux_v0
name parent identifier
MariaDB write-to-sql write-mariadb
101
/flux/v0/stdlib/sql/to/
```js import "sql" data |> sql.to( driverName: "mysql", dataSourceName: "user:password@tcp(localhost:3306)/db", table: "example_table", ) ```

To write data to MariaDB with Flux:

  1. Import the sql package.

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

    • driverName: mysql
    • 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: "mysql",
        dataSourceName: "user:password@tcp(localhost:3306)/db",
        query: "SELECT * FROM example_table",
    )

MariaDB data source name

The mysql driver uses the following data source name (DSN) syntax (also known as a connection string):

username:password@tcp(localhost:3306)/dbname?param=value

Flux to MariaDB data type conversion

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

Flux data type MariaDB data type
float FLOAT
int BIGINT
uint BIGINT
string TEXT(16383)
bool BOOL (TINYINT)
time DATETIME

{{% note %}}

MariaDB BOOL types

BOOL is a synonym supplied by MariaDB for convenience. MariaDB stores BOOL values as TINYINT types so looking at the schema shows the column type as TINYINT. {{% /note %}}