Что это такое?
pgx — это драйвер и набор инструментов для PostgreSQL, написанный полностью на Go. Он предоставляет низкоуровневый высокопроизводительный интерфейс, открывающий возможности, специфичные для PostgreSQL, такие как LISTEN/NOTIFY и COPY, а также адаптер для стандартного интерфейса database/sql.
pgx — это драйвер и набор инструментов для PostgreSQL, написанный полностью на Go. Он предоставляет низкоуровневый высокопроизводительный интерфейс, открывающий возможности, специфичные для PostgreSQL, такие как LISTEN/NOTIFY и COPY, а также адаптер для стандартного интерфейса database/sql.Это драйвер database/sql или что-то большее?Это и то, и другое: собственный драйвер pgx с более быстрым интерфейсом и набор базовых пакетов (разбор протокола обмена данными, сопоставление типов), которые можно использовать для создания альтернативных драйверов, прокси-серверов или балансировщиков нагрузки. Адаптер stdlib позволяет работать с ним и через database/sql.
Это и то, и другое: собственный драйвер pgx с более быстрым интерфейсом и набор базовых пакетов (разбор протокола обмена данными, сопоставление типов), которые можно использовать для создания альтернативных драйверов, прокси-серверов или балансировщиков нагрузки. Адаптер stdlib позволяет работать с ним и через database/sql.Как мне добавить это в проект?Импортируйте пакет pgx в свой модуль Go и подключайтесь через pgx.Connect или pgxpool.New, используя URL-адрес подключения к PostgreSQL (например, postgres://user:pass@host:5432/db?sslmode=verify-full) или строку вида key=value.
Импортируйте пакет pgx в свой модуль Go и подключайтесь через pgx.Connect или pgxpool.New, используя URL-адрес подключения к PostgreSQL (например, postgres://user:pass@host:5432/db?sslmode=verify-full) или строку вида key=value.Какие версии Go и PostgreSQL нужны?pgx поддерживает два последних основных релиза Go и версии PostgreSQL, выпущенные за последние 5 лет, — сейчас это Go 1.25+ и PostgreSQL 14 и выше. Также проводится тестирование с последней версией CockroachDB.
pgx поддерживает два последних основных релиза Go и версии PostgreSQL, выпущенные за последние 5 лет, — сейчас это Go 1.25+ и PostgreSQL 14 и выше. Также проводится тестирование с последней версией CockroachDB.Стоит ли мне использовать интерфейс pgx или оставаться на database/sql?Используйте собственный интерфейс pgx, если ваше приложение работает только с PostgreSQL и вам не нужны другие библиотеки, зависящие от database/sql: он быстрее и открывает возможности, доступные только в PostgreSQL. Также можно работать через database/sql и при необходимости переходить на интерфейс pgx.
Используйте собственный интерфейс pgx, если ваше приложение работает только с PostgreSQL и вам не нужны другие библиотеки, зависящие от database/sql: он быстрее и открывает возможности, доступные только в PostgreSQL. Также можно работать через database/sql и при необходимости переходить на интерфейс pgx.Работает ли разработка и тестирование на любой ОС?Да, полный набор тестов с кластерами PostgreSQL 14–18 и узлом CockroachDB запускается локально на macOS или Linux, а также внутри входящего в комплект devcontainer.
Да, полный набор тестов с кластерами PostgreSQL 14–18 и узлом CockroachDB запускается локально на macOS или Linux, а также внутри входящего в комплект devcontainer.Какие возможности, специфичные для PostgreSQL, pgx поддерживает из коробки?Около 70 типов PostgreSQL, LISTEN/NOTIFY, протокол COPY для массовой загрузки данных, пакетные запросы, кодирование в бинарном формате, поддержка hstore/json/jsonb, большие объекты (large objects) и имитация вложенных транзакций через точки сохранения (savepoints).
Около 70 типов PostgreSQL, LISTEN/NOTIFY, протокол COPY для массовой загрузки данных, пакетные запросы, кодирование в бинарном формате, поддержка hstore/json/jsonb, большие объекты (large objects) и имитация вложенных транзакций через точки сохранения (savepoints).Есть ли связанные библиотеки из семейства pgx?Да: pglogrepl для логической репликации, pgmock для имитации протокола обмена данными PostgreSQL, tern для миграций SQL и pgerrcode для констант кодов ошибок PostgreSQL, а также множество сторонних адаптеров для типов UUID и decimal, трассировщиков и логгеров.
Да: pglogrepl для логической репликации, pgmock для имитации протокола обмена данными PostgreSQL, tern для миграций SQL и pgerrcode для констант кодов ошибок PostgreSQL, а также множество сторонних адаптеров для типов UUID и decimal, трассировщиков и логгеров.Можно ли имитировать pgx в тестах без реальной базы данных?Да, сторонняя библиотека pgxmock реализует интерфейсы pgx специально для имитации поведения pgx в тестах без подключения к реальной базе данных.
Да, сторонняя библиотека pgxmock реализует интерфейсы pgx специально для имитации поведения pgx в тестах без подключения к реальной базе данных.Использует ли pgx семантическое версионирование?Да, pgx придерживается семантического версионирования для задокументированного публичного API в стабильных релизах; v5 — текущая последняя стабильная основная версия.
Да, pgx придерживается семантического версионирования для задокументированного публичного API в стабильных релизах; v5 — текущая последняя стабильная основная версия.What are similar projects?usql, sqlx, migrate, sequelize, pgterm, postgres, node-postgres, drizzle-orm
usql, sqlx, migrate, sequelize, pgterm, postgres, node-postgres, drizzle-ormWhich topics is it in?relational-database, database-client, data, postgres, orm, sql, postgresql, backend, database, networking, go, command-line-tool
relational-database, database-client, data, postgres, orm, sql, postgresql, backend, database, networking, go, command-line-tool