PostgreSQLにはポータブル版があり、非インストールでも利用できる。
備忘のため、ダウンロード方法と簡易的なセットアップを残しておく。
- ① ダウンロードサイトへアクセス -
今回は、Windows版をダウンロードするので、Windowsのロゴをクリックする。
- ② Windows版 Zipアーカイブを選択 -
zipアーカイブをダウンロードするので、zip archive のリンクをクリックする。
- ③ ダウンロード -
必要な版数に応じて、ダウンロードする。
今回は、Version 17.10 を用いる。
- ④ ファイル解凍 -
「postgresql-17.10-2-windows-x64-binaries.zip」がダウンロードされているので、任意の場所に解凍する。
解凍すると、psql というフォルダができる。
- ⑤ ディレクトリの作成 -
psql 配下に、data と log ディレクトリを作成します。
それぞれ以下の用途で使用します。
data:データベースクラスタの格納先
log:ログ出力先
- ⑥ pg_ctlコマンドの確認 -
コマンドプロンプトを起動し、psql 配下に移動し、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
データベースクラスタの初期化の説明と、初期化時のオプションは以下を参照。
- ⑧ 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
サーバーの起動完了を待っています....完了
サーバー起動完了
下記のようにログが出力されているので、確認する。
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 から変更する。(今回は、このまま。)
>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を停止する。
>bin\pg_ctl -D %data_dir% stop
サーバー停止処理の完了を待っています....完了
サーバーは停止しました
>bin\pg_ctl -D %data_dir% status
pg_ctl: サーバーが動作していません
ログファイルからも確認してみる。
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で接続確認する。
-- 参考 --





