Глава 34. libpq — библиотека для языка C

Содержание

34.1. Функции управления подключением к базе данных
34.1.1. Строки параметров подключения
34.1.2. Ключевые слова-параметры
34.2. Функции, описывающие текущее состояние подключения
34.3. Функции для исполнения команд
34.3.1. Главные функции
34.3.2. Извлечение информации, связанной с результатом запроса
34.3.3. Получение другой информации о результате
34.3.4. Экранирование строковых значений для включения в SQL-команды
34.4. Асинхронная обработка команд
34.5. Конвейерный режим
34.5.1. Использование конвейерного режима
34.5.2. Функции, связанные с конвейерным режимом
34.5.3. Когда использовать конвейерный режим
34.6. Построчное извлечение результатов запроса
34.7. Отмена запросов в процессе выполнения
34.8. Интерфейс быстрого пути
34.9. Асинхронное уведомление
34.10. Функции, связанные с командой COPY
34.10.1. Функции для передачи данных COPY
34.10.2. Функции для приёма данных COPY
34.10.3. Устаревшие функции для COPY
34.11. Функции управления
34.12. Функции разного назначения
34.13. Обработка замечаний
34.14. Система событий
34.14.1. Типы событий
34.14.2. Процедура обработки событий
34.14.3. Функции поддержки событий
34.14.4. Пример обработки событий
34.15. Переменные окружения
34.16. Файл паролей
34.17. Файл служб соединения
34.18. Получение параметров соединения через LDAP
34.19. Поддержка SSL
34.19.1. Проверка сертификатов сервера на стороне клиента
34.19.2. Клиентские сертификаты
34.19.3. Защита, обеспечиваемая в различных режимах
34.19.4. Файлы, используемые клиентом SSL
34.19.5. Инициализация библиотеки SSL
34.20. Поведение в многопоточных программах
34.21. Сборка программ с libpq
34.22. Примеры программ

libpq — это интерфейс PostgreSQL для программирования приложений на языке C. Библиотека libpq содержит набор функций, используя которые клиентские программы могут передавать запросы серверу PostgreSQL и принимать результаты этих запросов.

libpq также является базовым механизмом для нескольких других прикладных интерфейсов PostgreSQL, включая те, что написаны для C++, Perl, Python, Tcl и ECPG. Поэтому некоторые аспекты поведения libpq будут важны для вас, если вы используете один из этих пакетов. В частности, Раздел 34.15, Раздел 34.16 и Раздел 34.19 описывают поведение, видимое пользователю любого приложения, использующего libpq.

В конце этой главы приведены короткие программы (Раздел 34.22), показывающие, как использовать libpq в своих программах. В каталоге src/test/examples дистрибутивного комплекта исходных текстов приведено несколько завершённых примеров приложений libpq.

Клиентские программы, которые используют libpq, должны включать заголовочный файл libpq-fe.h и должны компоноваться с библиотекой libpq.

Chapter 34. libpq — C Library

libpq is the C application programmer's interface to PostgreSQL. libpq is a set of library functions that allow client programs to pass queries to the PostgreSQL backend server and to receive the results of these queries.

libpq is also the underlying engine for several other PostgreSQL application interfaces, including those written for C++, Perl, Python, Tcl and ECPG. So some aspects of libpq's behavior will be important to you if you use one of those packages. In particular, Section 34.15, Section 34.16 and Section 34.19 describe behavior that is visible to the user of any application that uses libpq.

Some short programs are included at the end of this chapter (Section 34.22) to show how to write programs that use libpq. There are also several complete examples of libpq applications in the directory src/test/examples in the source code distribution.

Client programs that use libpq must include the header file libpq-fe.h and must link with the libpq library.

FAQ