PostgreSQLWire

PostgreSQLWire フォーマットは、PostgreSQL ワイヤプロトコルの結果セット部分をシリアル化します。カラム名と型を含む RowDescription メッセージに続けて、結果の各行に対して 1 つの DataRow メッセージを書き出します。 値にはテキスト表現を使用し、NULL 値にはプロトコルの null フィールドエンコーディングを使用します。ブール値は t または f として書き出されます。

これは、ClickHouse の PostgreSQL インターフェイスを介して接続するクライアント向けの出力専用バイナリフォーマットです。インターフェイスは PostgreSQLWire をセッションの デフォルトとして設定し、クエリに明示的な FORMAT 句が含まれていない場合に使用します。明示的な句を指定するとデフォルトより優先されます。 他の出力フォーマットでは、有効な PostgreSQL 結果セットを生成できません。インターフェイスは、認証、コマンド完了、クエリ実行準備完了メッセージなどの 周辺プロトコルメッセージを書き出します。PostgreSQLWire は、クエリ結果をスタンドアロンファイルとして表示または保存することを目的としていません。

PostgreSQL インターフェイスを有効にしたら、互換性のあるクライアントでクエリを実行します。

psql -p 9005 -h 127.0.0.1 -U default -d default \
    -c "SELECT number, number % 2 = 0 AS even FROM numbers(3)"

クエリで FORMAT 句が指定されていないため、インターフェイスは結果を PostgreSQLWire で送信します。

PostgreSQLWire では、個々の値に対して標準のテキストシリアライゼーション設定を使用します。フォーマット固有の設定はありません。ブール値は常に PostgreSQL の t および f 表現でシリアライズされます。