. */ #namespace Doctrine::DBAL::Schema; /** * xxx * * @license http://www.opensource.org/licenses/lgpl-license.php LGPL * @author Konsta Vesterinen * @author Lukas Smith (PEAR MDB2 library) * @version $Revision$ * @since 2.0 */ class Doctrine_Schema_OracleSchemaManager extends Doctrine_Schema_SchemaManager { public function __construct(Doctrine_Connection_Oracle $conn) { $this->_conn = $conn; } /** * create a new database * * @param object $db database object that is extended by this class * @param string $name name of the database that should be created * @return mixed MDB2_OK on success, a MDB2 error on failure * @access public */ public function createDatabase($name) { if ( ! $this->conn->getAttribute(Doctrine::ATTR_EMULATE_DATABASE)) throw new Doctrine_Export_Exception('database creation is only supported if the "emulate_database" attribute is enabled'); $username = sprintf($this->conn->getAttribute(Doctrine::ATTR_DB_NAME_FORMAT), $name); $password = $this->conn->dsn['password'] ? $this->conn->dsn['password'] : $name; $tablespace = $this->conn->getAttribute(Doctrine::ATTR_DB_NAME_FORMAT) ? ' DEFAULT TABLESPACE '.$this->conn->options['default_tablespace'] : ''; $query = 'CREATE USER ' . $username . ' IDENTIFIED BY ' . $password . $tablespace; $result = $this->conn->exec($query); try { $query = 'GRANT CREATE SESSION, CREATE TABLE, UNLIMITED TABLESPACE, CREATE SEQUENCE, CREATE TRIGGER TO ' . $username; $result = $this->conn->exec($query); } catch (Exception $e) { $query = 'DROP USER '.$username.' CASCADE'; $result2 = $this->conn->exec($query); } return true; } /** * drop an existing database * * @param object $this->conn database object that is extended by this class * @param string $name name of the database that should be dropped * @return mixed MDB2_OK on success, a MDB2 error on failure * @access public */ public function dropDatabase($name) { if ( ! $this->conn->getAttribute(Doctrine::ATTR_EMULATE_DATABASE)) throw new Doctrine_Export_Exception('database dropping is only supported if the "emulate_database" option is enabled'); $username = sprintf($this->conn->getAttribute(Doctrine::ATTR_DB_NAME_FORMAT), $name); return $this->conn->exec('DROP USER ' . $username . ' CASCADE'); } /** * add an autoincrement sequence + trigger * * @param string $name name of the PK field * @param string $table name of the table * @param string $start start value for the sequence * @return mixed MDB2_OK on success, a MDB2 error on failure * @access private */ public function _makeAutoincrement($name, $table, $start = 1) { $sql = array(); $table = strtoupper($table); $indexName = $table . '_AI_PK'; $definition = array( 'primary' => true, 'fields' => array($name => true), ); $sql[] = $this->createConstraintSql($table, $indexName, $definition); if (is_null($start)) { $query = 'SELECT MAX(' . $this->conn->quoteIdentifier($name, true) . ') FROM ' . $this->conn->quoteIdentifier($table, true); $start = $this->conn->fetchOne($query); ++$start; } $sql[] = $this->createSequenceSql($table, $start); $sequenceName = $this->conn->formatter->getSequenceName($table); $triggerName = $this->conn->quoteIdentifier($table . '_AI_PK', true); $table = $this->conn->quoteIdentifier($table, true); $name = $this->conn->quoteIdentifier($name, true); $sql[] = 'CREATE TRIGGER ' . $triggerName . ' BEFORE INSERT ON '.$table.' FOR EACH ROW DECLARE last_Sequence NUMBER; last_InsertID NUMBER; BEGIN SELECT '.$sequenceName.'.NEXTVAL INTO :NEW.'.$name.' FROM DUAL; IF (:NEW.'.$name.' IS NULL OR :NEW.'.$name.' = 0) THEN SELECT '.$sequenceName.'.NEXTVAL INTO :NEW.'.$name.' FROM DUAL; ELSE SELECT NVL(Last_Number, 0) INTO last_Sequence FROM User_Sequences WHERE UPPER(Sequence_Name) = UPPER(\''.$sequenceName.'\'); SELECT :NEW.id INTO last_InsertID FROM DUAL; WHILE (last_InsertID > last_Sequence) LOOP SELECT ' . $sequenceName . '.NEXTVAL INTO last_Sequence FROM DUAL; END LOOP; END IF; END; '; return $sql; } /** * drop an existing autoincrement sequence + trigger * * @param string $table name of the table * @return void */ public function dropAutoincrement($table) { $table = strtoupper($table); $triggerName = $table . '_AI_PK'; $trigger_name_quoted = $this->conn->quote($triggerName); $query = 'SELECT trigger_name FROM user_triggers'; $query.= ' WHERE trigger_name='.$trigger_name_quoted.' OR trigger_name='.strtoupper($trigger_name_quoted); $trigger = $this->conn->fetchOne($query); if ($trigger) { $trigger_name = $this->conn->quoteIdentifier($table . '_AI_PK', true); $trigger_sql = 'DROP TRIGGER ' . $trigger_name; // if throws exception, trigger for autoincrement PK could not be dropped $this->conn->exec($trigger_sql); // if throws exception, sequence for autoincrement PK could not be dropped $this->dropSequence($table); $indexName = $table . '_AI_PK'; // if throws exception, primary key for autoincrement PK could not be dropped $this->dropConstraint($table, $indexName); } } /** * A method to return the required SQL string that fits between CREATE ... TABLE * to create the table as a temporary table. * * @return string The string required to be placed between "CREATE" and "TABLE" * to generate a temporary table, if possible. */ public function getTemporaryTableQuery() { return 'GLOBAL TEMPORARY'; } /** * getAdvancedForeignKeyOptions * Return the FOREIGN KEY query section dealing with non-standard options * as MATCH, INITIALLY DEFERRED, ON UPDATE, ... * * @param array $definition foreign key definition * @return string * @access protected */ public function getAdvancedForeignKeyOptions(array $definition) { $query = ''; if (isset($definition['onDelete'])) { $query .= ' ON DELETE ' . $definition['onDelete']; } if (isset($definition['deferrable'])) { $query .= ' DEFERRABLE'; } else { $query .= ' NOT DEFERRABLE'; } if (isset($definition['feferred'])) { $query .= ' INITIALLY DEFERRED'; } else { $query .= ' INITIALLY IMMEDIATE'; } return $query; } /** * create a new table * * @param string $name Name of the database that should be created * @param array $fields Associative array that contains the definition of each field of the new table * The indexes of the array entries are the names of the fields of the table an * the array entry values are associative arrays like those that are meant to be * passed with the field definitions to get[Type]Declaration() functions. * * Example * array( * * 'id' => array( * 'type' => 'integer', * 'unsigned' => 1 * 'notnull' => 1 * 'default' => 0 * ), * 'name' => array( * 'type' => 'text', * 'length' => 12 * ), * 'password' => array( * 'type' => 'text', * 'length' => 12 * ) * ); * @param array $options An associative array of table options: * * @return void */ public function createTable($name, array $fields, array $options = array()) { $this->conn->beginTransaction(); foreach ($this->createTableSql($name, $fields, $options) as $sql) { $this->conn->exec($sql); } $this->conn->commit(); } /** * create a new table * * @param string $name Name of the database that should be created * @param array $fields Associative array that contains the definition of each field of the new table * The indexes of the array entries are the names of the fields of the table an * the array entry values are associative arrays like those that are meant to be * passed with the field definitions to get[Type]Declaration() functions. * * Example * array( * * 'id' => array( * 'type' => 'integer', * 'unsigned' => 1 * 'notnull' => 1 * 'default' => 0 * ), * 'name' => array( * 'type' => 'text', * 'length' => 12 * ), * 'password' => array( * 'type' => 'text', * 'length' => 12 * ) * ); * @param array $options An associative array of table options: * * @return void */ public function createTableSql($name, array $fields, array $options = array()) { $sql = parent::createTableSql($name, $fields, $options); foreach ($fields as $fieldName => $field) { if (isset($field['autoincrement']) && $field['autoincrement'] || (isset($field['autoinc']) && $fields['autoinc'])) { $sql = array_merge($sql, $this->_makeAutoincrement($fieldName, $name)); } } return $sql; } /** * drop an existing table * * @param string $name name of the table that should be dropped * @return void */ public function dropTable($name) { //$this->conn->beginNestedTransaction(); $result = $this->dropAutoincrement($name); $result = parent::dropTable($name); //$this->conn->completeNestedTransaction(); return $result; } /** * alter an existing table * * @param string $name name of the table that is intended to be changed. * @param array $changes associative array that contains the details of each type * of change that is intended to be performed. The types of * changes that are currently supported are defined as follows: * * name * * New name for the table. * * add * * Associative array with the names of fields to be added as * indexes of the array. The value of each entry of the array * should be set to another associative array with the properties * of the fields to be added. The properties of the fields should * be the same as defined by the MDB2 parser. * * * remove * * Associative array with the names of fields to be removed as indexes * of the array. Currently the values assigned to each entry are ignored. * An empty array should be used for future compatibility. * * rename * * Associative array with the names of fields to be renamed as indexes * of the array. The value of each entry of the array should be set to * another associative array with the entry named name with the new * field name and the entry named Declaration that is expected to contain * the portion of the field declaration already in DBMS specific SQL code * as it is used in the CREATE TABLE statement. * * change * * Associative array with the names of the fields to be changed as indexes * of the array. Keep in mind that if it is intended to change either the * name of a field and any other properties, the change array entries * should have the new names of the fields as array indexes. * * The value of each entry of the array should be set to another associative * array with the properties of the fields to that are meant to be changed as * array entries. These entries should be assigned to the new values of the * respective properties. The properties of the fields should be the same * as defined by the MDB2 parser. * * Example * array( * 'name' => 'userlist', * 'add' => array( * 'quota' => array( * 'type' => 'integer', * 'unsigned' => 1 * ) * ), * 'remove' => array( * 'file_limit' => array(), * 'time_limit' => array() * ), * 'change' => array( * 'name' => array( * 'length' => '20', * 'definition' => array( * 'type' => 'text', * 'length' => 20, * ), * ) * ), * 'rename' => array( * 'sex' => array( * 'name' => 'gender', * 'definition' => array( * 'type' => 'text', * 'length' => 1, * 'default' => 'M', * ), * ) * ) * ) * * @param boolean $check indicates whether the function should just check if the DBMS driver * can perform the requested table alterations if the value is true or * actually perform them otherwise. * @return void */ public function alterTable($name, array $changes, $check = false) { foreach ($changes as $changeName => $change) { switch ($changeName) { case 'add': case 'remove': case 'change': case 'name': case 'rename': break; default: throw new Doctrine_Export_Exception('change type "' . $changeName . '" not yet supported'); } } if ($check) { return false; } $name = $this->conn->quoteIdentifier($name, true); if ( ! empty($changes['add']) && is_array($changes['add'])) { $fields = array(); foreach ($changes['add'] as $fieldName => $field) { $fields[] = $this->conn->getDeclaration($fieldName, $field); } $result = $this->conn->exec('ALTER TABLE ' . $name . ' ADD (' . implode(', ', $fields) . ')'); } if ( ! empty($changes['change']) && is_array($changes['change'])) { $fields = array(); foreach ($changes['change'] as $fieldName => $field) { $fields[] = $fieldName. ' ' . $this->conn->getDeclaration('', $field['definition']); } $result = $this->conn->exec('ALTER TABLE ' . $name . ' MODIFY (' . implode(', ', $fields) . ')'); } if ( ! empty($changes['rename']) && is_array($changes['rename'])) { foreach ($changes['rename'] as $fieldName => $field) { $query = 'ALTER TABLE ' . $name . ' RENAME COLUMN ' . $this->conn->quoteIdentifier($fieldName, true) . ' TO ' . $this->conn->quoteIdentifier($field['name']); $result = $this->conn->exec($query); } } if ( ! empty($changes['remove']) && is_array($changes['remove'])) { $fields = array(); foreach ($changes['remove'] as $fieldName => $field) { $fields[] = $this->conn->quoteIdentifier($fieldName, true); } $result = $this->conn->exec('ALTER TABLE ' . $name . ' DROP COLUMN ' . implode(', ', $fields)); } if ( ! empty($changes['name'])) { $changeName = $this->conn->quoteIdentifier($changes['name'], true); $result = $this->conn->exec('ALTER TABLE ' . $name . ' RENAME TO ' . $changeName); } } /** * create sequence * * @param string $seqName name of the sequence to be created * @param string $start start value of the sequence; default is 1 * @param array $options An associative array of table options: * array( * 'comment' => 'Foo', * 'charset' => 'utf8', * 'collate' => 'utf8_unicode_ci', * ); * @return string */ public function createSequenceSql($seqName, $start = 1, array $options = array()) { $sequenceName = $this->_conn->quoteIdentifier($this->_conn->formatter->getSequenceName($seqName), true); $query = 'CREATE SEQUENCE ' . $sequenceName . ' START WITH ' . $start . ' INCREMENT BY 1 NOCACHE'; $query .= ($start < 1 ? ' MINVALUE ' . $start : ''); return $query; } /** * drop existing sequence * * @param object $this->_conn database object that is extended by this class * @param string $seqName name of the sequence to be dropped * @return string */ public function dropSequenceSql($seqName) { $sequenceName = $this->_conn->quoteIdentifier($this->_conn->formatter->getSequenceName($seqName), true); return 'DROP SEQUENCE ' . $sequenceName; } /** * lists all databases * * @return array */ public function listDatabases() { if ( ! $this->_conn->getAttribute(Doctrine::ATTR_EMULATE_DATABASE)) { throw new Doctrine_Import_Exception('database listing is only supported if the "emulate_database" option is enabled'); } /** if ($this->_conn->options['database_name_prefix']) { $query = 'SELECT SUBSTR(username, '; $query.= (strlen($this->_conn->getAttribute(['database_name_prefix'])+1); $query.= ") FROM sys.dba_users WHERE username LIKE '"; $query.= $this->_conn->options['database_name_prefix']."%'"; } else { */ $query = 'SELECT username FROM sys.dba_users'; $result2 = $this->_conn->standaloneQuery($query); $result = $result2->fetchColumn(); return $result; } /** * lists all availible database functions * * @return array */ public function listFunctions() { $query = "SELECT name FROM sys.user_source WHERE line = 1 AND type = 'FUNCTION'"; return $this->_conn->fetchColumn($query); } /** * lists all database triggers * * @param string|null $database * @return array */ public function listTriggers($database = null) { } /** * lists all database sequences * * @param string|null $database * @return array */ public function listSequences($database = null) { $query = "SELECT sequence_name FROM sys.user_sequences"; $tableNames = $this->_conn->fetchColumn($query); return array_map(array($this->_conn->formatter, 'fixSequenceName'), $tableNames); } /** * lists table constraints * * @param string $table database table name * @return array */ public function listTableConstraints($table) { $table = $this->_conn->quote($table, 'text'); $query = 'SELECT index_name name FROM user_constraints' . ' WHERE table_name = ' . $table . ' OR table_name = ' . strtoupper($table); $constraints = $this->_conn->fetchColumn($query); return array_map(array($this->_conn->formatter, 'fixIndexName'), $constraints); } /** * lists table constraints * * @param string $table database table name * @return array */ public function listTableColumns($table) { $table = strtoupper($table); $sql = "SELECT column_name, data_type, data_length, nullable, data_default, data_scale, data_precision FROM all_tab_columns" . " WHERE table_name = '" . $table . "' ORDER BY column_name"; $result = $this->_conn->fetchAssoc($sql); $descr = array(); foreach($result as $val) { $val = array_change_key_case($val, CASE_LOWER); $decl = $this->_conn->dataDict->getPortableDeclaration($val); $descr[$val['column_name']] = array( 'name' => $val['column_name'], 'notnull' => (bool) ($val['nullable'] === 'N'), 'ntype' => $val['data_type'], 'type' => $decl['type'][0], 'alltypes' => $decl['type'], 'fixed' => $decl['fixed'], 'unsigned' => $decl['unsigned'], 'default' => $val['data_default'], 'length' => $val['data_length'], 'precision' => $val['data_precision'], 'scale' => $val['scale'], ); } return $descr; } /** * lists table constraints * * @param string $table database table name * @return array */ public function listTableIndexes($table) { $table = $this->_conn->quote($table, 'text'); $query = 'SELECT index_name name FROM user_indexes' . ' WHERE table_name = ' . $table . ' OR table_name = ' . strtoupper($table) . ' AND generated = ' . $this->_conn->quote('N', 'text'); $indexes = $this->_conn->fetchColumn($query); return array_map(array($this->_conn->formatter, 'fixIndexName'), $indexes); } /** * lists tables * * @param string|null $database * @return array */ public function listTables($database = null) { $query = 'SELECT table_name FROM sys.user_tables'; return $this->_conn->fetchColumn($query); } /** * lists table triggers * * @param string $table database table name * @return array */ public function listTableTriggers($table) { } /** * lists table views * * @param string $table database table name * @return array */ public function listTableViews($table) { } /** * lists database users * * @return array */ public function listUsers() { /** if ($this->_conn->options['emulate_database'] && $this->_conn->options['database_name_prefix']) { $query = 'SELECT SUBSTR(username, '; $query.= (strlen($this->_conn->options['database_name_prefix'])+1); $query.= ") FROM sys.dba_users WHERE username NOT LIKE '"; $query.= $this->_conn->options['database_name_prefix']."%'"; } else { */ $query = 'SELECT username FROM sys.dba_users'; //} return $this->_conn->fetchColumn($query); } /** * lists database views * * @param string|null $database * @return array */ public function listViews($database = null) { $query = 'SELECT view_name FROM sys.user_views'; return $this->_conn->fetchColumn($query); } } ?>