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.