Skip to content

Expose relational synthesis API on top-level dpsynth and strengthen MultiTableConfig eager validation. - #148

Open
copybara-service[bot] wants to merge 1 commit into
mainfrom
cl/967438848
Open

Expose relational synthesis API on top-level dpsynth and strengthen MultiTableConfig eager validation.#148
copybara-service[bot] wants to merge 1 commit into
mainfrom
cl/967438848

Conversation

@copybara-service

Copy link
Copy Markdown

Expose relational synthesis API on top-level dpsynth and strengthen MultiTableConfig eager validation.

  • Public API Packaging:

    • Export essential multi-table relational synthesis constructs (MultiTableConfig, MultiTableMechanism, MultiDataGenerationResult, ForeignKeyRelation) directly on dpsynth and dpsynth.relational.
    • Update dependencies.
  • Eager MultiTableConfig.post_init Validation:

    • Make foreign_keys a required argument with no default (= () removed).
    • Enforce naming constraints: reject table/column names containing '.' and reserved keywords ('group_size', 'slot_*').
    • Enforce schema invariants: reject empty table schemas and ensure all attributes are instances of NumericalAttribute, CategoricalAttribute, or OpenSetCategoricalAttribute.
    • Validate DAG hierarchy eagerly via topological_sort_hierarchy to immediately reject cycles, self-loops, multiple parents (in-degree > 1), and multi-root forests.
    • Enforce strict separation between relational key columns (PK/FK) and statistical domain schemas.
    • Validate custom initializer mappings (if provided) against domain tables and columns.
    • Enforce open interval hyperparameter bounds (0.0 < init_budget_fraction < 1.0).
  • Testing:

    • Add unit tests for public module exports in synthesizer_test.py.
    • Add parameterized subtests covering all eager MultiTableConfig.__post_init__ validation failures.

…ultiTableConfig eager validation.

- Public API Packaging:
  * Export essential multi-table relational synthesis constructs (`MultiTableConfig`, `MultiTableMechanism`, `MultiDataGenerationResult`, `ForeignKeyRelation`) directly on `dpsynth` and `dpsynth.relational`.
  * Update dependencies.

- Eager MultiTableConfig.__post_init__ Validation:
  * Make `foreign_keys` a required argument with no default (`= ()` removed).
  * Enforce naming constraints: reject table/column names containing '.' and reserved keywords ('group_size', 'slot_*').
  * Enforce schema invariants: reject empty table schemas and ensure all attributes are instances of NumericalAttribute, CategoricalAttribute, or OpenSetCategoricalAttribute.
  * Validate DAG hierarchy eagerly via `topological_sort_hierarchy` to immediately reject cycles, self-loops, multiple parents (in-degree > 1), and multi-root forests.
  * Enforce strict separation between relational key columns (PK/FK) and statistical domain schemas.
  * Validate custom initializer mappings (if provided) against domain tables and columns.
  * Enforce open interval hyperparameter bounds (0.0 < init_budget_fraction < 1.0).

- Testing:
  * Add unit tests for public module exports in `synthesizer_test.py`.
  * Add parameterized subtests covering all eager `MultiTableConfig.__post_init__` validation failures.

PiperOrigin-RevId: 967438848
@google-cla

google-cla Bot commented Aug 19, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants