oraclesqlhelper.php

См. документацию.

<?php
 
namespace Bitrix\Main\DB;
 
use Bitrix\Main\Type;
use Bitrix\Main\ORM;
use Bitrix\Main\ORM\Fields\ScalarField;
 
class OracleSqlHelper extends SqlHelper
{
    public function getLeftQuote()
    {
        return '"';
    }

    public function getRightQuote()
    {
        return '"';
    }

    public function getAliasLength()
    {
        return 30;
    }

    public function quote($identifier)
    {
        return parent::quote(mb_strtoupper($identifier));
    }

    public function getQueryDelimiter()
    {
        return "(?<!\\*)/(?!\\*)";
    }

    function forSql($value, $maxLength = 0)
    {
        if ($maxLength <= 0 || $maxLength > 2000)
            $maxLength = 2000;
 
        $value = mb_substr($value, 0, $maxLength);
 
        // From http://w3.org/International/questions/qa-forms-utf-8.html
        // This one can crash php with segmentation fault on large input data (over 20K)
        // https://bugs.php.net/bug.php?id=60423
        if (preg_match_all('%(
            [\x00-\x7E]                        # ASCII
            |[\xC2-\xDF][\x80-\xBF]            # non-overlong 2-byte
            |\xE0[\xA0-\xBF][\x80-\xBF]        # excluding overlongs
            |[\xE1-\xEC\xEE\xEF][\x80-\xBF]{2} # straight 3-byte
            |\xED[\x80-\x9F][\x80-\xBF]        # excluding surrogates
            |\xF0[\x90-\xBF][\x80-\xBF]{2}     # planes 1-3
            |[\xF1-\xF3][\x80-\xBF]{3}         # planes 4-15
            |\xF4[\x80-\x8F][\x80-\xBF]{2}     # plane 16
        )+%x', $value, $match))
            $value = implode(' ', $match[0]);
        else
            return ''; //There is no valid utf at all
 
        return str_replace("'", "''", $value);
    }

    public function getCurrentDateTimeFunction()
    {
        return "SYSDATE";
    }

    public function getCurrentDateFunction()
    {
        return "TRUNC(SYSDATE)";
    }

    public function addSecondsToDateTime($seconds, $from = null)
    {
        if ($from === null)
        {
            $from = static::getCurrentDateTimeFunction();
        }
 
        return '('.$from.'+'.$seconds.'/86400)';
    }

    public function getDatetimeToDateFunction($value)
    {
        return 'TRUNC('.$value.')';
    }

    public function formatDate($format, $field = null)
    {
        $format = str_replace("HH", "HH24", $format);
        $format = str_replace("GG", "HH24", $format);
 
        if (!str_contains($format, 'HH24'))
        {
            $format = str_replace("H", "HH", $format);
        }
 
        $format = str_replace("G", "HH", $format);
 
        $format = str_replace("MI", "II", $format);
 
        if (str_contains($format, 'MMMM'))
        {
            $format = str_replace("MMMM", "MONTH", $format);
        }
        elseif (!str_contains($format, 'MM'))
        {
            $format = str_replace("M", "MON", $format);
        }
 
        $format = str_replace("II", "MI", $format);
 
        $format = str_replace("TT", "AM", $format);
        $format = str_replace("T", "AM", $format);
 
        if ($field === null)
        {
            return $format;
        }
        else
        {
            return "TO_CHAR(".$field.", '".$format."')";
        }
    }

    public function getConcatFunction()
    {
        return implode(" || ", func_get_args());
    }

    public function getIsNullFunction($expression, $result)
    {
        return "NVL(".$expression.", ".$result.")";
    }

    public function getLengthFunction($field)
    {
        return "LENGTH(".$field.")";
    }

    public function getCharToDateFunction($value)
    {
        return "TO_DATE('".$value."', 'YYYY-MM-DD HH24:MI:SS')";
    }

    public function getDateToCharFunction($fieldName)
    {
        return "TO_CHAR(".$fieldName.", 'YYYY-MM-DD HH24:MI:SS')";
    }

    protected function prepareBinds(array $tableFields, array $fields)
    {
        $binds = array();
 
        foreach ($tableFields as $columnName => $tableField)
        {
            if (isset($fields[$columnName]) && !($fields[$columnName] instanceof SqlExpression))
            {
                if ($tableField instanceof ORM\Fields\TextField && $fields[$columnName] <> '')
                {
                    $binds[$columnName] = $fields[$columnName];
                }
            }
        }
 
        return $binds;
    }

    public function getConverter(ScalarField $field)
    {
        if ($field instanceof ORM\Fields\DatetimeField)
        {
            return array($this, "convertFromDbDateTime");
        }
        elseif ($field instanceof ORM\Fields\TextField)
        {
            return array($this, "convertFromDbText");
        }
        elseif ($field instanceof ORM\Fields\StringField)
        {
            return array($this, "convertFromDbString");
        }
        else
        {
            return parent::getConverter($field);
        }
    }

    public function convertFromDbDateTime($value)
    {
        if ($value !== null)
        {
            if (mb_strlen($value) == 19)
            {
                //preferable format: NLS_DATE_FORMAT='YYYY-MM-DD HH24:MI:SS'
                $value = new Type\DateTime($value, "Y-m-d H:i:s");
            }
            else
            {
                //default Oracle date format: 03-MAR-14
                $value = new Type\DateTime($value." 00:00:00", "d-M-y H:i:s");
            }
        }
 
        return $value;
    }

    public function convertFromDbText($value)
    {
        if (is_object($value))
        {
            $value = $value->load();
        }
 
        return $value;
    }

    public function convertToDbText($value)
    {
        return empty($value) ? "NULL" : "EMPTY_CLOB()";
    }

    public function convertFromDbString($value, $length = null)
    {
        if ($value !== null)
        {
            if ((mb_strlen($value) == 19) && preg_match("#^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$#", $value))
            {
                return new Type\DateTime($value, "Y-m-d H:i:s");
            }
        }
 
        return parent::convertFromDbString($value, $length);
    }

    public function castToChar($fieldName)
    {
        return 'TO_CHAR('.$fieldName.')';
    }

    public function softCastTextToChar($fieldName)
    {
        return 'dbms_lob.substr('.$fieldName.', 4000, 1)';
    }

    public function getColumnTypeByField(ScalarField $field)
    {
        if ($field instanceof ORM\Fields\IntegerField)
        {
            return 'number(18)';
        }
        elseif ($field instanceof ORM\Fields\FloatField)
        {
            $scale = $field->getScale();
            return 'number'.($scale !== null? "(*,".$scale.")": "");
        }
        elseif ($field instanceof ORM\Fields\DatetimeField)
        {
            return 'date';
        }
        elseif ($field instanceof ORM\Fields\DateField)
        {
            return 'date';
        }
        elseif ($field instanceof ORM\Fields\TextField)
        {
            return 'clob';
        }
        elseif ($field instanceof ORM\Fields\BooleanField)
        {
            $values = $field->getValues();
 
            if (preg_match('/^[0-9]+$/', $values[0]) && preg_match('/^[0-9]+$/', $values[1]))
            {
                return 'number(1)';
            }
            else
            {
                $falseLen = mb_strlen($values[0]);
                $trueLen = mb_strlen($values[1]);
                if ($falseLen === 1 && $trueLen === 1)
                {
                    return 'char(1 char)';
                }
                return 'varchar2(' . max($falseLen, $trueLen) . ' char)';
            }
        }
        elseif ($field instanceof ORM\Fields\EnumField)
        {
            return 'varchar2('.max(array_map('mb_strlen', $field->getValues())).' char)';
        }
        else
        {
            // string by default
            $defaultLength = false;
            foreach ($field->getValidators() as $validator)
            {
                if ($validator instanceof ORM\Fields\Validators\LengthValidator)
                {
                    if ($defaultLength === false || $defaultLength > $validator->getMax())
                    {
                        $defaultLength = $validator->getMax();
                    }
                }
            }
            return 'varchar2('.($defaultLength > 0? $defaultLength: 255).' char)';
        }
    }

    public function getFieldByColumnType($name, $type, array $parameters = null)
    {
        switch ($type)
        {
        case "DATE":
            return new ORM\Fields\DatetimeField($name);
 
        case "NCLOB":
        case "CLOB":
        case "BLOB":
            return new ORM\Fields\TextField($name);
 
        case "FLOAT":
        case "BINARY_FLOAT":
        case "BINARY_DOUBLE":
            return new ORM\Fields\FloatField($name);
 
        case "NUMBER":
            if ($parameters["precision"] == 0 && $parameters["scale"] == -127)
            {
                //NUMBER
                return new ORM\Fields\FloatField($name);
            }
            if (intval($parameters["scale"]) <= 0)
            {
                //NUMBER(18)
                //NUMBER(18,-2)
                return new ORM\Fields\IntegerField($name);
            }
            //NUMBER(*,2)
            return new ORM\Fields\FloatField($name, array("scale" => $parameters["scale"]));
        }
        //LONG
        //VARCHAR2(size [BYTE | CHAR])
        //NVARCHAR2(size)
        //TIMESTAMP [(fractional_seconds_precision)]
        //TIMESTAMP [(fractional_seconds)] WITH TIME ZONE
        //TIMESTAMP [(fractional_seconds)] WITH LOCAL TIME ZONE
        //INTERVAL YEAR [(year_precision)] TO MONTH
        //INTERVAL DAY [(day_precision)] TO SECOND [(fractional_seconds)]
        //RAW(size)
        //LONG RAW
        //ROWID
        //UROWID [(size)]
        //CHAR [(size [BYTE | CHAR])]
        //NCHAR[(size)]
        //BFILE
        return new ORM\Fields\StringField($name, array("size" => $parameters["size"]));
    }

    public function getTopSql($sql, $limit, $offset = 0)
    {
        $offset = intval($offset);
        $limit = intval($limit);
 
        if ($offset > 0 && $limit <= 0)
            throw new \Bitrix\Main\ArgumentException("Limit must be set if offset is set");
 
        if ($limit > 0)
        {
            //The first row selected has a ROWNUM of 1, the second has 2, and so on
            if ($offset <= 0)
            {
                $sql =
                    "SELECT * ".
                    "FROM (".$sql.") ".
                    "WHERE ROWNUM <= ".$limit;
            }
            else
            {
                $sql =
                    "SELECT * ".
                    "FROM (".
                    "   SELECT rownum_query_alias.*, ROWNUM rownum_alias ".
                    "   FROM (".$sql.") rownum_query_alias ".
                    "   WHERE ROWNUM <= ".($offset + $limit)." ".
                    ") ".
                    "WHERE rownum_alias >= ".($offset + 1);
            }
        }
        return $sql;
    }

    public function getAscendingOrder()
    {
        return 'ASC NULLS FIRST';
    }

    public function getDescendingOrder()
    {
        return 'DESC NULLS LAST';
    }

    public function prepareMerge($tableName, array $primaryFields, array $insertFields, array $updateFields)
    {
        $insert = $this->prepareInsert($tableName, $insertFields);
 
        $updateColumns = array();
        $sourceSelectColumns = array();
        $targetConnectColumns = array();
        $tableFields = $this->connection->getTableFields($tableName);
        foreach($tableFields as $columnName => $tableField)
        {
            $quotedName = $this->quote($columnName);
            if (in_array($columnName, $primaryFields))
            {
                $sourceSelectColumns[] = $this->convertToDb($insertFields[$columnName], $tableField)." AS ".$quotedName;
                if($insertFields[$columnName] === null)
                {
                    //can't just compare NULLs
                    $targetConnectColumns[] = "(source.".$quotedName." IS NULL AND target.".$quotedName." IS NULL)";
                }
                else
                {
                    $targetConnectColumns[] = "(source.".$quotedName." = target.".$quotedName.")";
                }
            }
 
            if (isset($updateFields[$columnName]) || array_key_exists($columnName, $updateFields))
            {
                $updateColumns[] = "target.".$quotedName.' = '.$this->convertToDb($updateFields[$columnName], $tableField);
            }
        }
 
        if (
            $insert && $insert[0] != "" && $insert[1] != ""
            && $updateColumns
            && $sourceSelectColumns && $targetConnectColumns
        )
        {
            $sql = "
                MERGE INTO ".$this->quote($tableName)." target USING (
                    SELECT ".implode(", ", $sourceSelectColumns)." FROM dual
                )
                source ON
                (
                    ".implode(" AND ", $targetConnectColumns)."
                )
                WHEN MATCHED THEN
                    UPDATE SET ".implode(", ", $updateColumns)."
                WHEN NOT MATCHED THEN
                    INSERT (".$insert[0].")
                    VALUES (".$insert[1].")
            ";
        }
        else
        {
            $sql = "";
        }
 
        return array(
            $sql
        );
    }
}