Skip to main content

Description

Le format PostgreSQLWire sérialise la partie correspondant à l’ensemble de résultats du protocole filaire PostgreSQL. Il écrit un message RowDescription contenant les noms et les types de colonnes, suivi d’un message DataRow pour chaque ligne du résultat. Les valeurs utilisent leur représentation textuelle, les valeurs NULL utilisent l’encodage de champ nul du protocole et les booléens sont écrits sous la forme t ou f. Il s’agit d’un format binaire destiné uniquement à la sortie, pour les clients connectés via l’interface PostgreSQL de ClickHouse. L’interface définit PostgreSQLWire comme format par défaut de la session et l’utilise lorsque la requête ne comporte pas de clause FORMAT explicite. Une clause explicite remplace ce format par défaut ; les autres formats de sortie ne produisent pas un ensemble de résultats PostgreSQL valide. L’interface écrit les messages de protocole qui l’entourent, tels que les messages d’authentification, de fin de commande et d’état prêt pour une requête. PostgreSQLWire n’est pas destiné à afficher ou à stocker les résultats d’une requête dans un fichier autonome.

Exemple d’utilisation

Après avoir activé l’interface PostgreSQL, utilisez un client compatible pour exécuter une requête :
Comme la requête ne spécifie pas de clause FORMAT, l’interface renvoie le résultat au format PostgreSQLWire.

Paramètres de format

PostgreSQLWire utilise les paramètres standard de sérialisation textuelle pour les valeurs individuelles. Il ne possède aucun paramètre spécifique au format lui-même ; les booléens sont toujours sérialisés à l’aide des représentations t et f de PostgreSQL.
Dernière modification le 14 août 2026