Skip to content

Commit 9d07d13

Browse files
Update raw tables documentation (#203)
* Update raw tables documentation to remove mention of using raw tables for advanced SQLite features * Add warning about advanced SQLite features in raw tables documentation --------- Co-authored-by: Kobie Botha <[email protected]>
1 parent e27d597 commit 9d07d13

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

usage/use-case-examples/raw-tables.mdx

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,12 +33,15 @@ Also note that raw tables are only supported by the new [Rust-based sync client]
3333

3434
Consider raw tables when you need:
3535

36-
- **Advanced SQLite features** like `FOREIGN KEY` and `ON DELETE CASCADE` constraints
3736
- **Indexes** - PowerSync's default schema has basic support for indexes on columns, while raw tables give you complete control to create indexes on expressions, use `GENERATED` columns, etc
3837
- **Improved performance** for complex queries (e.g., `SELECT SUM(value) FROM transactions`) - raw tables more efficiently get these values directly from the SQLite column, instead of extracting the value from the JSON object on every row
3938
- **Reduced storage overhead** - eliminate JSON object overhead for each row in `ps_data__<table>.data` column
4039
- **To manually create tables** - Sometimes you need full control over table creation, for example when implementing custom triggers
4140

41+
<Warning>
42+
**Advanced SQLite features** like `FOREIGN KEY` and `ON DELETE CASCADE` constraints may need special handling. If your use case requires these features, please reach out to us for guidance and potential workarounds.
43+
</Warning>
44+
4245
## How Raw Tables Work
4346

4447
### Current JSON-Based System

0 commit comments

Comments
 (0)