PgsqlSqlHelper — SQL для PostgreSQL

Пространство имен: Bitrix\Main\DB

Модуль: main — подключать отдельно не нужно

Когда использовать

Класс PgsqlSqlHelper — реализация SqlHelper для PostgreSQL. Объект возвращает метод getSqlHelper соединения PgsqlConnection, создавать его конструктором не нужно.

Класс SqlHelper описывает все методы, которые вызывает код приложения. Собственных методов у класса нет.

Наследование

Класс наследует SqlHelper.

Реализация методов базового класса

Метод Особенность реализации
getLeftQuote, getRightQuote Возвращают двойную кавычку "
getAliasLength Возвращает 63
quote Приводит имя к нижнему регистру и экранирует его целиком функцией pg_escape_identifier. Точку не считает разделителем. Подключается к базе данных, если подключения еще нет
values Строит EXCLUDED."<колонка>" с именем колонки в нижнем регистре
getQueryDelimiter Возвращает ;
forSql Экранирует строку функцией pg_escape_string. Подключается к базе данных, если подключения еще нет
convertToDbBinary Кодирует данные функцией pg_escape_bytea
convertToFullText Строит вызов safe_text_for_tsvector('...') и обрезает текст до значения константы FULLTEXT_MAXIMUM_LENGTH — 1 000 000 символов
getCurrentDateTimeFunction Возвращает now()
getCurrentDateFunction Возвращает current_date
addSecondsToDateTime Строит <from>::timestamp + cast(<seconds>||' second' as interval). Без from — now() + cast(...)
addDaysToDateTime Строит (<from>::timestamp + cast(<days>||' day' as interval)). Без from — (now() + cast(...))
getDatetimeToDateFunction Строит cast(<value> as date)
formatDate Переводит формат в обозначения to_char, например HH в HH24
getRegexpOperator Строит <field> ~ <regexp>
getIlikeOperator Строит <field> ILIKE <value>
getConcatFunction Склеивает аргументы оператором ||. Без аргументов возвращает пустую строку
getRandomFunction Возвращает random()
getSha1Function Строит encode(digest(...), 'hex')
getIsNullFunction Строит COALESCE(...)
getLengthFunction Строит OCTET_LENGTH(...)
getMatchFunction Строит to_tsvector(...) @@ to_tsquery(...) с конфигурацией english
getMatchAndExpression Собирает a & b, для поиска по началу — a:* & b:*
getMatchOrExpression Собирает a | b, для поиска по началу — a:* | b:*
getCharToDateFunction Строит timestamp '<value>'
getDateToCharFunction Строит TO_CHAR(<fieldName>, 'YYYY-MM-DD HH24:MI:SS')
getConverter Возвращает функции преобразования для полей даты и даты и времени
convertFromDbDate Разбирает дату в формате Y-m-d. Для null и 0000-00-00 возвращает null
convertFromDbDateTime Разбирает дату и время в формате Y-m-d H:i:s. Для null и 0000-00-00 00:00:00 возвращает null
castToChar Строит CAST(<fieldName> AS varchar)
softCastTextToChar Возвращает колонку без изменений
getColumnTypeByField Использует типы integer, float8, timestamp, text и другие типы PostgreSQL
getFieldByColumnType Принимает имена типов PostgreSQL. Для bytea создает строковое поле с признаком двоичных данных
getTopSql Добавляет LIMIT <limit> OFFSET <offset>
getInsertIgnore Строит INSERT ... ON CONFLICT DO NOTHING
getAscendingOrder Возвращает ASC NULLS FIRST
getDescendingOrder Возвращает DESC NULLS LAST
prepareMerge Строит INSERT ... ON CONFLICT (...) DO UPDATE SET. Требует непустой primaryFields
prepareMergeMultiple Строит INSERT ... ON CONFLICT (...) DO UPDATE SET (...) = (EXCLUDED....)
prepareMergeSelect Строит INSERT ... SELECT ... ON CONFLICT (...) DO UPDATE SET
prepareDeleteLimit Удаляет строки по первичному ключу из подзапроса с LIMIT
initRowNumber Возвращает пустую строку
getRowNumber Возвращает row_number() over()
prepareCorrelatedUpdate Строит UPDATE ... SET ... FROM ... WHERE
getOrderByStringField, getOrderByIntField Строят выражение array_position(ARRAY[...], ...) через переопределенный защищенный метод getOrderByField

Унаследованные методы

Остальные методы работают как в классе SqlHelper.

Смотрите также

Предыдущая
Следующая