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

Содержание

58.1. Обзор
58.1.1. Обзор обмена сообщениями
58.1.2. Обзор расширенного выполнения запросов
58.1.3. Форматы и коды форматов
58.1.4. Версии протокола
58.2. Поток сообщений
58.2.1. Запуск
58.2.2. Простое выполнение запросов
58.2.3. Расширенное выполнение запросов
58.2.4. Конвейеризация
58.2.5. Вызов функций
58.2.6. Операции COPY
58.2.7. Асинхронные операции
58.2.8. Отмена выполняющихся запросов
58.2.9. Завершение
58.2.10. Защита сеанса с SSL
58.2.11. Защита сеанса с GSSAPI
58.3. Аутентификация SASL
58.3.1. Аутентификация SCRAM-SHA-256
58.3.2. Аутентификация OAUTHBEARER
58.4. Протокол потоковой репликации
58.5. Протокол логической потоковой репликации
58.5.1. Параметры протокола логической потоковой репликации
58.5.2. Сообщения протокола логической репликации
58.5.3. Поток сообщений протокола логической репликации
58.6. Типы данных в сообщениях
58.7. Форматы сообщений
58.8. Поля сообщений с ошибками и замечаниями
58.9. Форматы сообщений логической репликации
58.10. Сводка изменений по сравнению с протоколом версии 2.0

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

В этой документации описана версия 3.2 этого протокола, которая введена в Postgres Pro Shardman версии 18. Сервер и клиентская библиотека libpq обратно совместимы с версией 3.0 этого протокола, реализованной в PostgreSQL версии 7.4 и новее.

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

Chapter 58. Frontend/Backend Protocol

Postgres Pro Shardman uses a message-based protocol for communication between frontends and backends (clients and servers). The protocol is supported over TCP/IP and also over Unix-domain sockets. Port number 5432 has been registered with IANA as the customary TCP port number for servers supporting this protocol, but in practice any non-privileged port number can be used.

This document describes version 3.2 of the protocol, introduced in Postgres Pro Shardman version 18. The server and the libpq client library are backwards compatible with protocol version 3.0, implemented in PostgreSQL 7.4 and later.

In order to serve multiple clients efficiently, the server launches a new backend process for each client. In the current implementation, a new child process is created immediately after an incoming connection is detected. This is transparent to the protocol, however. For purposes of the protocol, the terms backend and server are interchangeable; likewise frontend and client are interchangeable.

FAQ