Skip to content

Commit 96f111d

Browse files
committed
docs(ext-driver-duckdb): update readme and dev warning
1 parent 342d71a commit 96f111d

File tree

3 files changed

+24
-6
lines changed

3 files changed

+24
-6
lines changed
+20-5
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,26 @@
11
# extension-driver-duckdb
22

3-
This library was generated with [Nx](https://nx.dev).
3+
[Duckdb](https://duckdb.org/) driver for Vulcan SQL
44

5-
## Building
5+
## Install
66

7-
Run `nx build extension-driver-duckdb` to build the library.
7+
1. Install package
88

9-
## Running unit tests
9+
```sql
10+
npm i @vulcan-sql/extension-driver-duckdb
11+
```
1012

11-
Run `nx test extension-driver-duckdb` to execute the unit tests via [Jest](https://jestjs.io).
13+
2. Update `vulcan.yaml`
14+
15+
```yaml
16+
extensions:
17+
duckdb: '@vulcan-sql/extension-driver-duckdb'
18+
19+
duckdb:
20+
# Optional: Path to your persistent DB, if this value is not set, we use in-memory database. (default: ":memory:")
21+
persistent-path: 'path-to-a-folder'
22+
# Optional: Whether log query requests (default: false)
23+
log-queries: false
24+
# Optional: Whether log query requests' parameters, please be aware that query parameters might contain sensitive data (default: false)
25+
log-parameters: false
26+
```

packages/extension-driver-duckdb/package.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@vulcan-sql/extension-driver-duckdb",
3-
"description": "duckbe driver for Vulcan SQL",
3+
"description": "duckdb driver for Vulcan SQL",
44
"version": "0.1.0-alpha.1",
55
"type": "commonjs",
66
"publishConfig": {

packages/extension-driver-duckdb/src/lib/duckdbDataSource.ts

+3
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,9 @@ export interface DuckDBOptions {
2929
'log-parameters'?: boolean;
3030
}
3131

32+
/// NOTICE: We're using the dev version of duckdb nodejs client for stream data support
33+
/// It might contain some issues.
34+
3235
@VulcanExtensionId('duckdb')
3336
export class DuckDBDataSource extends DataSource<DuckDBOptions> {
3437
private db: duckdb.Database;

0 commit comments

Comments
 (0)