PostgREST 9

Summary

PostgREST 9 introduces several core updates to the tool that turns PostgreSQL databases into RESTful APIs. Developers can now perform inner joins when embedding tables using the !inner keyword, allowing top-level table rows to be filtered directly by embedded table attributes across multiple operators. The release also adds support for POST requests to functions containing a single unnamed parameter, which simplifies handling raw JSON payloads sent by external webhooks. To ensure compatibility with PostgreSQL 14, custom authentication functions accessing HTTP context headers and JWT claims must be updated to parse JSON properties from consolidated settings. Additional enhancements included in this version provide support for partitioned tables alongside documentation improvements and bug fixes.

Takeaways

1. 1

   The !inner keyword allows filtering top-level table queries based on conditions applied to embedded tables across all Supabase client libraries.

2. 2

   PostgREST 9 supports POST requests to PostgreSQL functions with a single unnamed parameter, enabling direct ingestion of raw JSON webhook payloads.

3. 3

   PostgreSQL 14 compatibility requires custom authentication functions to read request.jwt.claims and request.headers as JSON objects rather than individual claim or header settings.