MatsushibaDB
Support
Part of Matsushiba Systems
Support & Community
Get help, report issues, and connect with the MatsushibaDB community.
Frequently Asked Questions
What is MatsushibaDB?
MatsushibaDB is a next-generation SQL database designed for modern applications. It provides high performance, advanced security features, and multi-protocol support for enterprise deployments.
How does MatsushibaDB differ from traditional databases?
MatsushibaDB is a next-generation SQL database with enterprise features including multi-protocol support (HTTP, WebSocket, TCP), advanced security (RBAC, audit logging), real-time monitoring, and connection pooling for high-performance applications.
What programming languages are supported?
MatsushibaDB provides official client libraries for Node.js and Python, with async support and comprehensive APIs. The multi-protocol design allows integration with any language that supports HTTP, WebSocket, or TCP.
Is MatsushibaDB suitable for production use?
Yes, MatsushibaDB is designed for production environments with features like connection pooling, health checks, monitoring, audit logging, and high availability support. It's used by enterprises worldwide.
What are the performance characteristics?
MatsushibaDB can handle 10,000+ queries per second for read operations and 5,000+ inserts per second for write operations. It supports 1,000+ concurrent connections with proper connection pooling.
How do I migrate from another database?
MatsushibaDB supports standard SQL, making migration straightforward. You can export data from your existing database and import it using standard SQL commands. We provide migration tools and scripts for common databases.
What security features are available?
MatsushibaDB includes JWT authentication, role-based access control (RBAC), audit logging, data encryption at rest, rate limiting, and comprehensive security monitoring with real-time alerts.
Can I use MatsushibaDB in Docker?
Yes, MatsushibaDB provides official Docker images with multi-architecture support (Linux amd64, arm64, arm/v7, 386). The images include health checks, volume support, and production-ready configurations.
What monitoring and observability features are available?
MatsushibaDB provides health check endpoints, Prometheus-compatible metrics, structured logging, real-time performance monitoring, and integration with Grafana dashboards.
Is there a web-based administration interface?
Yes, MatsushibaDB includes GoodDBAdmin, a web-based administration interface similar to phpMyAdmin. It provides database management, query execution, user management, and monitoring capabilities.
What are the licensing terms?
MatsushibaDB is available under the Matsushiba Proprietary License, which grants usage allowance but reserves the right for Matsushiba Foundation to request fees from consumers as needed.
How do I get started quickly?
The fastest way to get started is with npm: npm install matsushibadb then npx matsushiba-db start. Check our installation guide and examples for detailed setup instructions.
Troubleshooting
Installation Issues
Port Already in Use
Error: "Port 8000 is already in use"
Solution:
# Find process using port
lsof -i :8000
# Kill process
kill -9 PID
Permission Denied
Error: "Permission denied" when accessing database files
Solution:
# Check file permissions
ls -la /app/data/
# Fix permissions
chmod 755 /app/data/
Connection Issues
Connection Refused
Error: "Connection refused" when connecting to server
Solution:
# Check if server is running
ps aux | grep matsushiba
# Start server
npx matsushiba-db start
Authentication Failed
Error: "Invalid credentials" or "Token expired"
Solution:
# Check credentials
curl -X POST http://localhost:8000/auth/login \
-H "Content-Type: application/json" \
-d '{"username":"admin","password":"password"}'
Performance Issues
Slow Queries
Symptom: Queries taking longer than expected
Solution:
# Check query performance
EXPLAIN QUERY PLAN SELECT * FROM users;
# Create indexes
CREATE INDEX idx_users_email ON users(email);
High Memory Usage
Symptom: Server using excessive memory
Solution:
# Adjust cache settings
PRAGMA cache_size=5000;
# Check connection pool
# Reduce max_connections if needed
Database Issues
Database Locked
Error: "Database is locked"
Solution:
# Check for running processes
ps aux | grep matsushiba
# Stop all processes
pkill matsushiba
# Restart server
Corrupted Database
Error: "Database disk image is malformed"
Solution:
# Check database integrity
PRAGMA integrity_check;
# Restore from backup
cp backup.db current.db