pg-workload 0.4.2__tar.gz → 0.5.0__tar.gz

{pg_workload-0.4.2/src/pg_workload.egg-info → pg_workload-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pg-workload
-Version: 0.4.2
+Version: 0.5.0
 Summary: PostgreSQL workload emulator for diagnostic and observability testing
 Author-email: O2eg <oleg.ispu@gmail.com>
 License-Expression: MIT
@@ -191,7 +191,11 @@ instead of `--passfile`; `PGPASSWORD` is accepted only as an admin-password comp
 `prepare-db --recreate` drops only the selected workload database after terminating its sessions;
 it does not drop the workload role.
 Unless `--extensions` is supplied, it creates both `pg_stat_statements` and
-`pg_buffercache`, matching the default pg_diag metric set used by pg_play.
+`pg_buffercache`, and also installs `pg_stat_kcache` and `pg_wait_sampling` when
+the server provides them. Managed `pg_stand` images include and preload the required
+libraries, and new databases inherit the extensions from `template1`. An explicit
+`--extensions` list replaces both default lists. Optional extension choices are
+included in the machine plan.
 
 ## Targets
 
@@ -236,8 +240,8 @@ Use `--bin-dir /path/to/postgresql/bin` when client binaries are outside
 
 No profile requires a dump, CSV file, or network download. The Pagila schema is redistributed
 under its upstream license; see `THIRD_PARTY_NOTICES.md`. Its rows are generated locally. The
-bundled `imdb` profile is an original, compact movie-domain model and does not contain Join Order
-Benchmark SQL or IMDB source data.
+bundled `imdb` profile contains a full synthetic 21-table movie-domain model, 38 analytical
+scripts, and 113 SELECT variants; it contains no IMDB source data.
 
 Every profile directory contains a `README.md` with the scenario description, its jobs, the
 pg_diag sections it is meant to exercise, and scale/observation guidance.
@@ -352,7 +356,7 @@ pg-workload run --profile simple_stock --pgbench-transactions 100
 |---|---|
 | `simple_stock` | 150,000 product groups; 1,000,000 SKUs; 1,000,000 stock rows |
 | `simple_stock_spec_symbols` | the same cardinalities with hostile and Unicode identifiers/values |
-| `imdb` | 10,000 companies; 100,000 people; 100,000 titles; 1,300,000 fact rows |
+| `imdb` | 21 tables; 10,000 companies; 100,000 people; 100,000 titles; ~2,000,000 related rows |
 | `pagila` | 600 customers; 1,000 films; 4,500 inventory; 16,000 rentals; 16,500 payments |
 | `queue_skip_locked` | 20,000 pending + 5,000 done queue tasks |
 | `jsonb_docs` | 50,000 JSONB documents |

{pg_workload-0.4.2 → pg_workload-0.5.0}/README.md

@@ -152,7 +152,11 @@ instead of `--passfile`; `PGPASSWORD` is accepted only as an admin-password comp
 `prepare-db --recreate` drops only the selected workload database after terminating its sessions;
 it does not drop the workload role.
 Unless `--extensions` is supplied, it creates both `pg_stat_statements` and
-`pg_buffercache`, matching the default pg_diag metric set used by pg_play.
+`pg_buffercache`, and also installs `pg_stat_kcache` and `pg_wait_sampling` when
+the server provides them. Managed `pg_stand` images include and preload the required
+libraries, and new databases inherit the extensions from `template1`. An explicit
+`--extensions` list replaces both default lists. Optional extension choices are
+included in the machine plan.
 
 ## Targets
 
@@ -197,8 +201,8 @@ Use `--bin-dir /path/to/postgresql/bin` when client binaries are outside
 
 No profile requires a dump, CSV file, or network download. The Pagila schema is redistributed
 under its upstream license; see `THIRD_PARTY_NOTICES.md`. Its rows are generated locally. The
-bundled `imdb` profile is an original, compact movie-domain model and does not contain Join Order
-Benchmark SQL or IMDB source data.
+bundled `imdb` profile contains a full synthetic 21-table movie-domain model, 38 analytical
+scripts, and 113 SELECT variants; it contains no IMDB source data.
 
 Every profile directory contains a `README.md` with the scenario description, its jobs, the
 pg_diag sections it is meant to exercise, and scale/observation guidance.
@@ -313,7 +317,7 @@ pg-workload run --profile simple_stock --pgbench-transactions 100
 |---|---|
 | `simple_stock` | 150,000 product groups; 1,000,000 SKUs; 1,000,000 stock rows |
 | `simple_stock_spec_symbols` | the same cardinalities with hostile and Unicode identifiers/values |
-| `imdb` | 10,000 companies; 100,000 people; 100,000 titles; 1,300,000 fact rows |
+| `imdb` | 21 tables; 10,000 companies; 100,000 people; 100,000 titles; ~2,000,000 related rows |
 | `pagila` | 600 customers; 1,000 films; 4,500 inventory; 16,000 rentals; 16,500 payments |
 | `queue_skip_locked` | 20,000 pending + 5,000 done queue tasks |
 | `jsonb_docs` | 50,000 JSONB documents |

{pg_workload-0.4.2 → pg_workload-0.5.0}/THIRD_PARTY_NOTICES.md

@@ -27,11 +27,9 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
-## Join Order Benchmark and source IMDB data
-
-The original development workspace may contain local Join Order Benchmark SQL
-and source IMDB data. They are deliberately excluded from the source
-distribution and wheel because the upstream repository does not publish an
-explicit license. The bundled profile named `imdb` is an independent synthetic
-movie-domain schema, generator, and workload; it does not contain or derive from
-those excluded files.
+## Synthetic movie-domain workload
+
+The bundled `imdb` profile includes SQL query shapes migrated and adapted from
+the predecessor `pg_workload_generator` implementation. Its data generator is
+local and deterministic. No source IMDB dataset, CSV archive, or downloaded row
+data is included in the source distribution or wheel.

{pg_workload-0.4.2 → pg_workload-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pg-workload"
-version = "0.4.2"
+version = "0.5.0"
 description = "PostgreSQL workload emulator for diagnostic and observability testing"
 readme = "README.md"
 requires-python = ">=3.10"

{pg_workload-0.4.2 → pg_workload-0.5.0}/src/pg_workload/__init__.py

@@ -1,6 +1,6 @@
 """PostgreSQL workload generation and scheduling tools."""
 
-__version__ = "0.4.2"
+__version__ = "0.5.0"
 
 from pg_workload.assets import bundled_profiles_root, initialize_project
 from pg_workload.cli import build_parser

pg_workload-0.5.0/src/pg_workload/bundled/profiles/imdb/README.md

@@ -0,0 +1,43 @@
+# imdb
+
+Analytical read-only workload over a synthetic movie-domain model: multi-way joins,
+aggregations, selective lookups, correlated subgraphs, and skewed popularity distributions.
+It is a workload generator rather than a benchmark: the goal is to keep PostgreSQL busy and
+produce varied plans and statistics for `auto_explain`, `pg_stat_statements`, and DBA tooling.
+No IMDB source rows, CSV files, archives, or network downloads are required.
+
+## Objects (at scale 1)
+
+- The full 21-table relational shape used by the earlier profile, including alternate names and
+  titles, characters, company and role types, complete-cast metadata, indexed movie attributes,
+  person information, and movie links.
+- 10,000 companies; 100,000 people; 50,000 characters; 20,000 keywords; 100,000 titles; and about
+  2 million fact, relationship, and attribute rows.
+- Deterministic synthetic anchor rows cover the names, years, countries, notes, roles, keywords,
+  genres, ratings, and link types selected by every bundled query family.
+- Foreign-key/join-column and selective-filter indexes are created after loading, followed by
+  `ANALYZE` for all 21 tables.
+
+## Jobs
+
+| Job | Type | Interval | What it does |
+|---|---|---|---|
+| `analytical_selects` | pgbench | 60 s | 38 scripts and 113 SELECT variants: five compact analytics plus 33 multi-join families |
+
+The `select_1.sql` through `select_33.sql` files retain the diverse join shapes of the previous
+implementation. Their predicates target values deliberately generated by `generator.py`, so the
+aggregate results describe existing synthetic rows instead of repeatedly exercising empty joins.
+
+## What to watch in pg_diag
+
+- `sql_workload` — top statements by total/mean time with real join plans
+- `object_workload` — sequential vs index scan split on fact tables
+- `buffer_cache` — relation caching behaviour under repeated analytical reads
+- `snapshot_charts_db` — read I/O rates during the observation window
+
+## Recommended scale and observation window
+
+- Scale 1 for meaningful planning; scale 0.1 still keeps join selectivity sensible. Very small
+  scales retain the complete anchor dataset and at least 1,000 titles for CI and training.
+- 5–10 minutes of scheduled runs; analytical queries dominate `pg_stat_statements`
+  quickly because the job interval is 60 s.