25 lines
1.2 KiB
Markdown
25 lines
1.2 KiB
Markdown
# alkstore-postgres
|
|
|
|
The Postgres engine of the [alkstore](https://git.alk.dev/alkdev/alkstore/blob/main/README.md)
|
|
family: the core contract implemented on tokio-postgres +
|
|
deadpool-postgres, natively async (no blocking bridge, no
|
|
`spawn_blocking` seam), with a hand-rolled LISTEN forwarder.
|
|
|
|
```rust
|
|
let store = alkstore_postgres::open(&dsn, alkstore_postgres::PgOpts::default()).await?;
|
|
```
|
|
|
|
**Engine posture — multi-host native.** Connections are per-process
|
|
state; nothing assumes a shared host. Connection budget: `max_size`
|
|
pooled connections **+ 1 non-pooled listener connection per LISTEN-ing
|
|
process** (pooled connections cannot carry LISTEN) — size the server
|
|
for the sum. v1 TLS is effectively unavailable: the engine hardwires
|
|
`NoTls` on every connection path, so network confidentiality must come
|
|
from the deployment topology. Queue/stream/lock/schedule tables live
|
|
in one engine-owned PostgreSQL schema (default `alkstore`,
|
|
per-engine option).
|
|
|
|
See the [family README](https://git.alk.dev/alkdev/alkstore/blob/main/README.md)
|
|
for the interface and the deployment matrix, and the
|
|
[Postgres engine spec](https://git.alk.dev/alkdev/alkstore/blob/main/docs/architecture/engine-postgres.md)
|
|
for the driver's details. |