Skip to content
HeliosDB HeliosDB Full

Graph Database: Troubleshooting

Graph Database: Troubleshooting

Part of: Graph Database User Guide

Common Issues

Issue: Out of Memory

Symptoms: OOM errors during large graph operations

Solutions:

  1. Increase max_memory in StorageConfig
  2. Use pagination with LIMIT and SKIP
  3. Filter data before algorithms
  4. Enable memory-mapped storage for very large graphs
let config = StorageConfig {
    max_memory: 20 * 1024 * 1024 * 1024, // 20GB
    use_mmap: true,
    ..Default::default()
};

Issue: Slow Queries

Symptoms: Queries taking >1 second

Solutions:

  1. Create indexes on frequently queried properties
  2. Use BFS/DFS instead of Cypher for simple traversals
  3. Limit result sets
  4. Optimize storage periodically
storage.optimize().await?;

Issue: Import Errors

Symptoms: Errors during bulk import

Solutions:

  1. Use batch updates
  2. Validate data format
  3. Check for duplicate IDs
  4. Increase batch size
let batch_mgr = BatchUpdateManager::new(Arc::new(storage), 10000);

Version: 6.5 Last Updated: November 17, 2025