influxdata/influxdb · error · TableIndexCacheError

Failed to load table index from object store

Error message

Failed to load table index from object store

What it means

This error is a TableIndexCacheError::LoadTableIndexFromObjectStoreError, thrown when the cache cannot load a persisted table index snapshot from the object store. It wraps a crate::table_index::TableIndexError as its #[source], so the underlying cause (network failure, missing object, corrupt snapshot) is preserved. It indicates the table index could not be reconstructed from persisted state during cache initialization or refresh.

Solutions

1. Inspect the wrapped #[source] TableIndexError to find the root cause (object not found vs deserialize vs store I/O).
2. Verify object store connection settings (endpoint, bucket, credentials) are correct and reachable.
3. Check that the snapshot files for the database/table exist and were written by a compatible InfluxDB 3 version.
4. If snapshots are corrupt, restore from a backup or re-bootstrap the database catalog.

Example fix

// before: ignoring the wrapped cause
eprintln!("cache error: {}", err);
// after: surface the source chain for diagnosis
log::error!("failed to load table index from object store: {err}";
  source = ?anyhow::Error::new(err));

// Rust: pre-check object store reachability
let head = object_store.head(&snapshot_prefix).await;
assert!(head.is_ok(), "object store unreachable: {:?}", head.err());

fn is_load_table_index_err(e: &TableIndexCacheError) -> bool {
  matches!(e, TableIndexCacheError::LoadTableIndexFromObjectStoreError(_))
}

match cache.load_index(db).await {
  Err(TableIndexCacheError::LoadTableIndexFromObjectStoreError(src)) => {
    log::error!("index load failed: {src}");
    // inspect src: NotFound => stale snapshot; other => store/I-O issue
  }
  Err(e) => return Err(e),
  Ok(idx) => idx,
}

When it happens

Trigger: Calling table_index_cache paths that load an existing TableIndex from the object store (e.g. cache initialization or get/refresh of a cached index) where TableIndex::load/persist machinery returns a TableIndexError — object missing, deserialization failure, or store I/O error.

Common situations: Object store credentials or endpoint misconfigured so snapshot reads fail; snapshot object deleted or truncated by another process; corrupt/older-format snapshot files after a version upgrade; network partitions between the node and S3/GCS/Azure blob storage.

Related errors

• Failed to create table index from object store
• Failed to delete table index
• Failed to update table index from object store
• error from persister
• Failed to delete parquet file

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

Appendix: source

Thrown at influxdb3_write/src/table_index_cache.rs:96

    #[error("Failed to list object store metadata")]
    ListMetasError(#[source] object_store::Error),

    #[error("Failed to load table index conversion marker bytes from object store")]
    LoadConversionMarkerBytesError(#[source] object_store::Error),

    #[error("Failed to serialize initial table index conversion marker")]
    SerializeConversionMarkerError(#[source] serde_json::Error),

    #[error("Failed to put initial table index conversion marker to object store")]
    PutConversionMarkerError(#[source] object_store::Error),

    #[error("Failed to parse snapshot info file path")]
    ParseSnapshotPathError(#[source] anyhow::Error),

    #[error("Failed to split persisted snapshot into table snapshots")]
    SplitPersistedSnapshotError(#[source] crate::table_index::TableIndexError),

    #[error("Failed to load table index from object store")]
    LoadTableIndexFromObjectStoreError(#[source] crate::table_index::TableIndexError),

    #[error("Failed to update table index from object store")]
    UpdateTableIndexFromObjectStoreError(#[source] crate::table_index::TableIndexError),

    #[error("Failed to create table index from object store")]
    CreateTableIndexFromObjectStoreError(#[source] crate::table_index::TableIndexError),

    #[error("Failed to delete parquet file {path} from object store")]
    DeleteParquetFile {
        path: String,
        #[source]
        source: object_store::Error,
    },

    #[error("Failed to delete table index {table_id} from object store")]
    DeleteTableIndex {
        table_id: TableIndexId,

View on GitHub (pinned to 06200ef96b)