2 if(!defined('sugarEntry') || !sugarEntry) die('Not A Valid Entry Point');
3 /*********************************************************************************
4 * SugarCRM Community Edition is a customer relationship management program developed by
5 * SugarCRM, Inc. Copyright (C) 2004-2011 SugarCRM Inc.
7 * This program is free software; you can redistribute it and/or modify it under
8 * the terms of the GNU Affero General Public License version 3 as published by the
9 * Free Software Foundation with the addition of the following permission added
10 * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
11 * IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
12 * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
14 * This program is distributed in the hope that it will be useful, but WITHOUT
15 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
16 * FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
19 * You should have received a copy of the GNU Affero General Public License along with
20 * this program; if not, see http://www.gnu.org/licenses or write to the Free
21 * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
24 * You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
25 * SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
27 * The interactive user interfaces in modified source and object code versions
28 * of this program must display Appropriate Legal Notices, as required under
29 * Section 5 of the GNU Affero General Public License version 3.
31 * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
32 * these Appropriate Legal Notices must retain the display of the "Powered by
33 * SugarCRM" logo. If the display of the logo is not reasonably feasible for
34 * technical reasons, the Appropriate Legal Notices must display the words
35 * "Powered by SugarCRM".
36 ********************************************************************************/
38 /*********************************************************************************
40 * Description: This file handles the Data base functionality for the application.
41 * It acts as the DB abstraction layer for the application. It depends on helper classes
42 * which generate the necessary SQL. This sql is then passed to PEAR DB classes.
43 * The helper class is chosen in DBManagerFactory, which is driven by 'db_type' in 'dbconfig' under config.php.
45 * All the functions in this class will work with any bean which implements the meta interface.
46 * The passed bean is passed to helper class which uses these functions to generate correct sql.
48 * The meta interface has the following functions:
49 * getTableName() Returns table name of the object.
50 * getFieldDefinitions() Returns a collection of field definitions in order.
51 * getFieldDefintion(name) Return field definition for the field.
52 * getFieldValue(name) Returns the value of the field identified by name.
53 * If the field is not set, the function will return boolean FALSE.
54 * getPrimaryFieldDefinition() Returns the field definition for primary key
56 * The field definition is an array with the following keys:
58 * name This represents name of the field. This is a required field.
59 * type This represents type of the field. This is a required field and valid values are:
73 * length This is used only when the type is varchar and denotes the length of the string.
74 * The max value is 255.
75 * enumvals This is a list of valid values for an enum separated by "|".
76 * It is used only if the type is ?enum?;
77 * required This field dictates whether it is a required value.
78 * The default value is ?FALSE?.
79 * isPrimary This field identifies the primary key of the table.
80 * If none of the fields have this flag set to ?TRUE?,
81 * the first field definition is assume to be the primary key.
82 * Default value for this field is ?FALSE?.
83 * default This field sets the default value for the field definition.
86 * Portions created by SugarCRM are Copyright (C) SugarCRM, Inc.
87 * All Rights Reserved.
88 * Contributor(s): ______________________________________..
89 ********************************************************************************/
91 class MssqlManager extends DBManager
94 * @see DBManager::$dbType
96 public $dbType = 'mssql';
99 * @see DBManager::$backendFunctions
101 protected $backendFunctions = array(
102 'free_result' => 'mssql_free_result',
103 'close' => 'mssql_close',
104 'row_count' => 'mssql_num_rows'
109 * @see DBManager::connect()
111 public function connect(
112 array $configOptions = null,
116 global $sugar_config;
118 if (is_null($configOptions))
119 $configOptions = $sugar_config['dbconfig'];
121 //SET DATEFORMAT to 'YYYY-MM-DD''
122 ini_set('mssql.datetimeconvert', '0');
124 //set the text size and textlimit to max number so that blob columns are not truncated
125 ini_set('mssql.textlimit','2147483647');
126 ini_set('mssql.textsize','2147483647');
128 //set the connections parameters
130 $configOptions['db_host_instance'] = trim($configOptions['db_host_instance']);
131 if (empty($configOptions['db_host_instance']))
132 $connect_param = $configOptions['db_host_name'];
134 $connect_param = $configOptions['db_host_name']."\\".$configOptions['db_host_instance'];
136 //create persistent connection
137 if ($sugar_config['dbconfigoption']['persistent'] == true) {
138 $this->database =@mssql_pconnect(
140 $configOptions['db_user_name'],
141 $configOptions['db_password']
144 //if no persistent connection created, then create regular connection
145 if(!$this->database){
146 $this->database = mssql_connect(
148 $configOptions['db_user_name'],
149 $configOptions['db_password']
151 if(!$this->database){
152 $GLOBALS['log']->fatal("Could not connect to server ".$configOptions['db_host_name'].
153 " as ".$configOptions['db_user_name'].".");
154 sugar_die($GLOBALS['app_strings']['ERR_NO_DB']);
156 if($this->database && $sugar_config['dbconfigoption']['persistent'] == true){
157 $_SESSION['administrator_error'] = "<B>Severe Performance Degradation: Persistent Database Connections "
158 . "not working. Please set \$sugar_config['dbconfigoption']['persistent'] to false in your "
159 . "config.php file</B>";
162 //make sure connection exists
163 if(!$this->database){
164 sugar_die($GLOBALS['app_strings']['ERR_NO_DB']);
169 //Adding sleep and retry for mssql connection. We have come across scenarios when
170 //an error is thrown.' Unable to select database'. Following will try to connect to
171 //mssql db maximum number of 5 times at the interval of .2 second. If can not connect
172 //it will throw an Unable to select database message.
174 if(!@mssql_select_db($configOptions['db_name'], $this->database)){
178 if(@mssql_select_db($configOptions['db_name'], $this->database)){
184 $GLOBALS['log']->fatal( "Unable to select database {$configOptions['db_name']}");
185 sugar_die($GLOBALS['app_strings']['ERR_NO_DB']);
189 if($this->checkError('Could Not Connect', $dieOnError))
190 $GLOBALS['log']->info("connected to db");
192 $GLOBALS['log']->info("Connect:".$this->database);
196 * @see DBManager::version()
198 public function version()
200 return $this->getOne("SELECT @@VERSION as version");
204 * @see DBManager::checkError()
206 public function checkError(
211 if (parent::checkError($msg, $dieOnError))
214 $sqlmsg = mssql_get_last_message();
216 $sqlpos = strpos($sqlmsg, 'Changed database context to');
217 $sqlpos2 = strpos($sqlmsg, 'Warning:');
218 $sqlpos3 = strpos($sqlmsg, 'Checking identity information:');
219 if ( $sqlpos !== false || $sqlpos2 !== false || $sqlpos3 !== false )
220 $sqlmsg = ''; // empty out sqlmsg if its either of the two error messages described above
223 //ERR_MSSQL_DB_CONTEXT: localized version of 'Changed database context to' message
224 if (empty($app_strings) or !isset($app_strings['ERR_MSSQL_DB_CONTEXT'])) {
225 //ignore the message from sql-server if $app_strings array is empty. This will happen
226 //only if connection if made before languge is set.
227 $GLOBALS['log']->debug("Ignoring this database message: " . $sqlmsg);
231 $sqlpos = strpos($sqlmsg, $app_strings['ERR_MSSQL_DB_CONTEXT']);
232 if ( $sqlpos !== false )
237 if ( strlen($sqlmsg) > 2 ) {
238 $GLOBALS['log']->fatal("$msg: SQL Server error: " . $sqlmsg);
246 * @see DBManager::query()
248 public function query(
255 // Flag if there are odd number of single quotes
256 if ((substr_count($sql, "'") & 1))
257 $GLOBALS['log']->error("SQL statement[" . $sql . "] has odd number of single quotes.");
259 $this->countQuery($sql);
260 $GLOBALS['log']->info('Query:' . $sql);
261 $this->checkConnection();
262 $this->query_time = microtime(true);
264 // Bug 34892 - Clear out previous error message by checking the @@ERROR global variable
265 $errorNumberHandle = mssql_query("SELECT @@ERROR",$this->database);
266 $errorNumber = array_shift(mssql_fetch_row($errorNumberHandle));
271 $result = @mssql_query($sql, $this->database);
276 // awu Bug 10657: ignoring mssql error message 'Changed database context to' - an intermittent
277 // and difficult to reproduce error. The message is only a warning, and does
278 // not affect the functionality of the query
279 $sqlmsg = mssql_get_last_message();
280 $sqlpos = strpos($sqlmsg, 'Changed database context to');
281 $sqlpos2 = strpos($sqlmsg, 'Warning:');
282 $sqlpos3 = strpos($sqlmsg, 'Checking identity information:');
284 if ($sqlpos !== false || $sqlpos2 !== false || $sqlpos3 !== false) // if sqlmsg has 'Changed database context to', just log it
285 $GLOBALS['log']->debug($sqlmsg . ": " . $sql );
287 $GLOBALS['log']->fatal($sqlmsg . ": " . $sql );
289 sugar_die('SQL Error : ' . $sqlmsg);
291 echo 'SQL Error : ' . $sqlmsg;
294 $this->lastmysqlrow = -1;
296 $this->query_time = microtime(true) - $this->query_time;
297 $GLOBALS['log']->info('Query Execution Time:'.$this->query_time);
300 $this->checkError($msg.' Query Failed: ' . $sql, $dieOnError);
306 * This function take in the sql for a union query, the start and offset,
307 * and wraps it around an "mssql friendly" limit query
310 * @param int $start record to start at
311 * @param int $count number of records to retrieve
312 * @return string SQL statement
314 private function handleUnionLimitQuery(
320 //set the start to 0, no negs
324 $GLOBALS['log']->debug(print_r(func_get_args(),true));
326 $this->lastsql = $sql;
328 //change the casing to lower for easier string comparison, and trim whitespaces
329 $sql = strtolower(trim($sql)) ;
332 $limitUnionSQL = $sql;
333 $order_by_str = 'order by';
335 //make array of order by's. substring approach was proving too inconsistent
336 $orderByArray = explode($order_by_str, $sql);
340 //count the number of array elements
341 $unionOrderByCount = count($orderByArray);
344 //process if there are elements
345 if ($unionOrderByCount){
346 //we really want the last ordery by, so reconstruct string
347 //adding a 1 to count, as we dont wish to process the last element
349 while ($unionOrderByCount>$arr_count+1) {
350 $unionsql .= $orderByArray[$arr_count];
351 $arr_count = $arr_count+1;
352 //add an "order by" string back if we are coming into loop again
353 //remember they were taken out when array was created
354 if ($unionOrderByCount>$arr_count+1) {
355 $unionsql .= "order by";
358 //grab the last order by element, set both order by's'
359 $unionOrderBy = $orderByArray[$arr_count];
360 $rowNumOrderBy = $unionOrderBy;
362 //if last element contains a "select", then this is part of the union query,
363 //and there is no order by to use
364 if (strpos($unionOrderBy, "select")) {
366 //with no guidance on what to use for required order by in rownumber function,
367 //resort to using name column.
368 $rowNumOrderBy = 'id';
373 //there are no order by elements, so just pass back string
375 //with no guidance on what to use for required order by in rownumber function,
376 //resort to using name column.
377 $rowNumOrderBy = 'id';
380 //Unions need the column name being sorted on to match acroos all queries in Union statement
381 //so we do not want to strip the alias like in other queries. Just add the "order by" string and
382 //pass column name as is
383 if ($unionOrderBy != '') {
384 $unionOrderBy = ' order by ' . $unionOrderBy;
387 //if start is 0, then just use a top query
389 $limitUnionSQL = "select top $count * from (" .$unionsql .") as top_count ".$unionOrderBy;
392 //if start is more than 0, then use top query in conjunction
393 //with rownumber() function to create limit query.
394 $limitUnionSQL = "select top $count * from( select ROW_NUMBER() OVER ( order by "
395 .$rowNumOrderBy.") AS row_number, * from ("
396 .$unionsql .") As numbered) "
397 . "As top_count_limit WHERE row_number > $start "
401 return $limitUnionSQL;
405 * @see DBManager::limitQuery()
407 public function limitQuery(
415 $distinctSQLARRAY = array();
416 if (strpos($sql, "UNION") && !preg_match("/(\')(UNION).?(\')/i", $sql))
417 $newSQL = $this->handleUnionLimitQuery($sql,$start,$count);
421 $GLOBALS['log']->debug(print_r(func_get_args(),true));
422 $this->lastsql = $sql;
424 preg_match('/^(.*SELECT )(.*?FROM.*WHERE)(.*)$/isxU',$sql, $matches);
425 if (!empty($matches[3])) {
427 $match_two = strtolower($matches[2]);
428 if (!strpos($match_two, "distinct")> 0 && strpos($match_two, "distinct") !==0) {
430 $newSQL = $matches[1] . " TOP $count " . $matches[2] . $matches[3];
433 $distinct_o = strpos($match_two, "distinct");
434 $up_to_distinct_str = substr($match_two, 0, $distinct_o);
435 //check to see if the distinct is within a function, if so, then proceed as normal
436 if (strpos($up_to_distinct_str,"(")) {
438 $newSQL = $matches[1] . " TOP $count " . $matches[2] . $matches[3];
441 //if distinct is not within a function, then parse
442 //string contains distinct clause, "TOP needs to come after Distinct"
443 //get position of distinct
444 $match_zero = strtolower($matches[0]);
445 $distinct_pos = strpos($match_zero , "distinct");
446 //get position of where
447 $where_pos = strpos($match_zero, "where");
448 //parse through string
449 $beg = substr($matches[0], 0, $distinct_pos+9 );
450 $mid = substr($matches[0], strlen($beg), ($where_pos+5) - (strlen($beg)));
451 $end = substr($matches[0], strlen($beg) + strlen($mid) );
452 //repopulate matches array
453 $matches[1] = $beg; $matches[2] = $mid; $matches[3] = $end;
455 $newSQL = $matches[1] . " TOP $count " . $matches[2] . $matches[3];
460 $orderByMatch = array();
461 preg_match('/^(.*)(ORDER BY)(.*)$/is',$matches[3], $orderByMatch);
463 //if there is a distinct clause, parse sql string as we will have to insert the rownumber
464 //for paging, AFTER the distinct clause
465 $hasDistinct = strpos(strtolower($matches[0]), "distinct");
467 $matches_sql = strtolower($matches[0]);
468 //remove reference to distinct and select keywords, as we will use a group by instead
469 //we need to use group by because we are introducing rownumber column which would make every row unique
471 //take out the select and distinct from string so we can reuse in group by
472 $dist_str = ' distinct ';
473 $distinct_pos = strpos($matches_sql, $dist_str);
474 $matches_sql = substr($matches_sql,$distinct_pos+ strlen($dist_str));
475 //get the position of where and from for further processing
476 $from_pos = strpos($matches_sql , " from ");
477 $where_pos = strpos($matches_sql, "where");
478 //split the sql into a string before and after the from clause
479 //we will use the columns being selected to construct the group by clause
481 $distinctSQLARRAY[0] = substr($matches_sql,0, $from_pos+1);
482 $distinctSQLARRAY[1] = substr($matches_sql,$from_pos+1);
483 //get position of order by (if it exists) so we can strip it from the string
484 $ob_pos = strpos($distinctSQLARRAY[1], "order by");
486 $distinctSQLARRAY[1] = substr($distinctSQLARRAY[1],0,$ob_pos);
489 // strip off last closing parathese from the where clause
490 $distinctSQLARRAY[1] = preg_replace("/\)\s$/"," ",$distinctSQLARRAY[1]);
493 //place group by string into array
494 $grpByArr = explode(',', $distinctSQLARRAY[0]);
497 //remove the aliases for each group by element, sql server doesnt like these in group by.
498 foreach ($grpByArr as $gb) {
501 //clean out the extra stuff added if we are concating first_name and last_name together
502 //this way both fields are added in correctly to the group by
503 $gb = str_replace("isnull(","",$gb);
504 $gb = str_replace("'') + ' ' + ","",$gb);
506 //remove outer reference if they exist
507 if (strpos($gb,"'")!==false){
510 //if there is a space, then an alias exists, remove alias
511 if (strpos($gb,' ')){
512 $gb = substr( $gb, 0,strpos($gb,' '));
515 //if resulting string is not empty then add to new group by string
522 $grpByStr .= ", $gb";
528 if (!empty($orderByMatch[3])) {
529 //if there is a distinct clause, form query with rownumber after distinct
531 $newSQL = "SELECT TOP $count * FROM
534 OVER (ORDER BY ".$this->returnOrderBy($sql, $orderByMatch[3]).") AS row_number,
535 count(*) counter, " . $distinctSQLARRAY[0] . "
536 " . $distinctSQLARRAY[1] . "
537 group by " . $grpByStr . "
539 WHERE row_number > $start";
542 $newSQL = "SELECT TOP $count * FROM
544 " . $matches[1] . " ROW_NUMBER()
545 OVER (ORDER BY " . $this->returnOrderBy($sql, $orderByMatch[3]) . ") AS row_number,
546 " . $matches[2] . $orderByMatch[1]. "
548 WHERE row_number > $start";
551 //bug: 22231 Records in campaigns' subpanel may not come from
552 //table of $_REQUEST['module']. Get it directly from query
553 $upperQuery = strtoupper($matches[2]);
554 if (!strpos($upperQuery,"JOIN")){
555 $from_pos = strpos($upperQuery , "FROM") + 4;
556 $where_pos = strpos($upperQuery, "WHERE");
557 $tablename = trim(substr($upperQuery,$from_pos, $where_pos - $from_pos));
559 $tablename = $this->getTableNameFromModuleName($_REQUEST['module'],$sql);
561 //if there is a distinct clause, form query with rownumber after distinct
563 $newSQL = "SELECT TOP $count * FROM
565 SELECT ROW_NUMBER() OVER (ORDER BY ".$tablename.".id) AS row_number, count(*) counter, " . $distinctSQLARRAY[0] . "
566 " . $distinctSQLARRAY[1] . "
567 group by " . $grpByStr . "
570 WHERE row_number > $start";
573 $newSQL = "SELECT TOP $count * FROM
575 " . $matches[1] . " ROW_NUMBER() OVER (ORDER BY ".$tablename.".id) AS row_number, " . $matches[2] . $matches[3]. "
578 WHERE row_number > $start";
585 $GLOBALS['log']->debug('Limit Query: ' . $newSQL);
586 $result = $this->query($newSQL, $dieOnError, $msg);
587 $this->dump_slow_queries($newSQL);
593 * Searches for begginning and ending characters. It places contents into
594 * an array and replaces contents in original string. This is used to account for use of
595 * nested functions while aliasing column names
597 * @param string $p_sql SQL statement
598 * @param string $strip_beg Beginning character
599 * @param string $strip_end Ending character
600 * @param string $patt Optional, pattern to
602 private function removePatternFromSQL(
608 //strip all single quotes out
611 $count = substr_count ( $p_sql, $strip_beg);
613 if ($strip_beg != $strip_end)
618 $strip_array = array();
619 while ($i<$count && $offset<strlen($p_sql)) {
620 if ($offset > strlen($p_sql))
625 $beg_sin = strpos($p_sql, $strip_beg, $offset);
630 $sec_sin = strpos($p_sql, $strip_end, $beg_sin+1);
631 $strip_array[$patt.$i] = substr($p_sql, $beg_sin, $sec_sin - $beg_sin +1);
632 if ($increment > 1) {
633 //we are in here because beginning and end patterns are not identical, so search for nesting
634 $exists = strpos($strip_array[$patt.$i], $strip_beg );
636 $nested_pos = (strrpos($strip_array[$patt.$i], $strip_beg ));
637 $strip_array[$patt.$i] = substr($p_sql,$nested_pos+$beg_sin,$sec_sin - ($nested_pos+$beg_sin)+1);
638 $p_sql = substr($p_sql, 0, $nested_pos+$beg_sin) . " ##". $patt.$i."## " . substr($p_sql, $sec_sin+1);
640 $beg_sin = $nested_pos;
644 $p_sql = substr($p_sql, 0, $beg_sin) . " ##". $patt.$i."## " . substr($p_sql, $sec_sin+1);
646 $offset = $sec_sin+1;
650 $strip_array['sql_string'] = $p_sql;
658 * @param string $token
659 * @param array $pattern_array
662 private function addPatternToSQL(
667 //strip all single quotes out
668 $pattern_array = array_reverse($pattern_array);
670 foreach ($pattern_array as $key => $replace) {
671 $token = str_replace( "##".$key."##", $replace,$token);
678 * gets an alias from the sql statement
681 * @param string $alias
684 private function getAliasFromSQL(
690 preg_match('/^(.*SELECT)(.*?FROM.*WHERE)(.*)$/isU',$sql, $matches);
691 //parse all single and double quotes out of array
692 $sin_array = $this->removePatternFromSQL($matches[2], "'", "'","sin_");
693 $new_sql = array_pop($sin_array);
694 $dub_array = $this->removePatternFromSQL($new_sql, "\"", "\"","dub_");
695 $new_sql = array_pop($dub_array);
697 //search for parenthesis
698 $paren_array = $this->removePatternFromSQL($new_sql, "(", ")", "par_");
699 $new_sql = array_pop($paren_array);
701 //all functions should be removed now, so split the array on comma's
702 $mstr_sql_array = explode(",", $new_sql);
703 foreach($mstr_sql_array as $token ) {
704 if (strpos($token, $alias)) {
705 //found token, add back comments
706 $token = $this->addPatternToSQL($token, $paren_array);
707 $token = $this->addPatternToSQL($token, $dub_array);
708 $token = $this->addPatternToSQL($token, $sin_array);
710 //log and break out of this function
719 * Finds the alias of the order by column, and then return the preceding column name
722 * @param string $orderMatch
725 private function findColumnByAlias(
730 //change case to lowercase
731 $sql = strtolower($sql);
732 $patt = '/\s+'.trim($orderMatch).'\s*,/';
734 //check for the alias, it should contain comma, may contain space, \n, or \t
736 preg_match($patt, $sql, $matches, PREG_OFFSET_CAPTURE);
737 $found_in_sql = isset($matches[0][1]) ? $matches[0][1] : false;
740 //set default for found variable
741 $found = $found_in_sql;
743 //if still no match found, then we need to parse through the string
745 //get count of how many times the match exists in string
746 $found_count = substr_count($sql, $orderMatch);
749 $len = strlen($orderMatch);
750 //loop through string as many times as there is a match
751 while ($found_count > $i) {
752 //get the first match
753 $found_in_sql = strpos($sql, $orderMatch,$first_);
754 //make sure there was a match
756 //grab the next 2 individual characters
757 $str_plusone = substr($sql,$found_in_sql + $len,1);
758 $str_plustwo = substr($sql,$found_in_sql + $len+1,1);
759 //if one of those characters is a comma, then we have our alias
760 if ($str_plusone === "," || $str_plustwo === ","){
761 //keep track of this position
762 $found = $found_in_sql;
765 //set the offset and increase the iteration counter
766 $first_ = $found_in_sql+$len;
770 //return $found, defaults have been set, so if no match was found it will be a negative number
776 * Return the order by string to use in case the column has been aliased
779 * @param string $orig_order_match
782 private function returnOrderBy(
787 $sql = strtolower($sql);
788 $orig_order_match = trim($orig_order_match);
789 if (strpos($orig_order_match, ".") != 0)
790 //this has a tablename defined, pass in the order match
791 return $orig_order_match;
793 //grab first space in order by
794 $firstSpace = strpos($orig_order_match, " ");
796 //split order by into column name and ascending/descending
797 $orderMatch = " " . strtolower(substr($orig_order_match, 0, $firstSpace));
798 $asc_desc = substr($orig_order_match,$firstSpace);
800 //look for column name as an alias in sql string
801 $found_in_sql = $this->findColumnByAlias($sql, $orderMatch);
803 if (!$found_in_sql) {
804 //check if this column needs the tablename prefixed to it
805 $orderMatch = ".".trim($orderMatch);
806 $colMatchPos = strpos($sql, $orderMatch);
807 if ($colMatchPos !== false) {
808 //grab sub string up to column name
809 $containsColStr = substr($sql,0, $colMatchPos);
810 //get position of first space, so we can grab table name
811 $lastSpacePos = strrpos($containsColStr, " ");
812 //use positions of column name, space before name, and length of column to find the correct column name
813 $col_name = substr($sql, $lastSpacePos, $colMatchPos-$lastSpacePos+strlen($orderMatch));
814 //bug 25485. When sorting by a custom field in Account List and then pressing NEXT >, system gives an error
815 $containsCommaPos = strpos($col_name, ",");
816 if($containsCommaPos !== false) {
817 $col_name = substr($col_name, $containsCommaPos+1);
822 //break out of here, log this
823 $GLOBALS['log']->debug("No match was found for order by, pass string back untouched as: $orig_order_match");
824 return $orig_order_match;
827 //if found, then parse and return
828 //grab string up to the aliased column
829 $GLOBALS['log']->debug("order by found, process sql string");
831 $psql = (trim($this->getAliasFromSQL($sql, $orderMatch )));
833 $psql = trim(substr($sql, 0, $found_in_sql));
835 //grab the last comma before the alias
836 $comma_pos = strrpos($psql, " ");
837 //substring between the comma and the alias to find the joined_table alias and column name
838 $col_name = substr($psql,0, $comma_pos);
840 //make sure the string does not have an end parenthesis
841 //and is not part of a function (i.e. "ISNULL(leads.last_name,'') as name" )
842 //this is especially true for unified search from home screen
845 if(strpos($psql, " as "))
846 $alias_beg_pos = strpos($psql, " as ");
848 // Bug # 44923 - This breaks the query and does not properly filter isnull
849 // as there are other functions such as ltrim and rtrim.
850 /* else if (strncasecmp($psql, 'isnull', 6) != 0)
851 $alias_beg_pos = strpos($psql, " "); */
853 if ($alias_beg_pos > 0) {
854 $col_name = substr($psql,0, $alias_beg_pos );
856 //add the "asc/desc" order back
857 $col_name = $col_name. " ". $asc_desc;
859 //pass in new order by
860 $GLOBALS['log']->debug("order by being returned is " . $col_name);
866 * Take in a string of the module and retrieve the correspondent table name
868 * @param string $module_str module name
869 * @param string $sql SQL statement
870 * @return string table name
872 private function getTableNameFromModuleName(
878 global $beanList, $beanFiles;
879 $GLOBALS['log']->debug("Module being processed is " . $module_str);
880 //get the right module files
881 //the module string exists in bean list, then process bean for correct table name
882 //note that we exempt the reports module from this, as queries from reporting module should be parsed for
883 //correct table name.
884 if (($module_str != 'Reports' && $module_str != 'SavedReport') && isset($beanList[$module_str]) && isset($beanFiles[$beanList[$module_str]])){
885 //if the class is not already loaded, then load files
886 if (!class_exists($beanList[$module_str]))
887 require_once($beanFiles[$beanList[$module_str]]);
889 //instantiate new bean
890 $module_bean = new $beanList[$module_str]();
891 //get table name from bean
892 $tbl_name = $module_bean->table_name;
893 //make sure table name is not just a blank space, or empty
894 $tbl_name = trim($tbl_name);
896 if(empty($tbl_name)){
897 $GLOBALS['log']->debug("Could not find table name for module $module_str. ");
898 $tbl_name = $module_str;
902 //since the module does NOT exist in beanlist, then we have to parse the string
903 //and grab the table name from the passed in sql
904 $GLOBALS['log']->debug("Could not find table name from module in request, retrieve from passed in sql");
905 $tbl_name = $module_str;
906 $sql = strtolower($sql);
908 //look for the location of the "from" in sql string
909 $fromLoc = strpos($sql," from " );
911 //found from, substring from the " FROM " string in sql to end
912 $tableEnd = substr($sql, $fromLoc+6);
913 //We know that tablename will be next parameter after from, so
914 //grab the next space after table name.
915 // MFH BUG #14009: Also check to see if there are any carriage returns before the next space so that we don't grab any arbitrary joins or other tables.
916 $carriage_ret = strpos($tableEnd,"\n");
917 $next_space = strpos($tableEnd," " );
918 if ($carriage_ret < $next_space)
919 $next_space = $carriage_ret;
920 if ($next_space > 0) {
921 $tbl_name= substr($tableEnd,0, $next_space);
922 if(empty($tbl_name)){
923 $GLOBALS['log']->debug("Could not find table name sql either, return $module_str. ");
924 $tbl_name = $module_str;
928 //grab the table, to see if it is aliased
929 $aliasTableEnd = trim(substr($tableEnd, $next_space));
930 $alias_space = strpos ($aliasTableEnd, " " );
931 if ($alias_space > 0){
932 $alias_tbl_name= substr($aliasTableEnd,0, $alias_space);
933 strtolower($alias_tbl_name);
934 if(empty($alias_tbl_name)
935 || $alias_tbl_name == "where"
936 || $alias_tbl_name == "inner"
937 || $alias_tbl_name == "left"
938 || $alias_tbl_name == "join"
939 || $alias_tbl_name == "outer"
940 || $alias_tbl_name == "right") {
941 //not aliased, do nothing
943 elseif ($alias_tbl_name == "as") {
944 //the next word is the table name
945 $aliasTableEnd = trim(substr($aliasTableEnd, $alias_space));
946 $alias_space = strpos ($aliasTableEnd, " " );
947 if ($alias_space > 0) {
948 $alias_tbl_name= trim(substr($aliasTableEnd,0, $alias_space));
949 if (!empty($alias_tbl_name))
950 $tbl_name = $alias_tbl_name;
954 //this is table alias
955 $tbl_name = $alias_tbl_name;
961 $GLOBALS['log']->debug("Table name for module $module_str is: ".$tbl_name);
967 * @see DBManager::getFieldsArray()
969 public function getFieldsArray(
971 $make_lower_case = false
974 $field_array = array();
976 if(! isset($result) || empty($result))
980 while ($i < mssql_num_fields($result)) {
981 $meta = mssql_fetch_field($result, $i);
984 if($make_lower_case==true)
985 $meta->name = strtolower($meta->name);
987 $field_array[] = $meta->name;
996 * @see DBManager::getAffectedRowCount()
998 public function getAffectedRowCount()
1000 return $this->getOne("SELECT @@ROWCOUNT");
1004 * @see DBManager::describeField()
1006 protected function describeField(
1011 global $table_descriptions;
1012 if(isset($table_descriptions[$tablename]) && isset($table_descriptions[$tablename][$name])){
1013 return $table_descriptions[$tablename][$name];
1015 $table_descriptions[$tablename] = array();
1017 $sql = sprintf( "SELECT COLUMN_NAME AS Field
1018 , DATA_TYPE + CASE WHEN CHARACTER_MAXIMUM_LENGTH IS NOT NULL
1019 THEN '(' + RTRIM(CAST(CHARACTER_MAXIMUM_LENGTH AS CHAR)) + ')'
1020 ELSE '' END as 'Type'
1021 , CHARACTER_MAXIMUM_LENGTH
1022 , IS_NULLABLE AS 'Null'
1023 , CASE WHEN COLUMN_DEFAULT LIKE '((0))' THEN '(''0'')' ELSE COLUMN_DEFAULT END as 'Default'
1024 FROM INFORMATION_SCHEMA.COLUMNS
1025 WHERE TABLE_NAME = '%s'",
1029 $result = $this->query($sql);
1030 while ($row = $this->fetchByAssoc($result) )
1031 $table_descriptions[$tablename][$row['Field']] = $row;
1033 if (isset($table_descriptions[$tablename][$name]))
1034 return $table_descriptions[$tablename][$name];
1042 * @see DBManager::fetchByAssoc()
1044 public function fetchByAssoc(
1053 if ($result && $rowNum < 0) {
1054 $row = mssql_fetch_assoc($result);
1055 //MSSQL returns a space " " when a varchar column is empty ("") and not null.
1056 //We need to iterate through the returned row array and strip empty spaces
1058 foreach($row as $key => $column) {
1059 //notice we only strip if one space is returned. we do not want to strip
1060 //strings with intentional spaces (" foo ")
1061 if (!empty($column) && $column ==" ") {
1067 if($encode && $this->encode&& is_array($row))
1068 return array_map('to_html', $row);
1073 if ($this->getRowCount($result) > $rowNum) {
1074 if ( $rowNum == -1 )
1076 @mssql_data_seek($result, $rowNum);
1079 $this->lastmysqlrow = $rowNum;
1080 $row = @mssql_fetch_assoc($result);
1081 if($encode && $this->encode && is_array($row))
1082 return array_map('to_html', $row);
1087 * @see DBManager::quote()
1089 public function quote(
1094 return $string = str_replace("'","''", parent::quote($string));
1098 * @see DBManager::quoteForEmail()
1100 public function quoteForEmail(
1105 return str_replace("'","''", $string);
1110 * @see DBManager::tableExists()
1112 public function tableExists(
1116 $GLOBALS['log']->info("tableExists: $tableName");
1118 $this->checkConnection();
1119 $result = $this->query(
1120 "SELECT * FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_TYPE='BASE TABLE' AND TABLE_NAME='".$tableName."'");
1122 $rowCount = $this->getRowCount($result);
1123 $this->freeResult($result);
1124 return ($rowCount == 0) ? false : true;
1128 * @see DBManager::addIndexes()
1130 public function addIndexes(
1136 $alters = $this->helper->indexSQL($tablename,array(),$indexes);
1138 $this->query($alters);
1144 * @see DBManager::dropIndexes()
1146 public function dropIndexes(
1153 foreach ($indexes as $index) {
1154 if ( !empty($sql) ) $sql .= ";";
1155 $name = $index['name'];
1157 unset($GLOBALS['table_descriptions'][$tablename]['indexes'][$name]);
1158 if ($index['type'] == 'primary')
1159 $sql .= "ALTER TABLE $tablename DROP CONSTRAINT $name";
1161 $sql .= "DROP INDEX $name on $tablename";
1171 * @see DBManager::checkQuery()
1173 protected function checkQuery(
1181 * @see DBManager::getTablesArray()
1183 public function getTablesArray()
1185 $GLOBALS['log']->debug('MSSQL fetching table list');
1187 if($this->getDatabase()) {
1189 $r = $this->query('SELECT TABLE_NAME FROM INFORMATION_SCHEMA.TABLES');
1190 if (is_resource($r)) {
1191 while ($a = $this->fetchByAssoc($r))
1192 $tables[] = $a['TABLE_NAME'];
1198 return false; // no database available
1203 * This call is meant to be used during install, when Full Text Search is enabled
1204 * Indexing would always occur after a fresh sql server install, so this code creates
1205 * a catalog and table with full text index.
1207 public function wakeupFTS()
1209 $GLOBALS['log']->debug('MSSQL about to wakeup FTS');
1211 if($this->getDatabase()) {
1212 //create wakup catalog
1213 $FTSqry[] = "if not exists( select * from sys.fulltext_catalogs where name ='wakeup_catalog' )
1214 CREATE FULLTEXT CATALOG wakeup_catalog
1217 //drop wakeup table if it exists
1218 $FTSqry[] = "IF EXISTS(SELECT 'fts_wakeup' FROM sysobjects WHERE name = 'fts_wakeup' AND xtype='U')
1219 DROP TABLE fts_wakeup
1221 //create wakeup table
1222 $FTSqry[] = "CREATE TABLE fts_wakeup(
1223 id varchar(36) NOT NULL CONSTRAINT pk_fts_wakeup_id PRIMARY KEY CLUSTERED (id ASC ),
1225 kb_index int IDENTITY(1,1) NOT NULL CONSTRAINT wakeup_fts_unique_idx UNIQUE NONCLUSTERED
1228 //create full text index
1229 $FTSqry[] = "CREATE FULLTEXT INDEX ON fts_wakeup
1234 KEY INDEX wakeup_fts_unique_idx ON wakeup_catalog
1235 WITH CHANGE_TRACKING AUTO
1239 $FTSqry[] = "INSERT INTO fts_wakeup (id ,body)
1240 VALUES ('".create_guid()."', 'SugarCRM Rocks' )";
1243 //create queries to stop and restart indexing
1244 $FTSqry[] = 'ALTER FULLTEXT INDEX ON fts_wakeup STOP POPULATION';
1245 $FTSqry[] = 'ALTER FULLTEXT INDEX ON fts_wakeup DISABLE';
1246 $FTSqry[] = 'ALTER FULLTEXT INDEX ON fts_wakeup ENABLE';
1247 $FTSqry[] = 'ALTER FULLTEXT INDEX ON fts_wakeup SET CHANGE_TRACKING MANUAL';
1248 $FTSqry[] = 'ALTER FULLTEXT INDEX ON fts_wakeup START FULL POPULATION';
1249 $FTSqry[] = 'ALTER FULLTEXT INDEX ON fts_wakeup SET CHANGE_TRACKING AUTO';
1251 foreach($FTSqry as $q){
1259 return false; // no database available
1263 * @see DBManager::convert()
1265 public function convert(
1268 array $additional_parameters = array(),
1269 array $additional_parameters_oracle_only = array()
1272 // convert the parameters array into a comma delimited string
1273 $additional_parameters_string = '';
1274 if (!empty($additional_parameters))
1275 $additional_parameters_string = ','.implode(',',$additional_parameters);
1278 case 'today': return "GETDATE()";
1279 case 'left': return "LEFT($string".$additional_parameters_string.")";
1281 if(!empty($additional_parameters) && in_array("'%Y-%m'", $additional_parameters))
1282 return "CONVERT(varchar(7),". $string . ",120)";
1284 return "CONVERT(varchar(10),". $string . ",120)";
1285 case 'IFNULL': return "ISNULL($string".$additional_parameters_string.")";
1286 case 'CONCAT': return "$string+".implode("+",$additional_parameters);
1287 case 'text2char': return "CAST($string AS varchar(8000))";
1294 * @see DBManager::concat()
1296 public function concat(
1303 foreach ( $fields as $index => $field )
1305 $ret = db_convert($table.".".$field,'IFNULL', array("''"));
1307 $ret .= " + ' ' + ".db_convert($table.".".$field,'IFNULL', array("''"));
1309 return empty($ret)?$ret:"LTRIM(RTRIM($ret))";
1313 * @see DBManager::fromConvert()
1315 public function fromConvert(
1320 case 'datetime': return substr($string, 0,19);
1321 case 'date': return substr($string, 0,11);
1322 case 'time': return substr($string, 11);