0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【備忘録】psqlの使い方

0
Last updated at Posted at 2026-08-12

SQLとpsqlコマンドは別物

この区別は非常に重要で、SQLコマンドとpsqlコマンドは別物であるということ。
SQLコマンド:データベースを操作するもの:SELECT * FROM table
psqlコマンド:PostgreSQLを操作するもの:\dt

psqlコマンドは基本的に\からはじまる。

postgres=#とは何か

psqlに接続されたときに表示されるプロンプト。

  • postgresの部分は、現在接続しているデータベース名。
  • #の部分は、ログインユーザーが誰かを示すもの。#はスーパーユーザーであることを示し、一般ユーザーなら>になる。
  • =の部分は、プロンプトの入力状態を示す。
postgres=#     通常状態
postgres-#     SQLの入力途中
postgres'#     シングルクォート ' の途中
postgres"#     ダブルクォート " の途中
postgres(#     括弧 ( の途中

psqlを起動する

> psql -U <ユーザー名> -d <データベース名>

データベースを作成する

CREATE DATABASE <データベース名>;  # 基本形
CREATE DATABASE my_database;      # 実例

データベース一覧を見る

listのlと覚える。

\l

データベースへ接続する

\c <データベース名>;  # 基本形
\c my_database;      # 実例

現在どのデータベースにいるか確認する

\conninfo

テーブル一覧を見る

\dt

テーブルの構造を見る

\d <テーブル名>

シーケンス一覧を見る

\ds  -- シーケンス一覧
\ds+ -- より詳しい内容

ビュー一覧を見る

\dv  -- ビュー一覧
\dv+ -- より詳しい内容

入力を間違えた場合

SQLの入力中に間違えた場合は、次のコマンドでリセットする。

\r

もしくは、Ctrl+cで入力をキャンセルする。

psqlを終了するには

\q

PostgreSQLユーザーとは

OSのユーザーとは別に、PostgreSQL内部のユーザーがある。
PostgreSQLでは正確には「ロール」と呼ばれる。
ユーザー一覧を表示するには\duコマンドを入力する。

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

現在のユーザーを確認するには次のコマンド。

SELECT current_user;

次のコマンドでも現在のユーザー+αの情報が確認できる。

\conninfo

ユーザーを作成する

# 基本形
CREATE USER <ユーザー名>
WITH PASSWORD '<パスワード>';

# 実例
CREATE USER hoge_user
WITH PASSWORD 'hogehoge123';

作成後は\duで確認。

ユーザーを切り替える

ユーザーを切り替える場合、接続先DBとユーザーを指定して接続しなおす、という形になる。

\c <データベース名> <ユーザー名>;  # 基本形
\c my_database hoge_user;        # 実例

これでmy_databaseへhoge_userとして接続することができる。

ユーザーを削除する

DROP USER <ユーザー名>;  # 基本形
DROP USER hoge_user;  # 実例

ユーザーには権限を与えないと何もできない

ユーザーが特定の操作を行うには権限が必要。詳しくはこちらに記載。

0
0
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
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?