Why MongoDB BI Connector (mongosqld) Gets Stuck on Schema Generation — And How to Fix It

TL;DR: If mongosqld hangs on schema sampling with large collections, the root cause is usually $sample triggering disk I/O due to oversized indexes not fitting in RAM. The fix is generating a static .drdl schema file and pointing mongosqld to it.