文档文档

查询 SQL 数据库

使用 sql.from() 通过 Flux 查询 SQL 数据库。

数据库

sql.from() 支持以下 SQL 数据库

驱动程序

sql.from() 使用 Go SQL 驱动程序Go sql 包 中连接到 SQL 数据库。以下驱动程序可用

  • awsathena
  • bigquery
  • hdb
  • mysql
  • postgres
  • snowflake
  • sqlite3
  • sqlserver
  • vertica, vertigo

数据源名称

每个 SQL 驱动程序 都支持唯一的数据源名称 (DSN) 语法(也称为连接字符串)。有关每个驱动程序的 DSN 信息,请参阅数据库指南

将敏感凭据存储为密钥

如果使用 InfluxDB CloudInfluxDB OSS 2.x,我们建议将 DSN 凭据存储为 InfluxDB 密钥。使用 secrets.get() 从 InfluxDB 密钥 API 检索密钥。

import "sql"
import "influxdata/influxdb/secrets"

username = secrets.get(key: "POSTGRES_USER")
password = secrets.get(key: "POSTGRES_PASS")

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

结果结构

sql.from() 返回一个 表流,没有分组(所有行都在单个表中)。有关表分组的更多信息,请参阅Flux 数据模型 - 重构表

列数据类型

每个 sql.from() 驱动程序 都将源数据库中的列数据类型转换为 Flux 数据类型有关数据类型转换的信息,请参阅数据库指南

给定 MySQL 数据库中的以下 example_table

example_table
IDNameAddressCountry
1Alfreds FutterkisteObere Str. 57Germany
2Ana Trujillo Emparedados y heladosAvda. de la Constitución 2222Mexico
3Antonio Moreno TaqueríaMataderos 2312Mexico
4Around the Horn120 Hanover Sq.UK
5Berglunds snabbköpBerguvsvägen 8Sweden
Flux 查询
import "sql"

sql.from(
    driverName: "mysql",
    dataSourceName: "username:passwOrd@tcp(localhost:3306)/db",
    query: "SELECT ID, Name FROM example_table",
)
输出
IDName
1Alfreds Futterkiste
2Ana Trujillo Emparedados y helados
3Antonio Moreno Taquería
4Around the Horn
5Berglunds snabbköp

此页是否对您有帮助?

感谢您的反馈!


Flux 的未来

Flux 即将进入维护模式。您可以继续像现在一样使用它,而无需对您的代码进行任何更改。

阅读更多

现已全面上市

InfluxDB 3 Core 和 Enterprise

启动快速。扩展更快。

获取更新

InfluxDB 3 Core 是一个开源、高速、最近数据引擎,可实时收集和处理数据,并将其持久保存到本地磁盘或对象存储。InfluxDB 3 Enterprise 以 Core 的基础为构建,增加了高可用性、读取副本、增强的安全性以及数据压缩,从而实现更快的查询和优化的存储。InfluxDB 3 Enterprise 的免费层可供非商业家庭或业余爱好者使用。

有关更多信息,请查看