こんにちは！データベースやAPIと日々格闘していると、ほんの小さな手間の積み重ねが、じつに大きなストレスになっていることってありますよね。
「PostgreSQLのデータをちょっと確認して、Excelに貼り付けたいだけなのに……」
「API開発のモック用に、クエリ結果をサクッとJSON形式で取得したいだけなのに……」
わざわざCSVファイルとしてエクスポートして、テキストエディタを開いて置換して……なんてやっていませんか？
今回は、PostgreSQLの公式管理ツールであるpgAdmin 4に備わっている、「クエリツールからのCSV/JSONクリップボード直接コピー機能」と、それに伴うデータ整形テクニックを徹底的に解説します。これをマスターすれば、毎日の地味なデータ加工地獄から抜け出し、開発効率が劇的に跳ね上がりますよ。
—
1. pgAdmin 4 とは何か？（ツールの役割と基礎）
pgAdmin 4は、PostgreSQLデータベースを視覚的に操作・管理するための最もポピュラーなGUIクライアントです。
黒い画面（CUI）のコマンドライン（`psql`）も渋くてカッコいいですが、テーブルの構造をツリービューで確認したり、複雑なSQLの実行結果をスプレッドシート感覚で閲覧・編集したりするには、やはり優れたGUIツールが欠かせません。pgAdmin 4はその決定版と言えます。
インストールと最初にやっておくべき環境構築
pgAdmin 4は、公式サイト（[pgAdmin.org](https://www.pgadmin.org/)）からWindows、macOS、Linux向けに簡単にダウンロード・インストールできます。
インストール後、最初に起動するとブラウザ（またはデスクトップアプリ版の内部ウィンドウ）が立ち上がります。左上の「Servers」を右クリックして接続先（ローカルのPostgreSQLやクラウド上のDB）を登録すれば、すぐに使い始められます。
—
2. 【HelloWorld】まずはデータを覗いてみよう
ツールの基本的な操作に慣れるため、簡単なサンプルテーブルを作って、クエリツールからデータを取得してみましょう。
以下のSQLをpgAdmin 4の「Query Tool（クエリツール）」に入力し、稲妻アイコン（Execute）を押してみてください。
— テスト用のユーザーテーブルを作成
CREATE TABLE IF NOT EXISTS users (
id SERIAL PRIMARY KEY,
name VARCHAR(50),
email VARCHAR(100),
is_active BOOLEAN,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
— サンプルデータを挿入
INSERT INTO users (name, email, is_active) VALUES
(‘山田 太郎’, ‘yamada@example.com’, true),
(‘佐藤 花子’, ‘sato.hanako@example.com’, false),
(‘鈴木 “The Boss” 一郎’, ‘suzuki@example.com’, true); — ダブルクォーテーションを含むデータ
— データの確認
SELECT FROM users;
無事に下のグリッド（データグリッドペイン）に結果が表示されましたか？これが基本の「Hello World」です。
—
3. 現場で震えるほど役立つ！クリップボード直接コピーの極意
ここからが本題です。SQLの結果を、ファイル保存のワンクッションなしで、直接クリップボードにCSVやJSONとしてコピーするテクニックを見ていきましょう。
3-1. 普通のコピーではダメな理由
データグリッド上のセルをマウスでドラッグして「Ctrl + C」でコピーし、Excelに貼り付けてみてください。
タブ区切りになりますが、データ内に「改行」や「タブ」、あるいは「ダブルクォーテーション」が含まれていると、Excel側で盛大にセルが崩れます。
3-2. 「Download as CSV / Copy as CSV」を使いこなす
pgAdmin 4のクエリツール上部にあるツールバー、またはデータグリッドのコンテキストメニュー（右クリック）には、強力なエクスポート機能が隠されています。
ここでCSVやJSONとしてコピー（またはダウンロード）する際の設定が、現場のエンジニアの命を救います。
設定の肝：Preferences（環境設定）を覗いてみよう
メニューの [File] -> [Preferences]（macOSの場合は `pgAdmin 4` -> `Preferences`）を開き、左メニューから [Query Tool] を選択してください。
ここには、データコピー時の挙動を制御する神設定が眠っています。
1. Quote all text columns（すべてのテキスト列をクォーテーションで囲む）
- APIや外部システムにデータを渡す際、文字列型はすべてダブルクォーテーション(`”`)で囲みたくなりますよね。ここを有効にします。
2. Field separator（フィールド区切り文字）
- デフォルトはカンマ(`,`)ですが、タブ(`\t`)やパイプ(`|`)に変更可能です。
3. Null value string（NULL値の表現）
- データベースの `NULL` を、空白にするのか、文字列の `”NULL”` や `”\N”` にするのかを指定できます。ここを空にしておくことで、API側のパースエラーを防げます。
—
4. JSON形式でクリップボードへ直行！API開発を爆速化するテクニック
フロントエンドの開発や、他システム連携のモックデータ作成で、「SQLの結果をそのままJSONの配列として欲しい！」という場面は数知れずあります。
pgAdmin 4の機能に頼るのも手ですが、PostgreSQLの強力なJSON集約関数（`json_agg` と `json_build_object`）を組み合わせたSQLをクエリツールで実行し、その結果をそのままコピーするのが、実は最も柔軟で実用的です。
以下のクエリを叩いてみてください。
— テーブル全体を綺麗なJSONの配列として取得するクエリ
SELECT json_agg(
json_build_object(
‘user_id’, id,
‘full_name’, name,
‘contact_email’, email,
‘status’, is_active
)
) AS json_result
FROM users;
このクエリの何がすごいのか？
- 取得結果のグリッドには、1行だけ、きれいにフォーマットされた大きなJSON文字列が表示されます。
- グリッド上のそのセルを右クリックし、「Copy as JSON」（またはセルをダブルクリックしてテキストとしてコピー）を実行します。
- これにより、APIのレスポンスボディや、テスト用のJSONファイル（`fixtures.json`など）にそのままペーストできるきれいなJSONが手に入ります。
Excelでマニュアル整形したり、適当なスクリプトを書いたりする時間が完全にゼロになります。
—
5. ありがちなトラブルと回避の知見（FAQ）
最後に、現場でよくある「ハマりどころ」とスマートな回避策をシェアします。
- Q. 大量データ（10万件以上）をクリップボードにコピーしてフリーズした！
- A. 犯罪的な量のデータをGUIのクリップボード経由でコピーしてはいけません。メモリが枯渇します。1万件を超えるデータを取り扱う場合は、クエリツールを使わず、`COPY command` を使ってファイルに出力するか、ページング（`LIMIT / OFFSET`）を効かせてください。
- Q. エスケープされたダブルクォーテーションがおかしくなる
- A. 先ほどのサンプルにあった `鈴木 “The Boss” 一郎` のようなデータですね。CSVの仕様では、ダブルクォーテーションは二重（`””`）にエスケープされるべきです。pgAdminのCSVコピー機能はこれを自動で処理してくれますが、自前で加工する際はPostgreSQLの `REPLACE(name, ‘”‘, ‘””‘)` などの関数であらかじめ整えておくと安心です。
—
まとめ
今回は、pgAdmin 4のクエリツールにおける知る人ぞ知るデータ整形・コピー機能と、JSON集約クエリを組み合わせた実践的なテクニックをご紹介しました。
- データの簡易書き出しなら、環境設定（Preferences）を最適化したCSVコピーを活用する。
- API開発やモック作成なら、`json_agg` + `json_build_object` でSQL側でJSON化し、そのままコピーする。
日々の開発における「ちょっとした面倒くさい手作業」を自動化・効率化することで、より本質的なアーキテクチャ設計やコード実装に集中できるようになります。
これをマスターすれば、あなたの毎日のデータベース作業は間違いなく劇的に楽になりますよ。ぜひ今日の業務から試してみてください！