On this page

    Perform Nessie Maintenance

    This topic provides usage information for the dremio-admin nessie-maintenance CLI command.

    note:

    Automatic Nessie maintenance and the manual CLI command are available in Dremio 21.4.0+ and 22.1.1+. Because Nessie maintenance is performed automatically, it is not likely that you will need to run the CLI command unless advised by Dremio Support. You can change the automatic maintenance interval with the nessie.kvversionstore.maintenance.period_minutes Support Key.

    Requirements

    • Perform a backup before running the command (see Backup for more information).

    • Shut down all cluster nodes completely before running the command (see Startup/Shutdown for more information).

    Syntax

    Syntax for Nessie maintenance command
    dremio-admin nessie-maintenance [args...]
    

    Arguments

    Arguments for Nessie maintenance command
    --compact-global-log
    Compact Nessie's global log file (legacy data).
      
    --dry-run
    Test repository maintenance activities without making any changes. This is useful for estimating the amount of maintenance work that would be performed. 
    
    -h, --help
    Show usage and exit.
    
    --list-keys
    List live keys without making any changes or performing any maintenance.
    
    --progress
    Report process every Nth maintenance event, such as deleting an entity. This entry is ignored if not a positive integer value.
    Default: 0 (ignored)
    
    --purge-key-lists
    Purge obsolete key lists.
    

    Examples

    This section provides examples for performing Nessie maintenance.

    Compact Global Log

    Compacts embedded Nessie’s global log file.

    Compact Global Log
    dremio-admin nessie-maintenance --compact-global-log
    

    Purge Obsolete Key Lists

    Purges key-value entries that are no longer used.

    Purge Key Lists
    dremio-admin nessie-maintenance --purge-key-lists