81 lines
2.4 KiB
Markdown
81 lines
2.4 KiB
Markdown
---
|
|
title: Query SQLite
|
|
list_title: SQLite
|
|
description: >
|
|
Use [`sql.from()`](/flux/v0/stdlib/sql/from/) with the `sqlite3` driver to query SQLite.
|
|
menu:
|
|
flux_v0:
|
|
name: SQLite
|
|
parent: SQL databases
|
|
weight: 101
|
|
related:
|
|
- /flux/v0/stdlib/sql/from/
|
|
list_code_example: |
|
|
```js
|
|
import "sql"
|
|
|
|
sql.from(
|
|
driverName: "sqlite3",
|
|
dataSourceName: "file:/path/to/example.db?cache=shared&mode=ro",
|
|
query: "SELECT * FROM example_table",
|
|
)
|
|
```
|
|
---
|
|
|
|
To query [SQLite](https://www.sqlite.org/index.html) with Flux:
|
|
|
|
1. Import the [`sql` package](/flux/v0/stdlib/sql/).
|
|
2. Use [`sql.from()`](/flux/v0/stdlib/sql/from/) and provide the following parameters:
|
|
|
|
- **driverName**: sqlite3
|
|
- **dataSourceName**: _See [data source name](#sqlite-data-source-name)_
|
|
- **query**: SQL query to execute
|
|
|
|
```js
|
|
import "sql"
|
|
|
|
sql.from(
|
|
driverName: "sqlite3",
|
|
dataSourceName: "file:/path/to/example.db?cache=shared&mode=ro",
|
|
query: "SELECT * FROM example_table",
|
|
)
|
|
```
|
|
|
|
{{% note %}}
|
|
#### Requires file system access
|
|
To query SQLite, Flux must have access to the filesystem.
|
|
If Flux does not have access to the file system, the query will return an error
|
|
similar to one of the following:
|
|
|
|
- `Error: unable to open database file`
|
|
- `failed to read file: filesystem service is uninitialized`
|
|
- `An internal error has occurred`
|
|
|
|
If using **InfluxDB Cloud** or **InfluxDB OSS**, the Flux process **does not**
|
|
have access to the filesystem.
|
|
{{% /note %}}
|
|
|
|
---
|
|
|
|
## SQLite data source name
|
|
The `sqlite3` driver uses the following DSN syntax (also known as a **connection string**):
|
|
|
|
```
|
|
file:/path/to/example.db?param=value
|
|
```
|
|
|
|
## SQLite to Flux data type conversion
|
|
`sql.from()` converts SQLite data types to Flux data types.
|
|
|
|
| SQLite data type | Flux data type |
|
|
| :-------------------------------------- | :-------------------------------------------- |
|
|
| INT, INTEGER, BIGINT, SMALLINT, TINYINT | [int](/flux/v0/data-types/basic/int/) |
|
|
| FLOAT, DOUBLE | [float](/flux/v0/data-types/basic/float/) |
|
|
| DATETIME, TIMESTAMP, DATE | [time](/flux/v0/data-types/basic/time/) |
|
|
| BOOL | [int](/flux/v0/data-types/basic/int/) |
|
|
| TEXT | [string](/flux/v0/data-types/basic/string/) |
|
|
|
|
{{% caption %}}
|
|
All other SQLite data types are converted to strings.
|
|
{{% /caption %}}
|