はじめに
この記事では、PostgreSQLでテーブルを作成、削除する複数の方法を記載します。
開発環境
開発環境は以下の通りです。
- Windows11
- PostgreSQL 17.5
- pgAdmin4 8.7
また、事前準備として、PostgreSQLをインストールしておきます。
方法1. CLI - Powershell で psql シェルに入る
psql はPostgreSQLに付属しているコマンドラインツールです。
1. PostgreSQLに接続する
PowerShellから psql コマンドを実行して、PostgreSQLサーバーに接続します。
psql -U postgres -d postgres
-
-U: 接続するユーザー名 -
-d: 接続するデータベース名
このコマンドを実行すると、パスワードを尋ねられます。
Password for user postgres:
PostgreSQLのインストール時に設定したパスワードを入力し、Enterキーを押します。
パスワードが正しければ、プロンプトがpostgres=#に変わり、psqlシェルに入ります。
psql (17.5, server 16.3)
Type "help" for help.
postgres=#
2. テーブルを作成する
CREATE TABLE コマンドを使用してテーブルを作成します。
今回は従業員の情報を格納する employees テーブルを作成します。employee_id（主キー）、first_name、last_name、hire_date の4つのカラムを含めます。
CREATE TABLE employees (
employee_id SERIAL PRIMARY KEY,
first_name VARCHAR(50) NOT NULL,
last_name VARCHAR(50) NOT NULL,
hire_date DATE
);
コマンド実行後、CREATE TABLE という応答が返ります。
以下のコマンドでテーブルが作成されたか確認できます。
\dt
List of relations
Schema | Name | Type | Owner
--------+-----------+-------+----------
public | employees | table | postgres
(1 row)
また、以下のコマンドでは、カラムを確認できます。
\d employees
Table "public.employees"
Column | Type | Collation | Nullable | Default
-------------+-----------------------+-----------+----------+------------------------------------------------
employee_id | integer | | not null | nextval('employees_employee_id_seq'::regclass)
first_name | character varying(50) | | not null |
last_name | character varying(50) | | not null |
hire_date | date | | |
Indexes:
"employees_pkey" PRIMARY KEY, btree (employee_id)
3. テーブルを削除する
テーブルを削除するには、DROP TABLE コマンドを使用します。
DROP TABLE employees;
コマンド実行後、DROP TABLE という応答が返ります。
\dt コマンドでテーブルが削除されたか確認します。
\dt
Did not find any relations
4. PostgreSQLから切断する
psqlシェルを終了するには、\q コマンドを使用します。
\q
方法2. CLI - Powershell で qsal シェルに入らない
psql コマンドは、シェルを起動せずにSQLコマンドを直接実行することもできます。この方法は、スクリプトなどからコマンドを実行する場合に便利です。
1. テーブルを作成する
psql -U postgres -d postgres -c CREATE TABLE employees (employee_id SERIAL PRIMARY KEY,first_name VARCHAR(50) NOT NULL,last_name VARCHAR(50) NOT NULL,hire_date DATE);"
パスワードを尋ねられるので入力します。
2. テーブルを削除する
psql -U postgres -d postgres -c "DROP TABLE employees;"
パスワードを尋ねられるので入力します。
この方法の場合、コマンドのたびにパスワードを入力する必要があります。パスワードを環境変数に設定しておくことで、入力の手間を省くことも可能ですが、セキュリティ上のリスクもあるため、取り扱いには注意が必要です。
方法3. CLI - SQL Shell (psql)
PostgreSQLのインストール時に同梱されている「SQL Shell (psql)」を使う方法です。
SQL Shell (psql) を起動すると、以下の情報を聞かれます。
Server [localhost]: # そのままEnter
Database [postgres]: # そのままEnter
Port [5432]: # そのままEnter
Username [postgres]: # そのままEnter
Client Encoding [SJIS]: # そのままEnter
Password for user postgres: # パスワードを入力してEnter
パスワードを正しく入力すると、以下のようなプロンプトに変わります。
postgres=#
これで、PostgreSQLに接続されます。
テーブルの作成・削除自体の手順は、方法1. と同じです。
方法4. GUI - pgAdminを利用する
pgAdminは、PostgreSQLをGUI（グラフィカルユーザーインターフェース）で操作できるツールです。
1. サーバーに接続する
pgAdminを起動して左側のツリービューにある Servers の下の PostgreSQL17 をクリックします。パスワードの入力を求められた場合は、PostgreSQLインストール時に設定したパスワードを入力します。
2. テーブルを作成する
- 左側の「Browser」パネルで、目的のデータベース（
postgres）を展開します - Schemas -> public -> Tables を右クリックし、「Create」->「Table...」を選択します
- 「Create - Table」ウィンドウが開きます
- Generalタブの
Nameフィールドにテーブル名（employees）を入力します - Columnsタブのテーブル右側の「+」ボタンをクリックして、必要なカラムを追加します
- 画面右下の「Save」ボタンをクリックして、テーブルを作成します
pgAdminでもCLIと同じように、SQLクエリを実行してテーブルを作成することもできます。
左側の「Browser」パネルで、目的のテーブルを作成したいデータベースを右クリックし、「Query Tool」を選択することで、SQLクエリが実行できます。
3. テーブルを削除する
- 左側の「Browser」パネルで、削除したいテーブル（
employees）を右クリックします - 「Delete」を選択します
- 確認ダイアログが表示されるので、テーブル名を確認して「OK」をクリックします
まとめ
この記事では、Windows 11環境でPostgreSQLのテーブルを操作する4つの方法を解説しました。
用途に合わせてCLIとGUIを使い分けることで、効率的にデータベースを操作できるようにしたいですね。