# pg_grpc

> PostgreSQL extension (Postgres 13–18) for making unary gRPC calls directly from SQL — no sidecar, no codegen, no application layer. Built with Rust and pgrx. Alpha: API may change, streaming not yet supported, proto registry and channel cache are per-backend-process.

## Documentation

- [Introduction](https://csenshi.github.io/pg_grpc/introduction) — What pg_grpc is, how it works (architecture diagram), and current limitations
- [Installation](https://csenshi.github.io/pg_grpc/installation) — Install from source (cargo-pgrx), pre-built .deb packages, or Docker
- [Quickstart](https://csenshi.github.io/pg_grpc/quickstart) — Make your first gRPC call in minutes (reflection path and user-supplied proto path)
- [Reference](https://csenshi.github.io/pg_grpc/reference) — All SQL functions with full signatures, options blob, metadata blob, and error prefixes
- [TLS & mTLS Guide](https://csenshi.github.io/pg_grpc/guides/tls-and-mtls) — Plaintext, OS-trust-store TLS, private CA, mutual TLS, and SNI override
- [User-supplied protos Guide](https://csenshi.github.io/pg_grpc/guides/user-supplied-protos) — Stage and compile .proto files when server reflection is unavailable
- [Large messages Guide](https://csenshi.github.io/pg_grpc/guides/large-messages) — Raising decode and encode size limits