2
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

PostgreSQL ポータブル版のセットアップ(Windows環境)①

2
Last updated at Posted at 2026-07-01

PostgreSQLにはポータブル版があり、非インストールでも利用できる。
備忘のため、ダウンロード方法と簡易的なセットアップを残しておく。

- ① ダウンロードサイトへアクセス -

今回は、Windows版をダウンロードするので、Windowsのロゴをクリックする。

image.png

- ② Windows版 Zipアーカイブを選択 -

zipアーカイブをダウンロードするので、zip archive のリンクをクリックする。

image.png

- ③ ダウンロード -

必要な版数に応じて、ダウンロードする。
今回は、Version 17.10 を用いる。

image.png

- ④ ファイル解凍 -
「postgresql-17.10-2-windows-x64-binaries.zip」がダウンロードされているので、任意の場所に解凍する。

解凍すると、psql というフォルダができる。

- ⑤ ディレクトリの作成 -
psql 配下に、data と log ディレクトリを作成します。
それぞれ以下の用途で使用します。

 data:データベースクラスタの格納先
 log:ログ出力先

image.png

- ⑥ pg_ctlコマンドの確認 -
コマンドプロンプトを起動し、psql 配下に移動し、pg_ctlのヘルプを確認する。

pg_ctlヘルプ
[PostgreSQLの展開先となる任意のディレクトリ]\psql>bin\pg_ctl --help
pg_ctlはPostgreSQLサーバーの初期化、起動、停止、制御を行うユーティリティです。
使用方法:
  pg_ctl init[db]   [-D DATADIR] [-s] [-o OPTIONS]
  pg_ctl start      [-D DATADIR] [-l FILENAME] [-W] [-t SECS] [-s]
                    [-o OPTIONS] [-p PATH] [-c]
  pg_ctl stop       [-D DATADIR] [-m SHUTDOWN-MODE] [-W] [-t SECS] [-s]
  pg_ctl restart    [-D DATADIR] [-m SHUTDOWN-MODE] [-W] [-t SECS] [-s]
                    [-o OPTIONS] [-c]
  pg_ctl reload     [-D DATADIR] [-s]
  pg_ctl status     [-D DATADIR]
  pg_ctl promote    [-D DATADIR] [-W] [-t SECS] [-s]
  pg_ctl logrotate  [-D DATADIR] [-s]
  pg_ctl kill       SIGNALNAME PID
  pg_ctl register   [-D DATADIR] [-N SERVICENAME] [-U USERNAME] [-P PASSWORD]
                    [-S START-TYPE] [-e SOURCE] [-W] [-t SECS] [-s] [-o OPTIONS]
  pg_ctl unregister [-N SERVICENAME]

共通のオプション:
  -D, --pgdata=DATADIR   データベース格納領域の場所
  -e SOURCE              サービスとして起動させたときのログのイベントソース
  -s, --silent           エラーメッセージのみを表示、情報メッセージは表示しない
  -t, --timeout=SECS     -wオプションを使用する時に待機する秒数
  -V, --version          バージョン情報を表示して終了
  -w, --wait             操作が完了するまで待機 (デフォルト)
  -W, --no-wait          作業の完了を待たない
  -?, --help             このヘルプを表示して終了
-Dオプションの省略時はPGDATA環境変数が使用されます。

起動、再起動のオプション
  -c, --core-files       このプラットフォームでは適用されない
  -l, --log FILENAME     サーバーログをFILENAMEへ書き込む(または追加する)
  -o, --options=OPTIONS  postgres(PostgreSQLサーバー実行ファイル)または
                         initdb に渡すコマンドラインオプション
  -p PATH-TO-POSTGRES    通常は不要

停止、再起動のオプション
  -m, --mode=MODE        MODEは"smart"、"fast"、"immediate"のいずれか

シャットダウンモードは以下の通り:
  smart       全クライアントの接続切断後に停止
  fast        適切な手続きで直ちに停止(デフォルト)
  immediate   適切な手続き抜きで停止; 再起動時にはリカバリが実行される

killモードで利用できるシグナル名:
  ABRT HUP INT KILL QUIT TERM USR1 USR2

