pg_parcel
| Crates.io | pg_parcel |
| lib.rs | pg_parcel |
| version | 1.2.0 |
| source | src |
| created_at | 2022-03-08 19:22:22.124459 |
| updated_at | 2023-11-02 11:28:44.877674 |
| description | A very minimal subset of `pg_dump --data-only` with multi-tenancy in mind. |
| homepage | |
| repository | https://github.com/vendrinc/pg_parcel |
| max_upload_size | |
| id | 546552 |
| size | 90,392 |
Jacob Elder (jelder)
documentation
README
pg_parcel
A very minimal subset of pg_dump --data-only with multi-tenancy in mind. A solution to: https://postgrespro.com/list/thread-id/1715772
Most options are specified via config file.
column_name = "customer_id"
schema_name = "public"
database_url = "postgres://localhost:15432/postgres"
features = ["currency", "audit"]
skip_tables = [
"_backup$",
"^obsolete_"
# ... more regular expressions
]
[overrides]
# We only want the one customer identified by --id on the command line
customers = """
select * from customers where id in :ids
"""
# The `user_files` table doesn't have a customer_id column, so we need to join.
user_files = """
select user_files.*
from users_files
join users on users.id = user_files.user_id
where users.customer_id in :ids
"""
daily_exchange_rates = """
select * from daily_exchange_rates
where 'currency' = any (current_setting('pg_parcel.features')::text[])
"""
audit_log = """
select * from audit_log
where customer_id in :ids and
(
ARRAY['audit'] && (current_setting('pg_parcel.features')::text[])
or created_at >= NOW() - INTERVAL '30 days'
or updated_at >= NOW() - INTERVAL '30 days'
);
"""
| Session Variable | Contains |
|---|---|
pg_parcel.ids |
The list of all values passed with --id |
pg_parcel.features |
The list of features defined in the pg_parcel.toml file, minus any features turned off with --no-feature. If --features is set, they take precedence over the config file, but --no-features is final. |
pg_partial.feature.myfeature |
Same rules as pg_parcel.features, but one variable per setting. The value is just true Override queries can still use IN :ids but session variables are now preferred. |
Demo
Releases
We publish binaries for both Linux x86_64 (any distro, using musl) and macOS Universal (both Intel and Apple Silicon in a single binary).
To create a new release, update Cargo.toml and create a tag like v1.2.3 (SemVer, prefixed with v).
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.