Skip to content

Commit a4132f8

Browse files
authored
Document ICU extension limitations with bundled feature (#612)
2 parents 732226b + 92f1108 commit a4132f8

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

README.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -210,6 +210,16 @@ You can adjust this behavior in a number of ways:
210210
options. The default when using vcpkg is to dynamically link,
211211
which must be enabled by setting `VCPKGRS_DYNAMIC=1` environment variable before build.
212212

213+
### ICU extension and the bundled feature
214+
215+
When using the `bundled` feature, the ICU extension is not included due to crates.io's 10MB package size limit. This means some date/time operations (like `now() - interval '1 day'` or `ts::date` casts) will fail. You can load ICU at runtime:
216+
217+
```rust
218+
conn.execute_batch("INSTALL icu; LOAD icu;")?;
219+
```
220+
221+
Alternatively, link against libduckdb without the `bundled` feature (see build instructions above). The ICU extension will be built-in and pre-loaded in that case.
222+
213223
### Binding generation
214224

215225
We use [bindgen](https://crates.io/crates/bindgen) to generate the Rust

0 commit comments

Comments
 (0)