Skip to content

Commit 0a312a0

Browse files
committed
tweak readme
1 parent f82a0b1 commit 0a312a0

1 file changed

Lines changed: 4 additions & 1 deletion

File tree

README.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,9 @@ A PostgreSQL extension that enforces optimal column alignment to minimize row pa
44

55
<img src="logo.jpg" alt="pg_column_tetris logo" width="230">
66

7+
- Warns on suboptimal `CREATE TABLE` statements during development
8+
- Enforces strict alignment in CI/CD pipelines
9+
- Audits existing tables and generates optimized migration scripts
710

811
## Why Column Order Matters
912

@@ -141,7 +144,7 @@ Use `check()` to inspect any table's current layout and see where padding is was
141144
SELECT * FROM column_tetris.check('orders');
142145
```
143146

144-
Use `suggest_rewrite()` to generate a complete migration script that reorders the columns optimally:
147+
Use `suggest_rewrite()` to generate a migration script that reorders the columns optimally. **Caution** - it renames the original table, creates a new one, and copies all data. This means exclusive locks, downtime for that table, and lost foreign keys/indexes/triggers/defaults that aren't part of the generated DDL. Always review the output and test on a copy first:
145148

146149
```sql
147150
SELECT column_tetris.suggest_rewrite('orders');

0 commit comments

Comments
 (0)