chronon-backend-sql-common 0.1.4

Shared SQL SchedulerStore for SQLite and PostgreSQL
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# chronon-backend-sql-common

Shared SQL [`SchedulerStore`](https://docs.rs/chronon-core/latest/chronon_core/trait.SchedulerStore.html) for PostgreSQL and SQLite.

Adapter authors extending SQL persistence should use this crate. Application integrators should use the thin wrappers:

- [`chronon-backend-postgres`](../chronon-backend-postgres/README.md)
- [`chronon-backend-sqlite`](../chronon-backend-sqlite/README.md)

## Stack position

```text
chronon-backend-{postgres,sqlite} → chronon-backend-sql-common → chronon-core
```

## Entry points

| Symbol | Purpose |
|--------|---------|
| [`SqlSchedulerStore`] | Connect, schema bootstrap, full port implementation |
| [`SqlDialect`] / [`SqlPool`] | Engine selection |
| [`bind_sql`] | Rewrite `?` placeholders to `$1`, … for Postgres |
| [`validate_postgres_schema_name`] | Allowlist for isolated schema DDL / `search_path` / drop |
| [`delegate_scheduler_store!`] | Macro for thin wrapper crates |

## When to depend directly

- Building a new SQL dialect wrapper (mirror postgres/sqlite crates)
- Contributing to the shared schema or query modules

Do **not** depend on this crate from application binaries — use the public crate features (`sqlite`, `postgres`).

## Schema

Tables and indexes bootstrap on connect via [`ensure_schema`](https://docs.rs/chronon-backend-sql-common/latest/chronon_backend_sql_common/schema/fn.ensure_schema.html). No manual migration step in v0.1.1.

## Documentation

```bash
cargo doc -p chronon-backend-sql-common --no-deps --open
```

[`SqlSchedulerStore`]: https://docs.rs/chronon-backend-sql-common/latest/chronon_backend_sql_common/struct.SqlSchedulerStore.html
[`SqlDialect`]: https://docs.rs/chronon-backend-sql-common/latest/chronon_backend_sql_common/enum.SqlDialect.html
[`SqlPool`]: https://docs.rs/chronon-backend-sql-common/latest/chronon_backend_sql_common/enum.SqlPool.html
[`bind_sql`]: https://docs.rs/chronon-backend-sql-common/latest/chronon_backend_sql_common/fn.bind_sql.html
[`delegate_scheduler_store!`]: https://docs.rs/chronon-backend-sql-common/latest/chronon_backend_sql_common/macro.delegate_scheduler_store.html