Глава 51. Клиент-серверный протокол

Содержание

51.1. Обзор
51.1.1. Обзор обмена сообщениями
51.1.2. Обзор расширенного выполнения запросов
51.1.3. Форматы и коды форматов
51.2. Поток сообщений
51.2.1. Запуск
51.2.2. Простое выполнение запросов
51.2.3. Расширенное выполнение запросов
51.2.4. Конвейеризация
51.2.5. Вызов функций
51.2.6. Операции COPY
51.2.7. Асинхронные операции
51.2.8. Отмена выполняющихся запросов
51.2.9. Завершение
51.2.10. Защита сеанса с SSL
51.2.11. Защита сеанса с GSSAPI
51.3. Аутентификация SASL
51.4. Протокол потоковой репликации
51.5. Протокол логической потоковой репликации
51.5.1. Параметры протокола логической потоковой репликации
51.5.2. Сообщения протокола логической репликации
51.5.3. Поток сообщений протокола логической репликации
51.6. Типы данных в сообщениях
51.7. Форматы сообщений
51.8. Поля сообщений с ошибками и замечаниями
51.9. Форматы сообщений логической репликации
51.10. Сводка изменений по сравнению с протоколом версии 2.0

Клиенты и серверы Postgres Pro взаимодействуют друг с другом, используя специальный протокол, основанный на сообщениях. Этот протокол поддерживается для соединений по TCP/IP и через Unix-сокеты. Для серверов, поддерживающих этот протокол, в IANA зарезервирован номер TCP-порта 5432, но на практике можно задействовать любой порт, не требующий особых привилегий.

В этой документации описана версия 3.0 этого протокола, реализованная в PostgreSQL версии 7.4 и новее. За описанием предыдущих версий протокола обратитесь к документации более ранних выпусков PostgreSQL. Один сервер способен поддерживать несколько версий протокола. Какую версию протокола пытается использовать клиент, сервер узнаёт из стартового сообщения при установлении соединения. Если старшая версия, запрашиваемая клиентом, не поддерживается сервером, соединение будет разорвано (например, это будет иметь место, если клиент запросит протокол версии 4.0, несуществующий на момент написания этого текста). Если младшая версия, запрашиваемая клиентом, не поддерживается сервером (например, клиент запросил версию 3.1, а сервер поддерживает только 3.0), сервер может либо разорвать соединение, либо ответить сообщением NegotiateProtocolVersion с указанием наибольшей младшей версии, которую он поддерживает. Затем клиент может решить либо продолжить установление соединения с указанной версией протокола, либо разорвать соединение.

Чтобы эффективно обслуживать множество клиентов, сервер запускает отдельный «обслуживающий» процесс для каждого клиента. В текущей реализации новый дочерний процесс запускается немедленно после обнаружения входящего подключения. Однако это происходит прозрачно для протокола. С точки зрения протокола, термины «обслуживающий процесс», «процесс заднего плана» и «сервер» взаимозаменяемы, как и «приложение переднего плана» и «клиент».