quickwit-oss/quickwit · error

unknown split state ` `. possible values are `staged`…

Error message

unknown split state `{split_state_arg}`. possible values are `staged`, `published`, and `marked`

What it means

`parse_split_state` (reached from `quickwit split list --states`) lowercased the user-provided state argument and matched it against the SplitState enum values staged, published, and marked; none matched. It is a pure input-validation error on the `--states` CLI option.

Solutions

1. Use one of the accepted state values: `staged`, `published`, or `marked`
2. Pass a comma-separated list of these values if multiple states are wanted

When it happens

Trigger: Thrown at quickwit/quickwit-cli/src/split.rs:451 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of quickwit-oss/quickwit@a39730c5cd (2026-09-08). Data as JSON: /api/errors/0bfc25838207e3b9. Report an issue: GitHub.

Appendix: source

Thrown at quickwit/quickwit-cli/src/split.rs:451

        let description = format_description::parse_borrowed::<2>(datetime_format)?;
        if let Ok(datetime) = PrimitiveDateTime::parse(date_arg, &description) {
            return Ok(datetime.assume_utc());
        }
    }
    bail!(
        "failed to parse --{}-date option parameter `{}`. supported format is `YYYY-MM-DD[ \
         HH:DD[:SS]]`",
        option_name,
        date_arg
    );
}

fn parse_split_state(split_state_arg: &str) -> anyhow::Result<SplitState> {
    let split_state = match split_state_arg.to_lowercase().as_str() {
        "staged" => SplitState::Staged,
        "published" => SplitState::Published,
        "marked" => SplitState::MarkedForDeletion,
        _ => bail!(format!(
            "unknown split state `{split_state_arg}`. possible values are `staged`, `published`, \
             and `marked`"
        )),
    };
    Ok(split_state)
}

#[derive(Tabled)]
struct SplitRow {
    #[tabled(rename = "ID")]
    split_id: SplitId,
    #[tabled(rename = "State")]
    split_state: SplitState,
    #[tabled(rename = "Num docs")]
    num_docs: usize,
    #[tabled(rename = "Size (MB)")]
    size_mega_bytes: u64,
    #[tabled(rename = "Created at")]

View on GitHub (pinned to a39730c5cd)