* @link http://www.yiiframework.com/ * @copyright Copyright © 2008-2009 Yii Software LLC * @license http://www.yiiframework.com/license/ */ /** * CPgsqlSchema is the class for retrieving metadata information from a PostgreSQL database. * * @author Qiang Xue * @version $Id$ * @package system.db.schema.pgsql * @since 1.0 */ class CPgsqlSchema extends CDbSchema { const DEFAULT_SCHEMA='public'; private $_sequences=array(); /** * Quotes a table name for use in a query. * @param string table name * @return string the properly quoted table name */ public function quoteTableName($name) { return '"'.$name.'"'; } /** * Resets the sequence value of a table's primary key. * The sequence will be reset such that the primary key of the next new row inserted * will have the specified value or 1. * @param CDbTableSchema the table schema whose primary key sequence will be reset * @param mixed the value for the primary key of the next new row inserted. If this is not set, * the next new row's primary key will have a value 1. * @since 1.1 */ public function resetSequence($table,$value=null) { if($table->sequenceName!==null) { $seq='"'.$table->sequenceName.'"'; if(strpos($seq,'.')!==false) $seq=str_replace('.','"."',$seq); if($value===null) $value="(SELECT COALESCE(MAX(\"{$table->primaryKey}\"),0) FROM {$table->rawName}) + 1"; else $value=(int)$value; $this->getDbConnection()->createCommand("SELECT SETVAL('$seq', $value, false)")->execute(); } } /** * Enables or disables integrity check. * @param boolean whether to turn on or off the integrity check. * @param string the schema of the tables. Defaults to empty string, meaning the current or default schema. * @since 1.1 */ public function checkIntegrity($check=true,$schema='') { $enable=$check ? 'ENABLE' : 'DISABLE'; $tableNames=$this->getTableNames($schema); $db=$this->getDbConnection(); foreach($tableNames as $tableName) { $tableName='"'.$tableName.'"'; if(strpos($tableName,'.')!==false) $tableName=str_replace('.','"."',$tableName); $db->createCommand("ALTER TABLE $tableName $enable TRIGGER ALL")->execute(); } } /** * Creates a table instance representing the metadata for the named table. * @return CDbTableSchema driver dependent table metadata. */ protected function createTable($name) { $table=new CPgsqlTableSchema; $this->resolveTableNames($table,$name); if(!$this->findColumns($table)) return null; $this->findConstraints($table); if(is_string($table->primaryKey) && isset($this->_sequences[$table->primaryKey])) $table->sequenceName=$this->_sequences[$table->primaryKey]; else if(is_array($table->primaryKey)) { foreach($table->primaryKey as $pk) { if(isset($this->_sequences[$pk])) { $table->sequenceName=$this->_sequences[$pk]; break; } } } return $table; } /** * Generates various kinds of table names. * @param CPgsqlTableSchema the table instance * @param string the unquoted table name */ protected function resolveTableNames($table,$name) { $parts=explode('.',str_replace('"','',$name)); if(isset($parts[1])) { $schemaName=$parts[0]; $tableName=$parts[1]; } else { $schemaName=self::DEFAULT_SCHEMA; $tableName=$parts[0]; } $table->name=$tableName; $table->schemaName=$schemaName; if($schemaName===self::DEFAULT_SCHEMA) $table->rawName=$this->quoteTableName($tableName); else $table->rawName=$this->quoteTableName($schemaName).'.'.$this->quoteTableName($tableName); } /** * Collects the table column metadata. * @param CPgsqlTableSchema the table metadata * @return boolean whether the table exists in the database */ protected function findColumns($table) { $sql=<< 0 AND NOT a.attisdropped AND a.attrelid = (SELECT oid FROM pg_catalog.pg_class WHERE relname=:table AND relnamespace = (SELECT oid FROM pg_catalog.pg_namespace WHERE nspname = :schema)) ORDER BY a.attnum EOD; $command=$this->getDbConnection()->createCommand($sql); $command->bindValue(':table',$table->name); $command->bindValue(':schema',$table->schemaName); if(($columns=$command->queryAll())===array()) return false; foreach($columns as $column) { $c=$this->createColumn($column); $table->columns[$c->name]=$c; if(stripos($column['adsrc'],'nextval')===0 && preg_match('/nextval\([^\']*\'([^\']+)\'[^\)]*\)/i',$column['adsrc'],$matches)) { if(strpos($matches[1],'.')!==false || $table->schemaName===self::DEFAULT_SCHEMA) $this->_sequences[$c->name]=$matches[1]; else $this->_sequences[$c->name]=$table->schemaName.'.'.$matches[1]; } } return true; } /** * Creates a table column. * @param array column metadata * @return CDbColumnSchema normalized column metadata */ protected function createColumn($column) { $c=new CPgsqlColumnSchema; $c->name=$column['attname']; $c->rawName=$this->quoteColumnName($c->name); $c->allowNull=!$column['attnotnull']; $c->isPrimaryKey=false; $c->isForeignKey=false; $c->init($column['type'],$column['atthasdef'] ? $column['adsrc'] : null); return $c; } /** * Collects the primary and foreign key column details for the given table. * @param CPgsqlTableSchema the table metadata */ protected function findConstraints($table) { $sql=<<getDbConnection()->createCommand($sql); $command->bindValue(':table',$table->name); $command->bindValue(':schema',$table->schemaName); foreach($command->queryAll() as $row) { if($row['contype']==='p') // primary key $this->findPrimaryKey($table,$row['indkey']); else if($row['contype']==='f') // foreign key $this->findForeignKey($table,$row['consrc']); } } /** * Collects primary key information. * @param CPgsqlTableSchema the table metadata * @param string pgsql primary key index list */ protected function findPrimaryKey($table,$indices) { $indices=implode(', ',preg_split('/\s+/',$indices)); $sql=<<getDbConnection()->createCommand($sql); $command->bindValue(':table',$table->name); $command->bindValue(':schema',$table->schemaName); foreach($command->queryAll() as $row) { $name=$row['attname']; if(isset($table->columns[$name])) { $table->columns[$name]->isPrimaryKey=true; if($table->primaryKey===null) $table->primaryKey=$name; else if(is_string($table->primaryKey)) $table->primaryKey=array($table->primaryKey,$name); else $table->primaryKey[]=$name; } } } /** * Collects foreign key information. * @param CPgsqlTableSchema the table metadata * @param string pgsql foreign key definition */ protected function findForeignKey($table,$src) { $matches=array(); $brackets='\(([^\)]+)\)'; $pattern="/FOREIGN\s+KEY\s+{$brackets}\s+REFERENCES\s+([^\(]+){$brackets}/i"; if(preg_match($pattern,str_replace('"','',$src),$matches)) { $keys=preg_split('/,\s+/', $matches[1]); $tableName=$matches[2]; $fkeys=preg_split('/,\s+/', $matches[3]); foreach($keys as $i=>$key) { $table->foreignKeys[$key]=array($tableName,$fkeys[$i]); if(isset($table->columns[$key])) $table->columns[$key]->isForeignKey=true; } } } /** * Returns all table names in the database. * @return array all table names in the database. * @since 1.0.2 */ protected function findTableNames($schema='') { if($schema==='') $schema=self::DEFAULT_SCHEMA; $sql=<<getDbConnection()->createCommand($sql); $command->bindParam(':schema',$schema); $rows=$command->queryAll(); $names=array(); foreach($rows as $row) { if($schema===self::DEFAULT_SCHEMA) $names[]=$row['table_name']; else $names[]=$row['table_schema'].'.'.$row['table_name']; } return $names; } }