/* Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */ /*global unified_debug, exports */ "use strict"; /* Requires version 2.0 of Felix Geisendoerfer's MySQL client */ var util = require('util'), path = require("path"), child_process = require("child_process"), udebug = unified_debug.getLogger("MySQLDictionary.js"); exports.DataDictionary = function(pooledConnection, dbConnectionPool) { this.connection = pooledConnection; // need connection pool only for type converters this.dbConnectionPool = dbConnectionPool; }; exports.DataDictionary.prototype.listTables = function(databaseName, user_callback) { var callback = user_callback; var showTables_callback = function(err, rows) { if (err) { callback(err); } else { var result = []; var propertyName = 'Tables_in_' + databaseName; rows.forEach(function(row) { result.push(row[propertyName]); }); udebug.log('listTables function result:', result); callback(err, result); } }; this.connection.query('show tables', showTables_callback); }; exports.DataDictionary.prototype.getTableMetadata = function(databaseName, tableName, user_callback) { var dbConnectionPool = this.dbConnectionPool; // get precision from columnSize e.g. 10,2 var getPrecision = function(columnSize) { var precision = columnSize.split(',')[0]; return parseInt(precision, 10); }; // get scale from columnSize e.g. 10,2 var getScale = function(columnSize) { var scale = columnSize.split(',')[1]; return parseInt(scale, 10); }; var decodeIndexColumnNames = function(columnNames) { var columnNamesSplit = columnNames.split('`'); var indexColumnNames = []; var k; udebug.log_detail('decodeIndexColumnNames columnNamesSplit: ', columnNamesSplit.length, ' ', columnNamesSplit); for (k = 1; k < columnNamesSplit.length; k += 2) { indexColumnNames.push(columnNamesSplit[k]); } udebug.log_detail('decodeIndexColumnNames indexColumnNames:', indexColumnNames); return indexColumnNames; }; var convertColumnNamesToNumbers = function(columnNames, columns) { var result = []; var i, j; for (i = 0; i < columnNames.length; ++i) { udebug.log_detail('convertColumnNamesToNumbers looking for: ', columnNames[i]); for (j = 0; j < columns.length; ++j) { if (columnNames[i] === columns[j].name) { result.push(j); break; } } } return result; }; var parseCreateTable = function(tableName, statement) { udebug.log_detail('parseCreateTable: ', statement); var columns = []; var indexes = []; var foreignKeys = []; // PRIMARY unique index must be the first index indexes.push({'name': 'PRIMARY PLACEHOLDER'}); var index, indexName, usingHash; var result = {'name' : tableName, 'database' : databaseName, 'columns' : columns, 'indexes' : indexes, 'foreignKeys': foreignKeys }; // split lines by '\n' var lines = statement.split('\n'); var i; var foreignKey, foreignKeyName, foreignKeyColumnNames, foreignKeyColumnNumbers; var foreignKeyTarget, foreignKeyTargetTable, foreignKeyTargetDatabase, foreignKeyTargetWithDatabase; var foreignKeyTargetColumnNames, foreignKeyTargetColumnNumbers; var columnNumber = 0; var columnNames, indexColumnNames, indexColumnNumbers; var column, columnName, columnNumberIndex, columnTypeAndSize, columnTypeAndSizeSplit, columnSize, columnType, unsigned, nullable; // first line has table name which we ignore because we already know it for (i = 1; i < lines.length; ++i) { var defaultValue; // if DEFAULT is not specified, defaultValue is undefined var rawDefaultValue; // if DEFAULT is specified, this is the raw text following DEFAULT var line = lines[i]; if (line[line.length - 1] === ',') { // remove trailing comma from line line = line.substr(0, line.length - 1); } udebug.log_detail('\n parseCreateTable:', line); var tokens = line.split(' '); var j = 0; // index into tokens in the line var token = tokens[j]; // remove empty tokens while (token.length === 0) { token = tokens[++j]; } var unique = false; udebug.log_detail('parseCreateTable token:', token); switch (token) { case 'PRIMARY': // found primary key definition j+= 2; // skip 'PRIMARY KEY' index = {}; index.name = 'PRIMARY'; udebug.log_detail('parseCreateTable PRIMARY:', token); index.isPrimaryKey = true; index.isUnique = true; index.isOrdered = true; columnNames = tokens[j]; indexColumnNames = decodeIndexColumnNames(columnNames); udebug.log_detail('parseCreateTable PRIMARY indexColumnNames:', indexColumnNames); indexColumnNumbers = convertColumnNamesToNumbers(indexColumnNames, result.columns); udebug.log_detail('parseCreateTable PRIMARY indexColumnNumbers: ', indexColumnNumbers); index.columnNumbers = indexColumnNumbers; // mark primary key index columns with 'isInPrimaryKey' for (columnNumberIndex = 0; columnNumberIndex < indexColumnNumbers.length; ++columnNumberIndex) { columnNumber = indexColumnNumbers[columnNumberIndex]; column = columns[columnNumber]; udebug.log_detail('parseCreateTable marking column', columnNumber, columns[columnNumber].name); column.isInPrimaryKey = true; } indexes[0] =index; break; case 'UNIQUE': // found unique key definition udebug.log_detail('parseCreateTable UNIQUE:', token); unique = true; ++j; // continue with KEY handling case 'KEY': ++j; // found key definition, same as unique index = {}; indexName = tokens[j].split('`')[1]; index.name = indexName; if (unique) { index.isUnique = true; } // get column names columnNames = tokens[++j]; indexColumnNames = decodeIndexColumnNames(columnNames); udebug.log_detail('parseCreateTable KEY indexColumnNames:', indexColumnNames); indexColumnNumbers = convertColumnNamesToNumbers(indexColumnNames, result.columns); udebug.log_detail('parseCreateTable KEY indexColumnNumbers:', indexColumnNumbers); index.columnNumbers = indexColumnNumbers; usingHash = false; // get using statement if (++j < tokens.length) { // more tokens usingHash = -1 !== tokens[++j].indexOf('HASH'); } if (!usingHash) { // TODO create two index objects for unique btree index index.isOrdered = true; } udebug.log_detail('parseCreateTable for ', indexName, 'KEY USING HASH:', usingHash); indexes.push(index); break; case ')': // TODO found engine; get default charset break; case 'CONSTRAINT': foreignKey = {}; ++j; foreignKeyName = tokens[j++].split('`')[1]; // remove surrounding ticks foreignKey.name = foreignKeyName; // verify it is a FOREIGN KEY if (tokens[j] !== 'FOREIGN') { // unknown CONSTRAINT type; ignore it for now udebug.log_detail('ignoring unknown CONSTRAINT type: ', tokens[j], tokens[j+1], '...'); break; } j += 1; // skip past FOREIGN columnNames = tokens[j]; foreignKeyColumnNames = decodeIndexColumnNames(columnNames); udebug.log_detail('parseCreateTable FOREIGN KEY foreignKeyColumnNames:', foreignKeyColumnNames); foreignKey.columnNames = foreignKeyColumnNames; j += 1; // skip past (`columnName`, ...) if (tokens[j] !== 'REFERENCES') { // error udebug.log_detail('unexpected missing REFERENCES clause for FOREIGN KEY', tokens[j], tokens[j+1], tokens[j+2]); break; } j += 1; // skip past REFERENCES foreignKeyTargetWithDatabase = tokens[j].split('.'); // split database and table from `database`.`table` if (foreignKeyTargetWithDatabase.length == 2) { foreignKeyTargetDatabase = foreignKeyTargetWithDatabase[0].split('`')[1]; // remove surrounding ticks foreignKeyTargetTable = foreignKeyTargetWithDatabase[1].split('`')[1]; // remove surrounding ticks } else { foreignKeyTargetDatabase = databaseName; foreignKeyTargetTable = foreignKeyTargetWithDatabase[0].split('`')[1]; // remove surrounding ticks } foreignKey.targetDatabase = foreignKeyTargetDatabase; foreignKey.targetTable = foreignKeyTargetTable; j += 1; // skip past target table name columnNames = tokens[j]; foreignKeyTargetColumnNames = decodeIndexColumnNames(columnNames); udebug.log_detail('parseCreateTable REFERENCES foreignKeyTargetColumnNames:', foreignKeyTargetColumnNames); foreignKey.targetColumnNames = foreignKeyTargetColumnNames; foreignKeys.push(foreignKey); break; default: // found column definition nullable = true; // default if no 'NOT NULL' clause unsigned = false; // default if no 'unsigned' clause column = {}; column.columnNumber = columnNumber++; // decode the column name columnName = (token.split('`'))[1]; udebug.log_detail('parseCreateTable: columnName:', columnName); column.name = columnName; // analyze column type columnTypeAndSize = tokens[++j]; udebug.log_detail('parseCreateTable: columnDefinition:', columnTypeAndSize); columnTypeAndSizeSplit = columnTypeAndSize.split('('); columnType = columnTypeAndSizeSplit[0]; udebug.log_detail('parseCreateTable for: ', columnName, ': columnType: ', columnType); column.columnType = columnType.toLocaleUpperCase(); if (columnTypeAndSizeSplit.length > 1) { columnSize = columnTypeAndSizeSplit[1].split(')')[0]; udebug.log_detail('parseCreateTable for: ', columnName, ': columnSize: ', columnSize); } ++j; // check for unsigned if (tokens[j] === 'unsigned') { unsigned = true; ++j; } udebug.log_detail('parseCreateTable for:', columnName, ': unsigned: ', unsigned); column.isUnsigned = unsigned; // add extra metadata specific to type switch (columnType) { case 'tinyint': column.intSize = 1; column.isIntegral = true; break; case 'smallint': column.intSize = 2; column.isIntegral = true; break; case 'mediumint': column.intSize = 3; column.isIntegral = true; break; case 'int': column.intSize = 4; column.isIntegral = true; break; case 'bigint': column.intSize = 8; column.isIntegral = true; break; case 'decimal' : column.precision = getPrecision(columnSize); column.scale = getScale(columnSize); break; case 'binary': case 'varbinary': column.isBinary = true; column.length = parseInt(columnSize, 10); break; case 'char': case 'varchar': column.length = parseInt(columnSize, 10); break; case 'blob': column.isBinary = true; break; case 'bit': column.length = parseInt(columnSize, 10); column.isIntegral = true; break; default: } // set the a database type converter for the column type var databaseTypeConverter = dbConnectionPool.getDatabaseTypeConverter(column.columnType); if (databaseTypeConverter) { column.databaseTypeConverter = {}; column.databaseTypeConverter.mysql = databaseTypeConverter; } // set the default domain type converter for the column type // this may be overridden by the user's domain type converter var domainTypeConverter = dbConnectionPool.getDomainTypeConverter(column.columnType); if (domainTypeConverter) { column.domainTypeConverter = domainTypeConverter; } // continue parsing the rest of the column definition line // check for character set if (tokens[j] === 'CHARACTER') { var charset = tokens[j + 2]; udebug.log_detail('parseCreateTable for:', columnName, ': charset: ', charset); j += 3; // skip 'CHARACTER SET charset' column.charsetName = charset; // check for collation if (tokens[j] === 'COLLATE') { var collation = tokens[j + 1]; udebug.log_detail('parseCreateTable for: ', columnName, ': collation: ', collation); column.collationName = collation; j+= 2; // skip 'COLLATE collation' } } if (tokens[j] === 'NOT') { // 'NOT NULL' clause nullable = false; j += 2; // skip 'not null' } udebug.log_detail('parseCreateTable for: ', columnName, ' NOT NULL: ', !nullable); column.isNullable = nullable; if (tokens[j] === 'DEFAULT') { rawDefaultValue = tokens[j + 1]; if (rawDefaultValue === 'NULL') { // default value is null defaultValue = null; } else { // default value is a quoted string, so separate by \' // this will return the first (and presumed only) quoted string in the line rawDefaultValue = line.split('\'')[1]; if (column.isIntegral) { defaultValue = parseInt(rawDefaultValue, 10); } else { defaultValue = rawDefaultValue; } } udebug.log_detail('parseCreateTable for:', columnName, 'DEFAULT:', rawDefaultValue, 'defaultValue:', typeof(defaultValue), defaultValue); // add defaultValue to model column.defaultValue = defaultValue; j += 2; // skip 'DEFAULT ' } if (tokens[j] === 'AUTO_INCREMENT') { column.isAutoincrement = true; j++; // skip 'AUTO_INCREMENT' } // add the column description metadata columns.push(column); break; } } // for each index that is both unique and ordered, make one ordered and a second index unique var ordered; for (i = 0; i < result.indexes.length; ++i) { index = result.indexes[i]; if (index.isUnique && index.isOrdered) { index.isOrdered = false; ordered = {}; ordered.isOrdered = true; ordered.isUnique = false; ordered.name = index.name; ordered.columnNames = index.columnNames; ordered.indexColumnNames = index.indexColumnNames; ordered.indexColumnNumbers = index.indexColumnNumbers; ordered.columnNumbers = index.columnNumbers; udebug.log_detail('MySQLDictionary creating second ordered index from unique btree index', index.name); indexes.push(ordered); } } return result; }; var callback = user_callback; var showCreateTable_callback = function(err, rows) { var result; if (err) { udebug.log_detail('MySQLDictonary error from SHOW CREATE TABLE: ' + err); callback(err); } else { udebug.log_detail(rows); var row = rows[0]; // result of show create table is of the form: // [ { Table: 'tbl1', // 'Create Table': 'CREATE TABLE `tbl1` (\n `i` int(11) NOT NULL,\n `j` int(11) DEFAULT NULL,\n PRIMARY KEY (`i`)\n) ENGINE=ndbcluster DEFAULT CHARSET=latin1' } ] // the create table statement is the attribute named 'Create Table' var createTableStatement = row['Create Table']; var metadata = parseCreateTable(tableName, createTableStatement); udebug.log_detail('showCreateTable_callback.forEach metadata:', metadata); result = metadata; callback(null, result); } }; this.connection.query('show create table ' + databaseName + '.' + tableName, showCreateTable_callback); }; /* SQL DDL Utilities */ exports.MetadataManager = function() { function runSQL(connectionProperties, sqlPath, callback) { /* prepend the file containing the engine.sql (ndb.sql or innodb.sql) to the file containing the sql commands */ var engine = "ndb"; if(connectionProperties.mysql_storage_engine) { engine = connectionProperties.mysql_storage_engine; } var enginesqlPath = path.join(mynode.fs.suites_dir, engine + '.sql '); var cmd = 'cat ' + enginesqlPath + ' ' + sqlPath + ' | mysql'; var p = connectionProperties; function childProcess(error, stdout, stderr) { udebug.log_detail('child process completed.'); udebug.log_detail('stdout: ' + stdout); udebug.log_detail('stderr: ' + stderr); if (error !== null) { udebug.log('exec error: ' + error); } else { udebug.log_detail('exec OK'); } if(callback) { callback(error); } } if(p) { if(p.mysql_socket) { cmd += " --socket=" + p.mysql_socket; } else if(p.mysql_port) { cmd += " --port=" + p.mysql_port; } if(p.mysql_host) { cmd += " -h " + p.mysql_host; } if(p.mysql_user) { cmd += " -u " + p.mysql_user; } if(p.mysql_password) { cmd += " --password=" + p.mysql_password; } } udebug.log_detail('harness runSQL forking process...' + cmd); var child = child_process.exec(cmd, childProcess); } this.createTestTables = function(connectionProperties, suiteName, callback) { udebug.log("createTestTables", suiteName); var sqlPath = path.join(mynode.fs.suites_dir, suiteName, 'create.sql'); runSQL(connectionProperties, sqlPath, callback); }; this.dropTestTables = function(connectionProperties, suiteName, callback) { udebug.log("dropTestTables", suiteName); var sqlPath = path.join(mynode.fs.suites_dir, suiteName, 'drop.sql'); runSQL(connectionProperties, sqlPath, callback); }; };