登録、登録解除のオプション:
  -N SERVICENAME  PostgreSQLサーバーを登録する際のサービス名
  -P PASSWORD     PostgreSQLサーバーを登録するためのアカウントのパスワード
  -U USERNAME     PostgreSQLサーバーを登録するためのアカウント名
  -S START-TYPE   PostgreSQLサーバーを登録する際のサービス起動タイプ

起動タイプは以下の通り:
  auto       システムの起動時にサービスを自動的に開始(デフォルト)
  demand     要求に応じてサービスを開始

バグは<pgsql-bugs@lists.postgresql.org>に報告してください。
PostgreSQL ホームページ: <https://www.postgresql.org/>

- ⑦ データベースクラスタの初期化 -
コマンドプロンプト上で psql 配下より、pg_ctl initdbコマンドを実行。
データベースクラスタを作成する。

※ 以下のコマンドを実行する前に ”cd [PostgreSQLの展開先となる任意のディレクトリ]” でディレクトリを移動している

データベースクラスタの初期化
>set data_dir="[PostgreSQLの展開先となる任意のディレクトリ]\pgsql\data"
>pgsql>bin\pg_ctl initdb -D %data_dir% -o "-A scram-sha-256 -W -U postgres -E UTF8 --no-locale"
データベースシステム内のファイルの所有者はユーザー"XXXX"となります。
このユーザーをサーバープロセスの所有者とする必要があります。

データベースクラスタはロケール"C"で初期化されます。
デフォルトのテキスト検索構成は english に設定されます。

データベージのチェックサムは無効です。

新しいスーパーユーザーのパスワードを入力してください:

再入力してください:


ディレクトリ[PostgreSQLの展開先となる任意のディレクトリ]/pgsql/dataの権限を設定しています ... ok
サブディレクトリを作成しています ... ok
動的共有メモリの実装を選択しています ... windows
デフォルトの"max_connections"を選択しています ... 100
デフォルトの"shared_buffers"を選択しています ... 128MB
デフォルトの時間帯を選択しています ... Asia/Tokyo
設定ファイルを作成しています ... ok
ブートストラップスクリプトを実行しています ... ok
ブートストラップ後の初期化を実行しています ... ok
データをディスクに同期しています ... ok

成功しました。以下のようにしてデータベースサーバーを起動できます:

    "[PostgreSQLの展開先となる任意のディレクトリ]\pgsql\bin\pg_ctl" -D [PostgreSQLの展開先の展開先となる任意のディレクトリ]/pgsql/data -l ログファイル start

データベースクラスタの初期化の説明と、初期化時のオプションは以下を参照。

image.png

- ⑧ DB起動 -
起動時のログファイル名を指定して、DBを起動する。

DB起動
>rem dateから年月日を切り出す
>set year=%date:~0,4%
>set month=%date:~5,2%
>set day=%date:~8,2%
>set date2=%year%%month%%day%
>
>rem 現在時刻を取得し、1桁の時間の前につく空白を0埋め
>set time2=%time: =0%
>
>rem 「time」から切り出した数字をそれぞれ変数に代入
>set hour=%time2:~0,2%
>set minute=%time2:~3,2%
>set second=%time2:~6,2%
> 
>set time3=%hour%%minute%%second%
>set log_file="[PostgreSQLの展開先となる任意のディレクトリ]\pgsql\log\%date2%_%time3%.log"
>
>rem ログファイル名の確認
>echo %log_file%
"[PostgreSQLの展開先となるディレクトリ]\pgsql\log\20260702_065456.log"

>set data_dir="[PostgreSQLの展開先となる任意のディレクトリ]\pgsql\data"
>bin\pg_ctl -D %data_dir% -l %log_file% start
サーバーの起動完了を待っています....完了
サーバー起動完了

下記のようにログが出力されているので、確認する。

image.png

起動ログ確認
2026-07-02 06:55:23.894 JST [7544] LOG:  starting PostgreSQL 17.10 on x86_64-windows, compiled by msvc-19.44.35227, 64-bit
2026-07-02 06:55:23.912 JST [7544] LOG:  listening on IPv6 address "::1", port 5432
2026-07-02 06:55:23.912 JST [7544] LOG:  listening on IPv4 address "127.0.0.1", port 5432
2026-07-02 06:55:24.102 JST [19044] LOG:  database system was shut down at 2026-07-02 06:46:51 JST
2026-07-02 06:55:24.258 JST [7544] LOG:  database system is ready to accept connections

