PostgreSQL で住所マスタを作る 〜郵便住所.jp の CSV を使って〜

こんにちは。株式会社 Interfamilia の Kuma です。

会員情報に住所を持たせたい、入力フォームで郵便番号から住所を自動補完したい、都道府県のプルダウンを作りたい……。
システムを開発していると、郵便番号や住所のマスタが必要になる場面はしょっちゅうあります。

当社では、そんなときに使えるサービスとして 郵便住所.jp を公開しています。
日本郵便さんが公開している郵便番号データを整理して、欲しい項目だけを選んで CSV でダウンロードできるサービスです。

郵便住所.jp
郵便番号検索、住所検索、住所マスタ用 CSV ダウンロードサービス

今回の記事では、この 郵便住所.jp からダウンロードした CSV を使って、PostgreSQL に住所マスタのデータベースを作るところまでを、ひととおりやってみたいと思います。
docker compose up を実行したらデータベースもテーブルもデータも全部できあがっている、という状態をゴールにします。

※初学者向けの記事になっています。