How mariadb-corporation/mariadb-connector-nodejs works
MariaDB Node.js Connector is a non-blocking MariaDB/MySQL client with Promise and callback APIs. The main workflow configures a pool or connection, obtains a connection, submits SQL, encodes and sends protocol packets, then parses server responses into results. Separate command paths support prepared execution, bulk batches, and streamed inserts; connection establishment includes authentication. The graph preserves documented clustering, pipelining, SSL, and streaming capabilities. Some subsystem links rely on README or SOURCE INDEX references because their implementation files were not excerpted; those limits are reflected by omitted uncertain edges.
Main entry points: connection.js Connection runtime · query.js Text queries · parser.js Result parser · pool.js Connection pool
Components 23
Client APIs
- Promise API
promise.js - Callback API
callback.js
Connection Management
- Connection pool
lib/pool.js - Cluster routing
lib/cluster.js - Connection runtime
lib/connection.js - Connection options
lib/config/connection-options.js
SQL Commands
- Authentication
lib/cmd/handshake/authentication.js - Text queries
lib/cmd/query.js - Prepared statements
lib/cmd/execute.js - Bulk batches
lib/cmd/batch-bulk.js - Result parser
lib/cmd/parser.js
Wire Protocol
- Packet output
lib/io/packet-output-stream.js - Packet input
lib/io/packet-input-stream.js - Binary decoder
lib/cmd/decoder/binary-decoder.js - Text encoder
lib/cmd/encoder/text-encoder.js
Protocol Support
- SQL parsing
lib/misc/parse.js - Character collations
lib/const/collations.js - SQL errors
lib/misc/errors.js - Protocol capabilities
lib/const/capabilities.js - Field types
lib/const/field-type.js - Server status
lib/const/server-status.js
Other components
- Node.js application
- MariaDB / MySQL
Connections 29
- Node.js application → Promise API: uses
- Node.js application → Callback API: uses
- Promise API → Connection pool: creates pool
- Callback API → Connection pool: wraps pool
callback.js - Connection pool → Connection runtime: creates connections
lib/pool.js - Node.js application → Connection runtime: queries SQL
- Connection runtime → Connection options: uses options
lib/connection.js - Connection runtime → MariaDB / MySQL: connects
- Connection runtime → Authentication: authenticates
lib/connection.js - Connection runtime → Text queries: dispatches query
lib/connection.js - Connection runtime → Prepared statements: dispatches execute
lib/connection.js - Connection runtime → Bulk batches: dispatches batch
lib/connection.js - Text queries → SQL parsing: splits SQL
lib/cmd/query.js - Text queries → Result parser: extends parser
lib/cmd/query.js - Connection runtime → Packet output: writes packets
lib/connection.js - Packet output → MariaDB / MySQL: sends commands
- MariaDB / MySQL → Packet input: returns packets
- Connection runtime → Packet input: reads packets
lib/connection.js - Result parser → Binary decoder: decodes binary rows
lib/cmd/parser.js - Result parser → Field types: uses field types
- Packet output → Text encoder: encodes values
lib/io/packet-output-stream.js - Connection options → Character collations: selects collation
lib/config/connection-options.js - Authentication → Protocol capabilities: checks capabilities
lib/cmd/handshake/authentication.js - Result parser → Server status: reads status
lib/cmd/parser.js - Text queries → SQL errors: creates errors
lib/cmd/query.js - Cluster routing → Connection pool: routes requests
- Node.js application → Cluster routing: uses cluster
- Node.js application → Connection runtime: streams inserts
- Node.js application → Connection runtime: pipelines commands