Cette section décrit le format détaillé de chaque message. Chaque message est
marqué pour indiquer s'il peut être envoyé par un client (F pour
frontend), un serveur (B pour
backend) ou les deux (F & B). Bien que
chaque message commence par son nombre d'octets, le format du message est
défini de telle sorte que la fin du message puisse être trouvée sans ce nombre.
Cela contribue à la vérification de la validité. Le message CopyData
est une exception, car il constitue une partie du flux de données ;
le contenu d'un message CopyData individuel n'est, en soi,
pas interprétable.
Marqueur de demande d'authentification.
Taille du message en octets, y compris la taille elle-même.
L'authentification a réussi.
Marqueur de demande d'authentification.
Taille du message en octets, y compris la taille elle-même.
Une authentification Kerberos V5 est requise.
Marqueur de demande d'authentification.
Taille du message en octets, y compris la taille elle-même.
Un mot de passe en clair est requis.
Marqueur de demande d'authentification.
Taille du message en octets, y compris la taille elle-même.
Spécifie qu'un mot de passe utilisant un hachage cryptographique par MD5 est requis.
Composante de salage (salt) à utiliser lors du
hachage du mot de passe.
Marqueur de demande d'authentification.
Taille du message en octets, y compris la taille elle-même.
Un message d'accréditation SCM est requis.
Identifie le message en tant que requête d'authentification.
Longueur du contenu du message en octets, lui-même inclus.
Spécifie qu'une authentification GSSAPI est requise.
Identifie le message en tant que requête d'authentification.
Longueur du message en octet, incluant la longueur.
Indique que le message contient des données GSSAPI ou SSPI.
n
Donnée d'authentification GSSAPI ou SSPI.
Identifie le message comme une requête d'authentification.
Taille du contenu du message en octets, y compris la taille elle-même.
Indique que l'authentification SSPI est requise.
Identifie le message comme une demande d'authentification.
Taille du message en octets, y compris la taille elle-même.
Précise qu'une authentification SASL est requise.
Le corps du message est une liste de mécanismes d'authentification SASL dans l'ordre de préférence du serveur. Un octet zéro est requis comme fin de chaîne après le nom du dernier mécanisme d'authentification. Pour chaque mécanisme, il existe ce qui suit :
Nom du mécanisme d'authentification SASL.
Identifie le message comme une demande d'authentification.
Taille du message en octets, y compris la taille elle-même.
Précise que ce message contient un challenge SASL.
n
Données SASL, spécifiques au mécanisme SASL utilisé.
Identifie le message comme une demande d'authentification.
Taille du message en octets, y compris la taille elle-même.
Indique que l'authentification SASL est terminée.
n
Données supplémentaires pour SASL, spécifique au mécanisme SASL utilisé.
Identifie le message comme une donnée clé d'annulation.
L'interface (frontend) doit sauvegarder ces
valeurs si elle souhaite être capable d'envoyer des messages
CancelRequest plus tard.
Longueur du contenu du message en octet incluent lui-même.
L'identifiant du processus serveur.
La clé secrète de ce processus serveur.
Identifie le message comme une commande Bind.
Longueur du contenu du message en octets incluant lui-même.
Le nom du portail destination (une chaîne vide sélectionne le portail non nommé).
Le nom de l'instruction préparée source (une chaîne vide sélectionne l'instruction préparée sans nom).
Le nombre de codes de format de paramètre qui suivent (dénoté
C ci-dessous). Il peut valoir zéro
pour indiquer qu'il n'y a pas de paramètres ou que tous les
paramètres utilisent le format par défaut (texte) ; il
peut valoir un, auquel cas le code de format spécifié est
appliqué à tous les paramètres ; ou il peut valoir le
nombre réel de paramètres.
C]
Les codes de format de la commande. Chaque code doit être exactement zéro (texte) ou un (binaire).
Le nombre de valeurs de paramètre qui suivent (potentiellement zéro). Ceci doit correspondre au nombre de paramètres nécessaires à la requête.
Puis, le couple de champs suivant apparaît pour chaque paramètre : paramètre :
Taille de la valeur du paramètre, en octets (ce nombre n'inclut pas la longueur elle-même). Peut valoir zéro. Traité comme un cas spécial, -1 indique une valeur de paramètre NULL. Aucun octet de valeur ne suit le cas NULL.
n
Valeur du paramètre, dans le format indiqué par le code de
format associé. n est la longueur ci-dessus.
Après le dernier paramètre, les champs suivants apparaissent :
Nombre de codes de format des colonnes de résultat qui
suivent (noté r ci-dessous). Peut valoir zéro
pour indiquer qu'il n'y a pas de colonnes de résultat ou que les
colonnes de résultat utilisent le format par défaut
(texte) ; ou une, auquel cas le code de format spécifié est
appliqué à toutes les colonnes de résultat (s'il y en a) ;
il peut aussi être égal au nombre de colonnes de résultat de la
requête.
r]
Codes de format des colonnes de résultat. Tous doivent valoir zéro (texte) ou un (binaire).
Indicateur de Bind complet.
Taille du message en octets, y compris la taille elle-même.
Taille du message en octets, y compris la taille elle-même.
Code d'annulation de la requête. La valeur est choisie pour
contenir 1234 dans les 16 bits les plus
significatifs et 5678 dans les 16 bits les moins
significatifs (pour éviter toute confusion, ce code ne doit pas
être le même qu'un numéro de version de protocole).
ID du processus du serveur cible.
Clé secrète du serveur cible.
Marqueur de commande Close.
Taille du message en octets, y compris la taille elle-même.
's' pour fermer une instruction préparée ; ou
'p' pour fermer un portail.
Nom de l'instruction préparée ou du portail à fermer (une chaîne vide sélectionne l'instruction préparée ou le portail non-nommé(e)).
Indicateur de complétude de Close.
Taille du message en octets, y compris la taille elle-même.
Marqueur de réponse de complétude de commande.
Taille du message en octets, y compris la taille elle-même.
Balise de la commande. Mot simple identifiant la commande SQL terminée.
Pour une commande insert, la balise est
insert où
oid
ligneslignes est le nombre de lignes insérées.
oid était l'id de l'objet de la ligne insérée
si lignes vaut 1 et que la table cible a des
OID, mais les colonnes systèmes OIDs ne sont plus
supportées; par conséquent oid
vaut toujours 0.
Pour une commande delete, la balise est
delete où
ligneslignes est le nombre de lignes supprimées.
Pour une commande update, la balise est
update où
ligneslignes est le nombre de lignes mises à jour.
Pour les commandes SELECT ou CREATE TABLE
AS, la balise est SELECT
où ligneslignes est le nombre de lignes récupérées.
Pour une commande move, la balise est
move où
ligneslignes est le nombre de lignes de déplacement
du curseur.
Pour une commande fetch, la balise est
fetch où
ligneslignes est le nombre de lignes
récupérées à partir du curseur.
Marqueur de données de COPY.
Taille du message en octets, y compris la taille elle-même.
n
Données formant une partie d'un flux de données
copy. Les messages envoyés depuis le serveur
correspondront toujours à des lignes uniques de données, mais
les messages envoyés par les clients peuvent diviser le flux de
données de façon arbitraire.
Indicateur de fin de COPY.
Taille du message en octets, y compris la taille elle-même.
Indicateur d'échec de COPY.
Taille du message en octets, y compris la taille elle-même.
Message d'erreur rapportant la cause d'un échec.
Marqueur de réponse de Start Copy In. Le client doit alors envoyer des données de copie (s'il n'est pas à cela, il enverra un message CopyFail).
Taille du message en octets, y compris la taille elle-même.
0 indique que le format de copie complet est textuel (lignes séparées par des retours chariot, colonnes séparées par des caractères de séparation, etc). 1 indique que le format de copie complet est binaire (similaire au format DataRow). Voir COPY pour plus d'informations.
Nombre de colonnes dans les données à copier (noté
n ci-dessous).
n]
Codes de format à utiliser pour chaque colonne. Chacun doit valoir zéro (texte) ou un (binaire). Tous doivent valoir zéro si le format de copie complet est de type texte.
Marqueur de réponse Start Copy Out. Ce message sera suivi de données copy-out.
Taille du message en octets, y compris la taille elle-même.
0 indique que le format de copie complet est textuel (lignes séparées par des retours chariot, colonnes séparées par des caractères séparateurs, etc). 1 indique que le format de copie complet est binaire (similaire au format DataRow). Voir COPY pour plus d'informations.
Nombre de colonnes de données à copier (noté
n ci-dessous).
n]
Codes de format à utiliser pour chaque colonne. Chaque code doit valoir zéro (texte) ou un (binaire). Tous doivent valoir zéro si le format de copie complet est de type texte.
Identifie le message comme une réponse Start Copy Both. Ce message est seulement utilisé pour la réplication en flux.
Longueur du contenu du message en octets, incluant lui-même.
0 indique que le format COPY global
est textuel (lignes séparées par des retours à la ligne,
colonnes séparées par des caractères séparateurs, etc).
1 indique que le format de copie global est binaire
(similaire au format DataRow). Voir COPY pour plus d'informations.
Le nombre de colonnes dans les données à copier
(dénoté N ci-dessous).
N]
Les codes de format utilisés pour chaque colonne. Chacune doit actuellement valoir 0 (texte) ou 1 (binaire). Tous doivent valoir 0 si le format de copy global est texte.
Marqueur de ligne de données.
Taille du message en octets, y compris la taille elle-même.
Nombre de valeurs de colonnes qui suivent (peut valoir zéro).
Apparaît ensuite le couple de champs suivant, pour chaque colonne :
Longueur de la valeur de la colonne, en octets (ce nombre n'inclut pas la longueur elle-même). Elle peut valoir zéro. Traité comme un cas spécial, -1 indique une valeur NULL de colonne. Aucun octet de valeur ne suit le cas NULL.
n
Valeur de la colonne dans le format indiqué par le code de
format associé. n est la longueur
ci-dessus.
Marqueur de commande Describe.
Taille du message en octets, y compris la taille elle-même.
's' pour décrire une instruction préparée ; ou
'p' pour décrire un portail.
Nom de l'instruction préparée ou du portail à décrire (une chaîne vide sélectionne l'instruction préparée ou le portail non-nommé(e)).
Marqueur de réponse à une chaîne de requête vide (c'est un substitut de CommandComplete).
Taille du message en octets, y compris la taille elle-même.
Marqueur d'erreur.
Taille du message en octets, y compris la taille elle-même.
Le corps du message est constitué d'un ou plusieurs champs identifié(s), suivi(s) d'un octet nul comme délimiteur de fin. L'ordre des champs n'est pas fixé. Pour chaque champ, on trouve les informations suivantes :
Code identifiant le type de champ ; s'il vaut zéro, c'est la fin du message et aucune chaîne ne suit. Les types de champs définis sont listés dans Section 53.8. De nouveaux types de champs pourraient être ajoutés dans le futur, les clients doivent donc ignorer silencieusement les types non reconnus.
Valeur du champ.
Marqueur de commande Execute.
Taille du message en octets, y compris la taille elle-même.
Nom du portail à exécuter (une chaîne vide sélectionne le portail non-nommé).
Nombre maximum de lignes à retourner si le portail contient une requête retournant des lignes (ignoré sinon). Zéro signifie : « aucune limite ».
Marqueur de commande Flush.
Taille du message en octets, y compris la taille elle-même.
Marqueur d'appel de fonction.
Taille du message en octets, y compris la taille elle-même.
Spécifie l'ID de l'objet représentant la fonction à appeler.
Nombre de codes de format de l'argument qui suivent
(noté c ci-dessous). Cela peut être zéro pour
indiquer qu'il n'y a pas d'arguments ou que tous les arguments
utilisent le format par défaut (texte) ; un, auquel cas
le code de format est appliqué à tous les arguments ; il
peut aussi être égal au nombre réel d'arguments.
c]
Les codes de format d'argument. Chacun doit valoir zéro (texte) ou un (binaire).
Nombre d'arguments fournis à la fonction.
Apparaît ensuite, pour chaque argument, le couple de champs suivant :
Longueur de la valeur de l'argument, en octets (ce nombre n'inclut pas la longueur elle-même). Peut valoir zéro. Traité comme un cas spécial, -1 indique une valeur NULL de l'argument. Aucun octet de valeur ne suit le cas NULL.
n
Valeur de l'argument dans le format indiqué par le code de
format associé. n est la longueur
ci-dessus.
Après le dernier argument, le champ suivant apparaît :
Code du format du résultat de la fonction. Doit valoir zéro (texte) ou un (binaire).
Marqueur de résultat d'un appel de fonction.
Taille du message en octets, y compris la taille elle-même.
Longueur de la valeur du résultat de la fonction, en octets (ce nombre n'inclut pas la longueur elle-même). Peut valoir zéro. Traité comme un cas spécial, -1 indique un résultat de fonction NULL. Aucun octet de valeur ne suit le cas NULL.
n
Valeur du résultat de la fonction, dans le format indiqué
par le code de format associé. n est
la longueur ci-dessus.
Taille du contenu du message en octets, taille incluse.
Le code de requête du chiffrement GSSAPI.
La valeur est choisie pour contenir 1234
dans les 16 bits les plus significatifs, et
5680 dans les 16 bits les moins
significatifs. (Pour éviter toute confusion, ce code ne doit
pas être le même que le numéro de version de n'importe quel
protocole.)
Identifie le message comme une réponse GSSAPI ou SSPI. Notez que ceci peut aussi être utilisé comme message de réponse SASL et password. Le type de message exact se déduit du contexte.
Longueur du contenu du message en octets, incluant lui-même.
n
Données spécifiques du message GSSAPI/SSPI.
Identifie le message comme un message de négociation de la version du protocole.
Longueur du contenu du message en octets, incluant la longueur elle-même.
Plus récente version mineure supportée par le serveur pour la version majeure du protocole demandée par le client.
Nombre d'options du protocole non reconnues par le serveur.
Puis, pour chaque option du protocole non reconnue par le serveur :
Nom de l'option.
Indicateur d'absence de données.
Taille du message en octets, y compris la taille elle-même.
Marqueur d'avertissement.
Taille du message en octets, y compris la taille elle-même.
Le corps du message est constitué d'un ou plusieurs champs identifié(s), suivi(s) d'un octet zéro comme délimiteur de fin. L'ordre des champs n'est pas fixé. Pour chaque champ, on trouve les informations suivantes :
Code identifiant le type de champ ; s'il vaut zéro, c'est la fin du message et aucune chaîne ne suit. Les types de champs déjà définis sont listés dans Section 53.8. De nouveaux types de champs pourraient être ajoutés dans le futur, les clients doivent donc ignorer silencieusement les champs de type non reconnu.
Valeur du champ.
Marqueur de réponse de notification.
Taille du message en octets, y compris la taille elle-même.
ID du processus serveur ayant procédé à la notification.
Nom du canal à l'origine de la notification.
La chaîne « embarquée » passée lors de la notification
Marqueur de description de paramètre.
Taille du message en octets, y compris la taille elle-même.
Nombre de paramètres utilisé par l'instruction (peut valoir zéro).
Pour chaque paramètre, on trouve ensuite :
ID de l'objet du type de données du paramètre.
Marqueur de rapport d'état de paramètre d'exécution.
Taille du message en octets, y compris la taille elle-même.
Nom du paramètre d'exécution dont le rapport est en cours.
Valeur actuelle du paramètre.
Marqueur de commande Parse.
Taille du message en octets, y compris la taille elle-même.
Nom de l'instruction préparée de destination (une chaîne vide sélectionne l'instruction préparée non-nommée).
Chaîne de requête à analyser.
Nombre de types de données de paramètre spécifiés (peut valoir zéro). Ce n'est pas une indication du nombre de paramètres pouvant apparaître dans la chaîne de requête, mais simplement le nombre de paramètres pour lesquels le client veut préspécifier les types.
Pour chaque paramètre, on trouve ensuite :
ID de l'objet du type de données du paramètre. La valeur zéro équivaut à ne pas spécifier le type.
Indicateur de fin de Parse.
Taille du message en octets, y compris la taille elle-même.
Identifie le message comme une réponse à un mot de passe. Notez que c'est aussi utilisé par les messages de réponse GSSAPI, SSPI et SASL. Le type exact du message se déduit du contexte.
Taille du message en octets, y compris la taille elle-même.
Mot de passe (chiffré à la demande).
Indicateur de suspension du portail. Apparaît seulement si la limite du nombre de lignes d'un message Execute a été atteinte.
Taille du message en octets, y compris la taille elle-même.
Marqueur de requête simple.
Taille du message en octets, y compris la taille elle-même.
La chaîne de requête elle-même.
Identifie le type du message. ReadyForQuery est envoyé à chaque fois que le serveur est prêt pour un nouveau cycle de requêtes.
Taille du message en octets, y compris la taille elle-même.
Indicateur de l'état transactionnel du serveur.
Les valeurs possibles sont 'i' s'il est en pause
(en dehors d'un bloc de transaction) ; 't' s'il
est dans un bloc de transaction ; ou 'e' s'il
est dans un bloc de transaction échouée (les requêtes seront
rejetées jusqu'à la fin du bloc).
Marqueur de description de ligne.
Taille du message en octets, y compris la taille elle-même.
Nombre de champs dans une ligne (peut valoir zéro).
On trouve, ensuite, pour chaque champ :
Nom du champ.
Si le champ peut être identifié comme colonne d'une table spécifique, l'ID de l'objet de la table ; sinon zéro.
Si le champ peut être identifié comme colonne d'une table spécifique, le numéro d'attribut de la colonne ; sinon zéro.
ID de l'objet du type de données du champ.
Taille du type de données (voir pg_type.typlen).
Les valeurs négatives indiquent des types de largeur variable.
Modificateur de type (voir pg_attribute.atttypmod).
La signification du modificateur est spécifique au type.
Code de format utilisé pour le champ. Zéro (texte) ou un (binaire), à l'heure actuelle. Dans un RowDescription retourné par la variante de l'instruction de Describe, le code du format n'est pas encore connu et vaudra toujours zéro.
Identifie le message comme une réponse SASL initiale. Notez que c'est aussi utilisé pour les messages de réponses pour GSSAPI, SSPI et password. Le type exact du message se déduit du contexte.
Longueur du contenu du message en octets incluant lui-même.
Nom du mécanisme d'authentification SASL que le client a sélectionné.
Longueur spécifique au mécanisme SASL pour le "Initial Client Response" qui suit, ou -1 s'il n'y a pas de réponse initiale.
n
"Initial Response" spécifique au mécanisme SASL.
Identifie le message comme une réponse SASL. Notez que ceci peut aussi être utilisé pour les messages de réponses pour GSSAPI, SSPI et password. Le type exact de message peut être déduit du contexte.
Longueur du contenu du message en octets, incluant sa propre longueur.
n
Données du message, spécifiques au mécanisme SASL.
Longueur du contenu du message en octets, incluant sa propre longueur.
Le code de demande SSL. La valeur est choisie
pour contenir 1234 dans les 16 bits les plus
significatifs, et 5679 dans les 16 bits les moins
significatifs. (Pour éviter la confusion, ce code ne doit pas être
le même que tout numéro de version du procotole.)
Longueur du contenu du message en octets, incluant sa propre longueur.
Le numéro de version du protocole. Les 16 bits les plus significatifs sont le numéro de version du protocole (3 pour le protocole décrit ici). Les 16 bits les moins significatifs sont le numéro de version mineure (0 pour le protocole décrit ici).
Le numéro de version du protocole est suivi par une ou plusieurs paires
de nom de paramètre / chaîne de valeur. Un octet zéro est requis comme
terminateur après la dernière paire nom/valeur. Les paramètres peuvent
apparaître dans n'importe quel ordre. user est
requis. Chaque paramètre est spécifié sous cette forme :
Le nom du paramètre. Les noms actuellement reconnus sont :
user
Le nom de l'utilisateur pour la connexion. Requis, sans valeur par défaut.
database
Base de données à laquelle se connecter. Par défaut le nom de l'utilisateur.
options
Arguments en ligne de commande pour le serveur (rendu obsolète
par l'utilisation de paramètres individuels d'exécution). Les
espaces dans cette chaîne sont considérés séparer les arguments,
sauf s'ils sont échappés avec un antislash
(\). Écrire \\ pour
représenter un antislash littéral.
replication
Utiliser pour connecter en mode de réplication en flux, où un
petit ensemble de commandes de réplication peuvent être
exécutées à la place de requêtes SQL. La valeur peut être
true, false ou
database, mais la valeur par défaut est
false. Voir Section 53.4 pour les détails.
En plus de ce qui est indiqué ci-dessus, les autres paramètres
peuvent être listés. Les noms de paramètres commençant par
_pq_. sont réservés à être utilisés comme des
extensions du protocole, alors que les autres sont traités comme des
paramètres à l'exécution à configurer au démarrage de la session. De
tels paramètres seront appliqués au lancement du processus (après
avoir analysé les arguments de la ligne de commande) et agiront
comme les valeurs par défaut de la session.
Valeur du paramètre.
Marqueur de commande Sync.
Taille du message en octets, y compris la taille elle-même.
Marqueur de fin.
Taille du message en octets, y compris la taille elle-même.