PgsqlConnection — соединение с PostgreSQL

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

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

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

Класс PgsqlConnection — реализация Connection для PostgreSQL. Объект возвращает Application::getConnection(), если в .settings.php для соединения указан className со значением \Bitrix\Main\DB\PgsqlConnection.

Класс Connection описывает методы, которые вызывает код приложения. Страницы методов Connection описывают поведение PostgreSQL в таблицах реализаций.

Методы isTableExists и getTableFields ищут таблицы в схеме public. Строки результатов приходят с ключами в верхнем регистре.

Методы класса

Методов ниже нет в классе Connection.

Метод Описание С версии
getTableFullTextFields Возвращает колонки таблицы из выражений ее индексов
connectionErrorHandler Превращает ошибку PHP при подключении в исключение ConnectionException

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

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

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

Метод Особенность реализации
add Если identity не null, а значение автоинкрементной колонки не передано или передано объектом SqlExpression, добавляет строку с RETURNING и возвращает новое значение целым числом. Иначе возвращает переданное значение колонки или null
getInsertedId Выполняет SELECT bx_lastval(). При ошибке запроса возвращает 0
getAffectedRowsCount Возвращает pg_affected_rows для результата последнего запроса
isTableExists Ищет таблицу с точным именем в схеме public
isIndexExists Вызывает getIndexName в нестрогом режиме, как в MySQL
getIndexName Сравнивает имена колонок без учета регистра. Для индекса с выражением берет колонки из выражения. Имя таблицы не приводит к нижнему регистру и ищет таблицу во всех схемах. Для несуществующей таблицы возвращает null
getTableFields Читает information_schema.columns для схемы public. Приводит имена колонок к верхнему регистру. Пустой результат не кеширует
createTable Для автоинкремента создает колонку GENERATED BY DEFAULT AS IDENTITY
createIndex Строит запрос с IF NOT EXISTS. Для INDEX_FULLTEXT создает индекс GIN по to_tsvector('english', ...)
renameTable Выполняет ALTER TABLE ... RENAME TO
dropTable Выполняет DROP TABLE и очищает кеш описания колонок, как в MySQL
startTransaction Открывает транзакцию или создает точку сохранения, как в MySQL
commitTransaction Выполняет COMMIT только на внешнем уровне, как в MySQL
rollbackTransaction Во вложенной транзакции откатывает до точки сохранения без исключения
lock Вызывает функцию bx_get_lock. Имя блокировки — число crc32. Возвращает true, если функция вернула 0
unlock Вызывает функцию bx_release_lock. Возвращает true, если функция вернула 0
getType Возвращает pgsql
getVersion Возвращает массив [версия, null], где версия — два числа через точку, например 16.4
getErrorMessage Возвращает текст функции pg_last_error
getErrorCode Возвращает код SQLSTATE из сообщения об ошибке строкой

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

Остальные методы работают как в классе Connection. Метод getMaxAllowedPacket работает как в классе Bitrix\Main\Data\Connection и возвращает PHP_INT_MAX.

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

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