mc table warehouse maintenance update

The mc table warehouse maintenance update command changes individual settings on an existing maintenance configuration, or enables and disables it.

Unlike mc table warehouse maintenance set, update only applies the flags you specify and leaves the rest unchanged. A maintenance configuration for the specified type must already exist, or the command returns an error.

Example

The following command disables snapshot expiration on the analytics warehouse on the myaistor MinIO AIStor cluster:

mc table warehouse maintenance update myaistor analytics \
   --type icebergSnapshotManagement                      \
   --status disabled

Syntax

The command has the following syntax:

mc [GLOBALFLAGS] table warehouse maintenance update                       \
                 ALIAS                                                    \
                 WAREHOUSE                                                \
                 --type icebergSnapshotManagement | icebergUnreferencedFileRemoval  \
                 [--status enabled | disabled]                            \
                 [--max-age-hours VALUE]                                  \
                 [--min-snapshots VALUE]                                  \
                 [--unreferenced-days VALUE]                              \
                 [--noncurrent-days VALUE]

Brackets [] indicate optional parameters.
Parameters separated using the pipe | operator are mutually exclusive.

Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.

Parameters

ALIAS

Required

The alias of a MinIO AIStor cluster.

WAREHOUSE

Required

The name of the warehouse to update.

--type

Required

The maintenance type to update: icebergSnapshotManagement or icebergUnreferencedFileRemoval.

A configuration for this type must already exist. Use set to create one first.

You must specify at least one of --status or a value flag valid for the chosen type.

--status

Optional

Set the maintenance status to enabled or disabled.

--max-age-hours

Optional (icebergSnapshotManagement)

The maximum snapshot age, in hours, before a snapshot becomes eligible for expiration.

--min-snapshots

Optional (icebergSnapshotManagement)

The minimum number of most-recent snapshots to keep, regardless of age.

--unreferenced-days

Optional (icebergUnreferencedFileRemoval)

The number of days a file must remain unreferenced before it is marked noncurrent.

--noncurrent-days

Optional (icebergUnreferencedFileRemoval)

The number of days a noncurrent file is retained before it is permanently deleted.

Global flags

This command supports any of the global flags.

Examples

Disable a maintenance type

mc table warehouse maintenance update myaistor analytics \
   --type icebergSnapshotManagement                      \
   --status disabled

Change the maximum snapshot age

mc table warehouse maintenance update myaistor analytics \
   --type icebergSnapshotManagement                      \
   --max-age-hours 336

Update multiple settings at once

mc table warehouse maintenance update myaistor analytics \
   --type icebergSnapshotManagement                      \
   --status enabled                                      \
   --max-age-hours 168                                   \
   --min-snapshots 3

Update unreferenced file removal retention

mc table warehouse maintenance update myaistor analytics \
   --type icebergUnreferencedFileRemoval                 \
   --unreferenced-days 14                                \
   --noncurrent-days 7