influxdata/influxdb · warning · TableIndexError

Failed to delete table index snapshot from object store

Error message

Failed to delete table index snapshot from object store

What it means

TableIndexError::DeleteSnapshot is raised when deleting a persisted table index snapshot object from the object store fails. Snapshot cleanup (removal of superseded snapshot files) is part of the index maintenance flow; if the object_store delete call returns an error, it is wrapped here. A failure here usually means stale snapshots accumulate rather than data loss.

Solutions

1. Inspect the wrapped object_store::Error; treat NotFound as benign and continue.
2. Grant the service account/role DeleteObject (or s3:DeleteObject) permission.
3. Retry the cleanup with backoff — deletes are idempotent, so retrying is safe.
4. Check bucket retention/versioning/lifecycle policies that may block object deletion.

Example fix

// before
store.delete(&snapshot_path).await.map_err(TableIndexError::DeleteSnapshot)?;
// after
match store.delete(&snapshot_path).await {
    Err(e) if e.to_string().contains("NotFound") => {} // already deleted, ok
    Err(e) => return Err(TableIndexError::DeleteSnapshot(e)),
    Ok(_) => {}
}

fn is_benign_delete_failure(e: &object_store::Error) -> bool {
    matches!(e, object_store::Error::NotFound{..}) || e.to_string().contains("404")
}

match store.delete(&path).await {
    Ok(_) => {},
    Err(e) if is_benign_delete_failure(&e) => {}, // already gone
    Err(e) => return Err(TableIndexError::DeleteSnapshot(e)),
}

When it happens

Trigger: Calling the cleanup path that invokes ObjectStore::delete (or delete_prefix) on a TableIndexSnapshotPath object and the store returns a permission, network, throttling, or not-found-handled-as-error condition.

Common situations: IAM policy allows writes but not DeleteObject; transient S3/GCS unavailability during garbage collection; another process/node already deleted the snapshot concurrently; bucket versioning/retention policies blocking deletes.

Related errors

• Failed to delete parquet file
• Failed to delete table index
• Failed to list table indices from object store
• failed to load restore source
• Failed to load table index from object store

AI-assisted analysis of influxdata/influxdb@06200ef96b (2026-09-19). Data as JSON: /api/errors/b990bff4bfff28e4. Report an issue: GitHub.

Appendix: source

Thrown at influxdb3_write/src/table_index.rs:46

    #[error("Failed to deserialize table index")]
    DeserializeIndex(#[source] serde_json::Error),

    #[error("Failed to list table index snapshots from object store")]
    ListSnapshots(#[source] object_store::Error),

    #[error("Failed to list table indices from object store")]
    ListIndices(#[source] object_store::Error),

    #[error("Failed to load table index snapshot from object store")]
    LoadSnapshot(#[source] object_store::Error),

    #[error("Failed to deserialize table index snapshot")]
    DeserializeSnapshot(#[source] serde_json::Error),

    #[error("Failed to persist table index to object store")]
    PersistIndex(#[source] object_store::Error),

    #[error("Failed to delete table index snapshot from object store")]
    DeleteSnapshot(#[source] object_store::Error),

    #[error("Cannot merge table indices with mismatched identifiers: {expected} != {actual}")]
    MergeMismatch {
        expected: TableIndexId,
        actual: TableIndexId,
    },

    #[error("Failed to parse table index path from object store path")]
    TableIndexPath(#[source] crate::paths::PathError),

    #[error("Failed to parse table index snapshot path from object store path")]
    TableIndexSnapshotPath(#[source] crate::paths::PathError),

    #[error("Failed to update table index: join task failed")]
    UpdateTaskFailed(#[source] tokio::task::JoinError),

    #[error("Object meta is missing filename")]

View on GitHub (pinned to 06200ef96b)