https://github.com/grafana/xk6-sql-driver-sqlite3
xk6-sql driver extension for SQLite v3 database support
https://github.com/grafana/xk6-sql-driver-sqlite3
xk6 xk6-sql-driver
Last synced: 5 months ago
JSON representation
xk6-sql driver extension for SQLite v3 database support
- Host: GitHub
- URL: https://github.com/grafana/xk6-sql-driver-sqlite3
- Owner: grafana
- License: agpl-3.0
- Created: 2024-10-17T15:13:47.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-11-05T14:46:29.000Z (8 months ago)
- Last Synced: 2024-12-20T03:32:57.523Z (7 months ago)
- Topics: xk6, xk6-sql-driver
- Language: Go
- Homepage:
- Size: 33.2 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# xk6-sql-driver-sqlite3
Database driver extension for [xk6-sql](https://github.com/grafana/xk6-sql) k6 extension to support SQLite v3 database.
## Example
```JavaScript file=examples/example.js
import sql from "k6/x/sql";
import driver from "k6/x/sql/driver/sqlite3";
const db = sql.open(driver, "./test.db");
export function setup() {
db.exec(`
CREATE TABLE IF NOT EXISTS roster
(
id INTEGER PRIMARY KEY AUTOINCREMENT,
given_name VARCHAR NOT NULL,
family_name VARCHAR NOT NULL
);
`);
}
export function teardown() {
db.close();
}
export default function () {
let result = db.exec(`
INSERT INTO roster
(given_name, family_name)
VALUES
('Peter', 'Pan'),
('Wendy', 'Darling'),
('Tinker', 'Bell'),
('James', 'Hook');
`);
console.log(`${result.rowsAffected()} rows inserted`);
let rows = db.query("SELECT * FROM roster WHERE given_name = $1;", "Peter");
for (const row of rows) {
console.log(`${row.family_name}, ${row.given_name}`);
}
}
```
## Usage
Check the [xk6-sql documentation](https://github.com/grafana/xk6-sql) on how to use this database driver.
## Build
Since the sqlite3 driver uses a native shared library, the build requirements are slightly different from other drivers.
**Prerequisites**
- [Go toolchain](https://go101.org/article/go-toolchain.html)
- A build toolchain for your system that includes `gcc` or another C compiler. On Debian and derivatives install the `build-essential` package. On Windows you can use [tdm-gcc](https://jmeubank.github.io/tdm-gcc/). Make sure that `gcc` is in your `PATH`.
- Git
- Set `CGO_ENABLED=1` in the environment
**Linux**
```bash
CGO_ENABLED=1 xk6 build --with github.com/grafana/xk6-sql-driver-sqlite3@latest --with github.com/grafana/xk6-sql@latest
```
**Windows**
```
set CGO_ENABLED=1
xk6 build --with github.com/grafana/xk6-sql-driver-sqlite3@latest --with github.com/grafana/xk6-sql@latest
```