CLI Commands

Run commands with uv run snowpack from the repository root.

Global options must be passed before the command name.

Usage: snowpack [OPTIONS] COMMAND [ARGS]...

  Snowpack — Iceberg table compaction and maintenance.

Options:
  -v, --verbose  Enable debug logging
  --help         Show this message and exit.

Commands:
  health    Analyze health of a single Iceberg table.
  maintain  Execute maintenance actions on a single Iceberg table.
  tables    List discovered Iceberg tables.

snowpack tables

List discovered Iceberg tables.

Parameters

Name	Default	Description
--spark-host	config/env default
--spark-port	config/env default
--catalog	config/env default
--database, -d	config/env default	Limit to a specific database

Usage: snowpack tables [OPTIONS]

  List discovered Iceberg tables.

Options:
  --spark-host TEXT
  --spark-port INTEGER
  --catalog TEXT
  -d, --database TEXT   Limit to a specific database
  --help                Show this message and exit.

snowpack health

Analyze health of a single Iceberg table.

Parameters

Name	Default	Description
--spark-host	config/env default
--spark-port	config/env default
--catalog	config/env default
DATABASE	required	Positional argument.
TABLE	required	Positional argument.

Usage: snowpack health [OPTIONS] DATABASE TABLE

  Analyze health of a single Iceberg table.

Options:
  --spark-host TEXT
  --spark-port INTEGER
  --catalog TEXT
  --help                Show this message and exit.

snowpack maintain

Execute maintenance actions on a single Iceberg table.

Parameters

Name	Default	Description
--spark-host	config/env default
--spark-port	config/env default
--catalog	config/env default
--target-file-size-mb	config/env default
--min-file-size-mb	config/env default
--action	required	Maintenance action to execute (repeatable)
--dry-run	false	Log what would be executed but don’t mutate
DATABASE	required	Positional argument.
TABLE	required	Positional argument.

Usage: snowpack maintain [OPTIONS] DATABASE TABLE

  Execute maintenance actions on a single Iceberg table.

Options:
  --spark-host TEXT
  --spark-port INTEGER
  --catalog TEXT
  --target-file-size-mb INTEGER
  --min-file-size-mb INTEGER
  --action TEXT                  Maintenance action to execute (repeatable)
                                 [required]
  --dry-run                      Log what would be executed but don't mutate
  --help                         Show this message and exit.