docs-v2/content/v2.0/reference/flux/stdlib/sql/from.md

1.5 KiB

title description aliases menu weight
sql.from() function The `sql.from()` function retrieves data from a SQL data source.
/v2.0/reference/flux/functions/sql/from/
v2_0_ref
name parent
sql.from SQL
202

The sql.from() function retrieves data from a SQL data source.

Function type: Input

import "sql"

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

Parameters

driverName

The driver used to connect to the SQL database.

Data type: String

The following drivers are available:

  • mysql
  • postgres

dataSourceName

The connection string used to connect to the SQL database. The string's form and structure depend on the driver used.

Data type: String

Driver dataSourceName examples
# Postgres Driver:
postgres://pqgotest:password@localhost/pqgotest?sslmode=verify-full

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

query

The query to run against the SQL database.

Data type: String

Examples

Query a MySQL database

import "sql"

sql.from(
 driverName: "mysql",
 dataSourceName: "user:password@tcp(localhost:3306)/db",
 query:"SELECT * FROM ExampleTable"
)

Query a Postgres database

import "sql"

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