はじめに

日付：2026年7月2日（木）/ 19日目

午前はpsqlでのspool操作手順の確認、
午後は初めて一から手順書を作成するという
貴重な経験をした一日。

psqlでのspool操作

Oracleの「spool」機能と同様に、
psqlでもSQLの実行結果をファイルに保存できる。

目的：
DBの照会結果をファイルとして出力し、
作業証跡としてダウンロード後、サーバー上のファイルを削除する。

!（バックスラッシュ＋エクスクラメーション）とは

psqlの中でLinuxコマンドを実行するには \! を先頭につける必要がある。

状態	コマンドの使い方
psql接続前（Linuxサーバー上）	`ls`・`pwd` などそのまま使用可能
psql接続後（DBプロンプト内）	`\! ls`・`\! pwd` のように `\!` が必要

作業手順

# 1. BastionサーバーへSSH接続（ブラウザ経由）

# 2. psqlにログイン
PGPASSWORD=$(gcloud auth print-access-token) psql \
  "host=[ホスト名] port=[ポート番号] user=[USERNAME] dbname=[DB名] sslmode=require"

# 3. スキーマ設定・安全装置
SET SEARCH_PATH TO [スキーマ名];
\set AUTOCOMMIT off
\echo :AUTOCOMMIT

# 4. 現在のディレクトリ確認
\! pwd

# 5. ファイル一覧確認
\! ls -l

# 6. spool開始（出力先ファイルを指定）
\o [ファイル名].csv

# 7. SELECT文を実行（結果がファイルに書き込まれる）
SELECT ...;

# 8. spool終了
\o

# 9. ファイルが作成されたか確認
\! ls -l

# 10. エラーが出た場合はrollback
rollback;

# 11. ブラウザ右上のダウンロードボタンでファイル取得

# 12. サーバー上のファイルを削除
\! rm -i [ファイル名].csv

# 13. 削除確認
\! ls -l

全体の流れ

ブラウザ（ローカルPC）
│
│ ① SSH接続（クラウド提供のブラウザSSH）
↓
Bastionサーバー（Linux）
│
│ ② psqlコマンドで接続
↓
PostgreSQL DB
│
│ ③ \o コマンド（spool）で結果をファイルに保存
↓
ファイル（.csv）→ ブラウザからダウンロード → サーバー上から削除

一言まとめ：
SSH → psql → spool（\o）の3層構造で
DBの結果をファイルとして取り出す作業。

気づき

Oracleでは「spool」と書くが、
psqlでは \o コマンドで同じことができる。
名前は違うが目的は同じ。
「ツールが違っても概念は同じ」という発見が面白かった。

初めて一から手順書を作成した

午後は、特定のエラーへの対応手順書を
一から作成する作業を担当した。

参考にできる既存の手順書はなく、
いくつかの事例資料だけを頼りに書き上げた。

エラーの概要

項目	内容
エラー種別	ファイルダウンロードエラー
原因	外部サービス上のファイルが削除されているにもかかわらず、システム側に参照情報が残っている
エラーメッセージ	`The requested resource does not exist`

作業の流れ

① エラーメールの内容確認（調査票ID・ファイルIDを特定）
↓
② BastionサーバーへSSH接続
↓
③ psqlでDBにログイン
↓
④ 事前クエリ実行（スキーマ設定・AUTOCOMMIT off）
↓
⑤ 対象ファイルの照会（SELECT文でファイル情報を確認）
↓
⑥ psqlからログアウト
↓
⑦ 削除対象ファイルの特定（エラーメールのファイルIDと照合）
↓
⑧ 管理画面からファイルを削除
↓
⑨ 関係者へ通知

DBへの照会（SELECT文）

-- 事前クエリ
set search_path to [スキーマ名];
\set AUTOCOMMIT off
\echo :AUTOCOMMIT

-- 対象ファイルの照会
select
  rid, file_name, download_kubun,
  upload_date, download_date,
  expire_date, entity_file_name, file_id
from
  delivery_data
where
  rid = [RID];

照会結果の中で download_kubun = 2 のレコードが
外部サービス経由のファイルに該当する。

必要なDB権限

[x] read
[ ] write
[ ] sequence

手順書作成で意識したこと

ポイント	内容
初めて読む人でもわかる	専門用語には補足を入れる
番号で順序を明確に	「次に何をするか」が迷わないように
DB権限を冒頭に明示	作業前に必要な権限がわかるようにする
エラー時の対処も記載	rollbackなど異常系も手順に含める

感想

spoolという概念自体が初めてで、
さらにpsqlでは \o という別の書き方をすることも新鮮だった。
同じ意味なのに名前が違うというのが
エンジニアの世界らしいと感じた。

午後の手順書作成は、既存の手順書が一切ない状態から
事例資料だけを頼りに書き上げるのは
想像以上に大変だった。

「次の人が迷わないように」を意識しながら
一つひとつの手順を言語化する作業は、
自分自身の理解を深めることにもつながった。

これからレビューを受けて何度も修正することになるだろうが、
「自分が作った手順書がチームの役に立つ」と思うと
とてもやりがいを感じる。

少しずつでもチームに貢献できていることが本当に嬉しい。
明日は会食もあるので、今日も全力で駆け抜けた！