- ⑨ 起動状況確認 -
コマンドから起動状況の確認ができるので、確認してみる。

ステータス確認
>bin\pg_ctl -D %data_dir% status
pg_ctl: サーバーが動作中です(PID: 7544)
[PostgreSQLの展開先となる任意のディレクトリ]/pgsql/bin/postgres.exe "-D" "[PostgreSQLの展開先となる任意のディレクトリ]/pgsql/data"

- ⑩ 接続確認 -
作成したDBへ接続してみる。

データベースクラスタの初期化時に作成した postgres ユーザーを用いて、デフォルトで作成される データベース名:postgres へ接続する。ポート番号は、デフォルトの5432。変更したい場合には postgresql.conf から変更する。(今回は、このまま。)

PostgreSQL接続
>bin/psql -h localhost -p 5432 -U postgres -d postgres
'bin' は、内部コマンドまたは外部コマンド、
操作可能なプログラムまたはバッチ ファイルとして認識されていません。

[PostgreSQLの展開先となる任意のディレクトリ]\pgsql>bin\psql -h localhost -p 5432 -U postgres -d postgres
ユーザー postgres のパスワード:

psql (17.10)
"help"でヘルプを表示します。

postgres=# \du
                                       ロール一覧
 ロール名 |                                     属性
----------+------------------------------------------------------------------------------
 postgres | スーパーユーザー, ロール作成可, DB作成可, レプリケーション可, RLS のバイパス


postgres=# select * from version();
                                 version
--------------------------------------------------------------------------
 PostgreSQL 17.10 on x86_64-windows, compiled by msvc-19.44.35227, 64-bit
(1 行)


postgres=# \q

- ⑪ DB停止 -
DBを停止する。

DB停止
>bin\pg_ctl -D %data_dir% stop
サーバー停止処理の完了を待っています....完了
サーバーは停止しました

>bin\pg_ctl -D %data_dir% status
pg_ctl: サーバーが動作していません

ログファイルからも確認してみる。

DB停止
2026-07-02 06:55:23.894 JST [7544] LOG:  starting PostgreSQL 17.10 on x86_64-windows, compiled by msvc-19.44.35227, 64-bit
2026-07-02 06:55:23.912 JST [7544] LOG:  listening on IPv6 address "::1", port 5432
2026-07-02 06:55:23.912 JST [7544] LOG:  listening on IPv4 address "127.0.0.1", port 5432
2026-07-02 06:55:24.102 JST [19044] LOG:  database system was shut down at 2026-07-02 06:46:51 JST
2026-07-02 06:55:24.258 JST [7544] LOG:  database system is ready to accept connections
2026-07-02 07:00:24.036 JST [12988] LOG:  checkpoint starting: time
2026-07-02 07:00:28.808 JST [12988] LOG:  checkpoint complete: wrote 45 buffers (0.3%); 0 WAL file(s) added, 0 removed, 0 recycled; write=4.728 s, sync=0.026 s, total=4.772 s; sync files=11, longest=0.015 s, average=0.003 s; distance=269 kB, estimate=269 kB; lsn=0/15B65E0, redo lsn=0/15B6550
2026-07-02 07:14:50.018 JST [7544] LOG:  received fast shutdown request
2026-07-02 07:14:50.056 JST [7544] LOG:  aborting any active transactions
2026-07-02 07:14:50.069 JST [7544] LOG:  background worker "logical replication launcher" (PID 15944) exited with exit code 1
2026-07-02 07:14:50.070 JST [12988] LOG:  shutting down
2026-07-02 07:14:50.074 JST [12988] LOG:  checkpoint starting: shutdown immediate
2026-07-02 07:14:50.090 JST [12988] LOG:  checkpoint complete: wrote 0 buffers (0.0%); 0 WAL file(s) added, 0 removed, 0 recycled; write=0.001 s, sync=0.001 s, total=0.021 s; sync files=0, longest=0.000 s, average=0.000 s; distance=0 kB, estimate=242 kB; lsn=0/15B6690, redo lsn=0/15B6690
2026-07-02 07:14:50.110 JST [7544] LOG:  database system is shut down

database system is shut down の文言があることから、きちんと停止できていることが確認できる。

次回はpgAdmin4で接続確認する。

-- 参考 --

2
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
2
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?