// PostgreSQL // ------- // All of the "when.js" promise components needed in this module. var when = require('when'); var nodefn = require('when/node/function'); // Other dependencies, including the `pg` library, // which needs to be added as a dependency to the project // using this database. var _ = require('underscore'); var pg = require('pg'); // All other local project modules needed in this scope. var ServerBase = require('./base').ServerBase; var baseGrammar = require('../base/grammar').BaseGrammar; var baseSchemaGrammar = require('../base/schemagrammar').BaseSchemaGrammar; var Helpers = require('../../lib/helpers').Helpers; // Constructor for the PostgreSQL Client exports.Client = ServerBase.extend({ dialect: 'postgresql', // Runs the query on the specified connection, providing the bindings // and any other necessary prep work. runQuery: function(connection, sql, bindings, builder) { if (!connection) throw new Error('No database connection exists for the query'); var questionCount = 0; sql = sql.replace(/\?/g, function() { questionCount++; return '$' + questionCount; }); if (builder && builder.flags.options) sql = _.extend({text: sql}, builder.flags.options); return nodefn.call(connection.query.bind(connection), sql, bindings); }, // Get a raw connection, called by the `pool` whenever a new // connection needs to be added to the pool. getRawConnection: function(callback) { var instance = this; var connection = new pg.Client(this.connectionSettings); return nodefn.call(connection.connect.bind(connection)).tap(function() { if (!instance.version) return instance.checkVersion(connection); }).yield(connection); }, // Used to explicitly close a connection, called internally by the pool // when a connection times out or the pool is shutdown. destroyRawConnection: function(connection) { connection.end(); }, // In PostgreSQL, we need to do a version check to do some feature // checking on the database. checkVersion: function(connection) { var instance = this; this.runQuery(connection, 'select version();').then(function(resp) { instance.version = /^PostgreSQL (.*?) /.exec(resp.rows[0].version)[1]; }); } }); // Extends the standard sql grammar. var grammar = exports.grammar = _.defaults({ // The keyword identifier wrapper format. wrapValue: function(value) { return (value !== '*' ? Helpers.format('"%s"', value) : "*"); }, // Compiles a truncate query. compileTruncate: function(qb) { return 'truncate ' + this.wrapTable(qb.table) + ' restart identity'; }, // Compiles an `insert` query, allowing for multiple // inserts using a single query statement. compileInsert: function(qb) { var values = qb.values; var columns = _.pluck(values[0], 0); var paramBlocks = []; // If there are any "where" clauses, we need to omit // any bindings that may have been associated with them. if (qb.wheres.length > 0) this.clearWhereBindings(qb); var sql = 'insert into ' + this.wrapTable(qb.table) + ' '; if (columns.length === 0) { sql += 'default values'; } else { for (var i = 0, l = values.length; i < l; ++i) { paramBlocks.push("(" + this.parameterize(_.pluck(values[i], 1)) + ")"); } sql += "(" + this.columnize(columns) + ") values " + paramBlocks.join(', '); } if (qb.flags.returning) { sql += ' returning "' + qb.flags.returning + '"'; } return sql; }, // Handles the response handleResponse: function(builder, response) { if (response.command === 'SELECT') return response.rows; if (response.command === 'INSERT') { return _.map(response.rows, function(row) { return row[builder.flags.returning]; }); } if (response.command === 'UPDATE' || response.command === 'DELETE') { return response.rowCount; } return ''; } }, baseGrammar); // Grammar for the schema builder. exports.schemaGrammar = _.defaults({ // The possible column modifiers. modifiers: ['Increment', 'Nullable', 'Default'], handleResponse: function(builder, resp) { resp = resp[0]; if (builder.type === 'tableExists' || builder.type === 'columnExists') { return resp.rows.length > 0; } return resp; }, // Compile the query to determine if a table exists. compileTableExists: function() { return 'select * from information_schema.tables where table_name = ?'; }, // Compile the query to determine if a column exists in a table. compileColumnExists: function() { return 'select * from information_schema.columns where table_name = ? and column_name = ?'; }, // Compile a create table command. compileAdd: function(blueprint) { var table = this.wrapTable(blueprint); var columns = this.prefixArray('add column', this.getColumns(blueprint)); return 'alter table ' + table + ' ' + columns.join(', '); }, // Compile a primary key command. compilePrimary: function(blueprint, command) { var columns = this.columnize(command.columns); return 'alter table ' + this.wrapTable(blueprint) + " add primary key (" + columns + ")"; }, // Compile a unique key command. compileUnique: function(blueprint, command) { var table = this.wrapTable(blueprint); var columns = this.columnize(command.columns); return 'alter table ' + table + ' add constraint ' + command.index + ' unique (' + columns + ')'; }, // Compile a plain index key command. compileIndex: function(blueprint, command) { var columns = this.columnize(command.columns); return "create index " + command.index + " on " + this.wrapTable(blueprint) + ' (' + columns + ')'; }, // Compile a drop column command. compileDropColumn: function(blueprint, command) { var columns = this.prefixArray('drop column', this.wrapArray(command.columns)); var table = this.wrapTable(blueprint); return 'alter table ' + table + ' ' + columns.join(', '); }, // Compile a drop primary key command. compileDropPrimary: function(blueprint) { var table = blueprint.getTable(); return 'alter table ' + this.wrapTable(blueprint) + " drop constraint " + table + "_pkey"; }, // Compile a drop unique key command. compileDropUnique: function(blueprint, command) { var table = this.wrapTable(blueprint); return "alter table " + table + " drop constraint " + command.index; }, // Compile a drop foreign key command. compileDropForeign: function(blueprint, command) { var table = this.wrapTable(blueprint); return "alter table " + table + " drop constraint " + command.index; }, // Compile a rename table command. compileRenameTable: function(blueprint, command) { return 'alter table ' + this.wrapTable(blueprint) + ' rename to ' + this.wrapTable(command.to); }, // Compile a rename column command. compileRenameColumn: function(blueprint, command) { return 'alter table ' + this.wrapTable(blueprint) + ' rename '+ this.wrapTable(command.from) + ' to ' + this.wrapTable(command.to); }, // Compile a comment command. compileComment: function(blueprint, command) { var sql = ''; if (command.comment) { sql += 'comment on table ' + this.wrapTable(blueprint) + ' is ' + "'" + command.comment + "'"; } return sql; }, // Compile any additional postgres specific items. compileAdditional: function(blueprint, command) { return _.compact(_.map(blueprint.columns, function(column) { if (column.isCommented && _.isString(column.isCommented)) { return 'comment on column ' + this.wrapTable(blueprint) + '.' + this.wrap(column.name) + " is '" + column.isCommented + "'"; } }, this)); }, // Create the column definition for a integer type. typeInteger: function(column) { return column.autoIncrement ? 'serial' : 'integer'; }, // Create the column definition for a tiny integer type. typeTinyInteger: function() { return 'smallint'; }, // Create the column definition for a float type. typeFloat: function() { return 'real'; }, // Create the column definition for a decimal type. typeDecimal: function(column) { return "decimal(" + column.total + ", " + column.places + ")"; }, // Create the column definition for a boolean type. typeBoolean: function() { return 'boolean'; }, // Create the column definition for an enum type. // Using method 2 here: http://stackoverflow.com/questions/10923213/postgres-enum-data-type-or-check-constraint typeEnum: function(column) { return 'text check(' + this.wrap(column.name) + " in('" + column.allowed.join("', '") + "'))"; }, // Create the column definition for a date-time type. typeDateTime: function() { return 'timestamp'; }, // Create the column definition for a timestamp type. typeTimestamp: function() { return 'timestamp'; }, // Create the column definition for a bit type. typeBit: function(column) { return column.length !== false ? 'bit(' + column.length + ')' : 'bit'; }, // Create the column definition for a binary type. typeBinary: function() { return 'bytea'; }, // Create the column definition for a uuid type. typeUuid: function() { return 'uuid'; }, // Create the column definition for a json type, // checking whether the json type is supported - falling // back to "text" if it's not. typeJson: function(column, blueprint) { if (parseFloat(blueprint.client.version) >= 9.2) return 'json'; return 'text'; }, // Get the SQL for an auto-increment column modifier. modifyIncrement: function(blueprint, column) { if (column.autoIncrement && (column.type == 'integer' || column.type == 'bigInteger')) { return ' primary key not null'; } } }, baseSchemaGrammar, grammar);