/// import fs = require('fs'); import mysql = require('mysql'); import stream = require('stream'); /// Connections var connection = mysql.createConnection({ host: 'localhost', user: 'me', password: 'secret' }); connection.connect(); connection.query('SELECT 1 + 1 AS solution', function (err, rows, fields) { if (err) throw err; console.log('The solution is: ', rows[0].solution); }); connection.end(); connection = mysql.createConnection({ host: 'example.org', user: 'bob', password: 'secret' }); connection.connect(function (err) { if (err) { console.error('error connecting: ' + err.stack); return; } console.log('connected as id ' + connection.threadId); }); connection.query('SELECT 1', function (err, rows) { // connected! (unless `err` is set) }); connection = mysql.createConnection({ host: 'localhost', ssl: { ca: '' } }); connection = mysql.createConnection({ host: 'localhost', ssl: { // DO NOT DO THIS // set up your ca correctly to trust the connection rejectUnauthorized: false } }); connection.end(function (err) { // The connection is terminated now }); connection.destroy(); connection.changeUser({ user: 'john' }, function (err) { if (err) throw err; }); var userId = 'some user provided value'; var sql = 'SELECT * FROM users WHERE id = ' + connection.escape(userId); connection.query(sql, function (err, results) { // ... }); connection.query('SELECT * FROM users WHERE id = ?', [userId], function (err, results) { // ... }); var post = { id: 1, title: 'Hello MySQL' }; var query = connection.query('INSERT INTO posts SET ?', post, function (err, result) { // Neat! }); console.log(query.sql); // INSERT INTO posts SET `id` = 1, `title` = 'Hello MySQL' var queryStr = "SELECT * FROM posts WHERE title=" + mysql.escape("Hello MySQL"); console.log(queryStr); // SELECT * FROM posts WHERE title='Hello MySQL' var sorter = 'date'; var sql = 'SELECT * FROM posts ORDER BY ' + connection.escapeId(sorter); connection.query(sql, function (err, results) { // ... }); var sorter = 'date'; var sql = 'SELECT * FROM posts ORDER BY ' + connection.escapeId('posts.' + sorter); connection.query(sql, function (err, results) { // ... }); var userIdNum = 1; var columns = ['username', 'email']; var query = connection.query('SELECT ?? FROM ?? WHERE id = ?', [columns, 'users', userIdNum], function (err, results) { // ... }); console.log(query.sql); // SELECT `username`, `email` FROM `users` WHERE id = 1 var sql = "SELECT * FROM ?? WHERE ?? = ?"; var inserts = ['users', 'id', userId]; sql = mysql.format(sql, inserts); connection.config.queryFormat = function (query, values) { if (!values) return query; return query.replace(/\:(\w+)/g, function (txt: string, key: string) { if (values.hasOwnProperty(key)) { return this.escape(values[key]); } return txt; }.bind(this)); }; connection.query("UPDATE posts SET title = :title", { title: "Hello MySQL" }); var s: stream.Readable = connection.query("UPDATE posts SET title = :title", { title: "Hello MySQL" }).stream({ highWaterMark: 5 }); connection.query('INSERT INTO posts SET ?', { title: 'test' }, function (err, result) { if (err) throw err; console.log(result.insertId); }); connection.query('DELETE FROM posts WHERE title = "wrong"', function (err, result) { if (err) throw err; console.log('deleted ' + result.affectedRows + ' rows'); }); connection.query('UPDATE posts SET ...', function (err, result) { if (err) throw err; console.log('changed ' + result.changedRows + ' rows'); }); connection.connect(function (err) { if (err) throw err; console.log('connected as id ' + connection.threadId); }); /// Pools var poolConfig = { connectionLimit: 10, host: 'example.org', user: 'bob', password: 'secret' }; var pool = mysql.createPool(poolConfig); pool.query('SELECT 1 + 1 AS solution', function (err, rows, fields) { if (err) throw err; console.log('The solution is: ', rows[0].solution); }); pool = mysql.createPool({ host: 'example.org', user: 'bob', password: 'secret' }); pool.getConnection(function (err, connection) { // connected! (unless `err` is set) }); pool.on('connection', function (connection) { connection.query('SET SESSION auto_increment_increment=1') }); pool.getConnection(function (err, connection) { // Use the connection connection.query('SELECT something FROM sometable', function (err, rows) { // And done with the connection. connection.release(); // Don't use the connection here, it has been returned to the pool. }); }); /// PoolClusters // create var poolCluster = mysql.createPoolCluster(); poolCluster.add(poolConfig); // anonymous group poolCluster.add('MASTER', poolConfig); poolCluster.add('SLAVE1', poolConfig); poolCluster.add('SLAVE2', poolConfig); // Target Group : ALL(anonymous, MASTER, SLAVE1-2), Selector : round-robin(default) poolCluster.getConnection(function (err, connection) { }); // Target Group : MASTER, Selector : round-robin poolCluster.getConnection('MASTER', function (err, connection) { }); // Target Group : SLAVE1-2, Selector : order // If can't connect to SLAVE1, return SLAVE2. (remove SLAVE1 in the cluster) poolCluster.on('remove', function (nodeId) { console.log('REMOVED NODE : ' + nodeId); // nodeId = SLAVE1 }); poolCluster.getConnection('SLAVE*', 'ORDER', function (err, connection) { }); // of namespace : of(pattern, selector) poolCluster.of('*').getConnection(function (err, connection) { }); var pool = poolCluster.of('SLAVE*', 'RANDOM'); pool.getConnection(function (err, connection) { }); pool.getConnection(function (err, connection) { }); // destroy poolCluster.end(); /// Queries var query = connection.query('SELECT * FROM posts'); query .on('error', function (err) { // Handle error, an 'end' event will be emitted after this as well }) .on('fields', function (fields) { // the field packets for the rows to follow }) .on('result', function (row) { // Pausing the connnection is useful if your processing involves I/O connection.pause(); var processRow = (row: any, cb: () => void) => { cb(); }; processRow(row, function () { connection.resume(); }); }) .on('end', function () { // all rows have been received }); var writable = fs.createWriteStream('file.txt'); connection.query('SELECT * FROM posts') .stream({ highWaterMark: 5 }) .pipe(writable); connection = mysql.createConnection({ multipleStatements: true }); connection.query('SELECT 1; SELECT 2', function (err, results) { if (err) throw err; // `results` is an array with one element for every statement in the query: console.log(results[0]); // [{1: 1}] console.log(results[1]); // [{2: 2}] }); var query = connection.query('SELECT 1; SELECT 2'); query .on('fields', function (fields, index) { // the fields for the result rows that follow }) .on('result', function (row, index) { // index refers to the statement this result belongs to (starts at 0) }); var options = { sql: '...', nestTables: true }; connection.query(options, function (err, results) { /* results will be an array like this now: [{ table1: { fieldA: '...', fieldB: '...', }, table2: { fieldA: '...', fieldB: '...', }, }, ...] */ }); connection.beginTransaction(function (err) { var title = 'title'; if (err) { throw err; } connection.query('INSERT INTO posts SET title=?', title, function (err, result) { if (err) { connection.rollback(function () { throw err; }); } var log = 'Post ' + result.insertId + ' added'; connection.query('INSERT INTO log SET data=?', log, function (err, result) { if (err) { connection.rollback(function () { throw err; }); } connection.commit(function (err) { if (err) { connection.rollback(function () { throw err; }); } console.log('success!'); }); }); }); }); // Kill query after 60s connection.query({ sql: 'SELECT COUNT(*) AS count FROM big_table', timeout: 60000 }, function (err, rows) { if (err && err.code === 'PROTOCOL_SEQUENCE_TIMEOUT') { throw new Error('too long to count table rows!'); } if (err) { throw err; } console.log(rows[0].count + ' rows'); }); connection = mysql.createConnection({ port: 84943, // WRONG PORT }); connection.connect(function (err) { console.log(err.code); // 'ECONNREFUSED' console.log(err.fatal); // true }); connection.query('SELECT 1', function (err) { console.log(err.code); // 'ECONNREFUSED' console.log(err.fatal); // true }); connection.query('USE name_of_db_that_does_not_exist', function (err, rows) { console.log(err.code); // 'ER_BAD_DB_ERROR' }); connection.query('SELECT 1', function (err, rows) { console.log(err); // null console.log(rows.length); // 1 }); connection.on('error', function (err) { console.log(err.code); // 'ER_BAD_DB_ERROR' }); connection.query('USE name_of_db_that_does_not_exist'); // I am Chuck Norris: connection.on('error', function () { }); connection = mysql.createConnection({ typeCast: false }); var query = connection.query({ sql: '...', typeCast: false }, function (err, results) { }); connection.query({ sql: '...', typeCast: function (field: any, next: Function) { if (field.type == 'TINY' && field.length == 1) { return (field.string() == '1'); // 1 = true, 0 = false } return next(); } }); connection = mysql.createConnection("mysql://localhost/test?flags=-FOUND_ROWS"); connection = mysql.createConnection({ debug: true }); connection = mysql.createConnection({ debug: ['ComQueryPacket', 'RowDataPacket'] });