Skip to content

Commit d480e1c

Browse files
authored
add a debugging section (#72)
Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
1 parent 8a41ee6 commit d480e1c

File tree

1 file changed

+21
-1
lines changed

1 file changed

+21
-1
lines changed

README.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,17 +60,21 @@ To run the extension code, simply start the shell with `./build/release/duckdb`.
6060
### Writing a file
6161

6262
To write a table to a vortex file use `COPY .. TO '...' (FORMAT VORTEX)`:
63+
6364
```sql
6465
COPY (SELECT * from generate_series(0, 4)) TO 'FILENAME.vortex' (FORMAT VORTEX);
6566
```
67+
6668
This will create a compressed vortex file from the sql table.
6769

6870
### Reading a file
6971

7072
To read a table from a vortex file:
73+
7174
```sql
7275
select * from read_vortex('FILENAME.vortex');
7376
```
77+
7478
This command also supports glob syntax e.g. `read_vortex('FILE_WITH_GLOB*.vortex')`.
7579

7680
## Running the tests
@@ -102,7 +106,7 @@ con = duckdb.connect(':memory:', config={'allow_unsigned_extensions': 'true'})
102106
NodeJS:
103107

104108
```js
105-
db = new duckdb.Database(':memory:', {"allow_unsigned_extensions": "true"});
109+
db = new duckdb.Database(":memory:", { allow_unsigned_extensions: "true" });
106110
```
107111

108112
Secondly, you will need to set the repository endpoint in DuckDB to the HTTP url of your bucket + version of the
@@ -125,3 +129,19 @@ INSTALL
125129
vortex_duckdb
126130
LOAD vortex_duckdb
127131
```
132+
133+
## Debugging
134+
135+
To build the extension in debug mode, run:
136+
137+
```sh
138+
make debug
139+
```
140+
141+
This will create debug binaries in the `./build/debug` directory, which can be used with a debugger for troubleshooting and development.
142+
143+
```sh
144+
./build/debug/duckdb -unsigned
145+
RUST_BACKTRACE=1 ./build/debug/duckdb -unsigned
146+
lldb -- ./build/debug/duckdb -unsigned
147+
```

0 commit comments

Comments
 (0)