MongoDB Protocol Documentation

MongoDB Protocol Documentation

This directory contains consolidated documentation for HeliosDB’s MongoDB wire protocol support and compatibility.

Quick Start

Connect to HeliosDB using any MongoDB driver:

from pymongo import MongoClient

# Standard MongoDB connection string
client = MongoClient("mongodb://localhost:27017/")
db = client.my_database
collection = db.my_collection

# Use like standard MongoDB
result = collection.insert_one({"name": "Alice", "age": 30})
print(f"Inserted: {result.inserted_id}")

Contents

File	Description
README.md	Overview and quick start (this file)
CONFIGURATION.md	Connection and protocol configuration
COMPATIBILITY.md	MongoDB 6.0+/8.0 feature compatibility
EXAMPLES.md	Code examples and usage patterns

Feature Overview

Wire Protocol Support

HeliosDB implements MongoDB wire protocol with full feature support:

• OP_MSG: Modern protocol (MongoDB 3.6+)
• BSON: Complete BSON type support
• Authentication: SCRAM-SHA-256
• TLS/SSL: Encrypted connections
• Change Streams: Real-time notifications via CDC

Protocol Completeness

Feature	Status	Version
Wire Protocol (OP_MSG)	100%	6.0+
BSON Encoding/Decoding	100%	All
SCRAM-SHA-256 Auth	100%	4.0+
CRUD Operations	100%	All
Query Operators	100%	All
Update Operators	100%	All
Aggregation Pipeline	100%	8.0
Change Streams	100%	6.0+
Transactions	100%	4.0+
Indexes	100%	All

Key Advantages Over MongoDB

Feature	MongoDB	HeliosDB
MVCC	Standard	Zero-maintenance
Transactions	Snapshot	SERIALIZABLE isolation
Change Streams	Standard	CDC-backed, lower latency
SQL Access	No	Native PostgreSQL
Full-Text Search	Paid plugin	Built-in with GraphRAG
Sharding	Manual	Transparent horizontal scaling

Connection Parameters

Parameter	Default	Description
host	localhost	Server hostname
port	27017	MongoDB wire protocol port
database	admin	Default database
authSource	admin	Authentication database
authMechanism	SCRAM-SHA-256	Authentication method

Architecture

MongoDB Driver (PyMongo/Motor/Node.js)
           |
    Wire Protocol (OP_MSG)
           |
    BSON Decoder
           |
    Command Executor
           |
    Query Translator (MongoDB -> SQL)
           |
    Storage Adapter
           |
    HeliosDB Storage Engine (JSONB)

Driver Compatibility

Language	Driver	Version	Status
Python	PyMongo	4.x	Full
Python	Motor	3.x	Full
JavaScript	mongodb	6.x	Full
Java	mongodb-driver	4.x	Full
C#	MongoDB.Driver	2.x	Full
Go	mongo-go	1.x	Full
Rust	mongodb	3.x	Full

Performance

Operation	Ops/sec	Notes
Insert	50,000	Batched inserts
Find	100,000	With index
Update	45,000	Single document
Delete	50,000	With filter
Aggregation	20,000	Simple pipeline

Migration from MongoDB

Export/Import Data

# Export from MongoDB
mongodump --uri="mongodb://source:27017/mydb" --out=/backup

# Import to HeliosDB
mongorestore --uri="mongodb://heliosdb:27017/mydb" /backup

Update Connection String

# Before (MongoDB)
client = MongoClient("mongodb://mongodb-server:27017/")

# After (HeliosDB)
client = MongoClient("mongodb://heliosdb-server:27017/")

Related Documentation

• CONFIGURATION.md - Connection configuration
• COMPATIBILITY.md - Feature compatibility
• EXAMPLES.md - Code examples
• Parent Directory - Protocol overview
• PROTOCOL_COMPATIBILITY_MATRIX.md - Cross-protocol comparison

---

Last Updated: December 2025 Consolidation Status: Complete