catalog union
Union two-or-more catalog entries into a new cataloged entry.
Resolves all entries to expressions, unions them (they must share an identical schema), builds the result, and registers it in the catalog.
Usage
xorq catalog union [ENTRIES]... [OPTIONS]Arguments
ENTRIES—Two or more entries (names or aliases) to union.
Options
| Option | Default | Description |
|---|---|---|
--distinct |
off | Deduplicate rows (default is union-all). |
--sync / --no-sync |
--sync |
Push the catalog to its remotes after the operation. |
-a, --alias |
none | Also register this alias for the cataloged entry. |
--cache-dir |
$XORQ_CACHE_DIR or ~/.cache/xorq |
Directory for parquet cache files. |
--ignore-venv-mismatch |
off | Proceed even if the entries’ wheel requirements or Python minor differ. |
--rebind-backends / --no-rebind-backends |
--rebind-backends |
In multi-root mode, rebind same-profile backend sources to one backend before execution. Never transfers table data. |
Examples
# Union-all (the default) two entries and alias the result
xorq catalog union orders-jan orders-feb --alias orders-q1