Troubleshooting
Solutions to common issues with database connections, schema validation, and runtime execution in an5 ORM.
Active Context: Troubleshooting for Swift on Nbase.
Connection Issues
1. Connection Refused or Host Unreachable
Symptom: ECONNREFUSED, Connection refused, or timeout trying to open database connection.
Diagnostic Checklist:
- Confirm the database service is running on the host and port.
- Verify network firewalls allow incoming traffic from your application IP.
- Validate connection string syntax for Nbase:
# Valid connection format for Nbase
DATABASE_URL=nbase://localhost:1307?token=secret
NBase specific notes:
- Verify NBase vector daemon is running and listening on port 1307.
Connection Diagnostic Test
Run a quick connection health test using your active language:
Schema & Code Generation Issues
1. Type Mismatch in Schema
Error: Invalid field type 'X' for provider 'Y'
Cause: The schema .an5 uses a type specific to another database dialect (e.g. BIT on SQLite or BOOLEAN on SQL Server).
Solution: Align field types in an5Schema/ with the dialect rules of Nbase:
- Consult the Field Types reference for valid types per provider.
2. Output Directory Not Found
Error: Directory does not exist for generator output
Solution: an5Orm generates directories automatically. Ensure your user has filesystem write permissions in the workspace and verify outputs paths in an5Orm.config.js.
Next Steps
- Database Providers - Full dialect specifications
- Deployment - Production security and pooling setup