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.
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая