psqlコマンドでSQL抽出結果をCSVファイルに出力する方法のまとめです。
色々制限があって、詰まったところが多々あったので、
備忘録ついでに投稿します。

実施環境

OS: Windows 11
DBMS: PostgreSQL16
エミュレータ: TeraTerm 5.2

実現したいこと

SQL実行結果をCSVファイルに出力する

➀実行するクエリはSQLファイルに保存したものを呼び出す
②実行はデータベースに接続後、実施する
③セル内改行やセル内カンマに対応　※ダブルクォーテーションで囲む

CSV出力といえば、\copyコマンドがまず検索で該当します。
例えば、

\copy (SELECT * FROM table) to 'export.csv' DELIMITER ',' WITH CSV FORCE QUOTE *

これでクエリ結果をCSVに出力できて、
CSV形式の区切り文字[,]
ダブルクォーテーションで囲まれます。
ただし、残念ながら保存したSQLファイルでクエリを実行できない。

じゃあということでSQL文にCOPY文を記載しておいて、
実行してみます。
SQL文はこんな感じ

COPY (SELECT * FROM table) TO 'export.csv' DELIMITER ',' WITH CSV FORCE QUOTE *;

こいつを\iコマンドで実行すればいける！
と思いきや、postgreがリモートだとCOPY文は実行できないらしいです。
ローカルでしか使えないとは.......

ならばならばということで、
psqlコマンドで出力条件と出力先を設定して、
SQLファイルで実行してみました。

\a             - 文字揃えをオフ
\f ','         - 区切り文字をカンマに
\o export.csv  - 出力先を変更
\i export.sql  - SQLファイルを実行

確かにCSVにカンマ区切りで出力できる！
のですが、セル内改行があってもダブルクォーテーションで囲めない
おしい

色々試してたどり着いたのが、
\psetコマンドで出力形式をCSVフォーマットに変更してから、
実行する方法です。

\pset format CSV  - CSV出力形式に変更
\o export.csv     - 出力先を変更
\i export.sql     - SQLファイルを実行

なんとこれだけで、カンマ区切りにもなって、
セル内改行やセル内カンマがあるとダブルクォーテーションで囲ってくれて、
\iコマンドも併用できる。やったー！
注意点としてはPostgreSQL 12以降じゃないとサポートされてないようです。

今回は、psqlコマンドを使ってのクエリ結果のCSV出力方法でした。
色々と制限があること前提なので、
\copyコマンドで問題ない場合がほとんどな気はしますが、
色々こねくりまわした結果お手軽な方法にたどり着いたので、
これはこれで良し