PostgreSQL 接続・切断コマンド

 

 

目次

1. 前提条件
   • 動作確認環境
2. PostgreSQL 接続
3. PostgreSQL 切断

前提条件

• 今回説明する手順は、
  • 「PostgreSQLインストール （Windows編）」が実施されている前提で説明します。

 

 

動作確認環境

本ページの内容は、以下の環境で動作確認をしています。

• PostgreSQL 12.1 Windows 64bit

 

 

PostgreSQL 接続

1. PostgreSQLサーバに接続する場合は「psql」コマンドを利用します。
2. 「psql」コマンドを利用するためには、各OSにて以下のソフトウェアを起動する必要があります。
   • Windowsの場合は「コマンドプロンプト」を起動します。

 

3. Windowsの場合は、Windowsの検索ボックスで「コマンドプロンプト」もしくは「cmd」と入力し、表示されたコマンドプロンプト項目を選択するとコマンドプロンプトが起動します。

 

psql -h ホスト名 -p ポート番号 -U ロール名 -d データベース名

5. PostgreSQLサーバに接続するためのコマンド書式は、上記のとおりです。
   • ホスト名には、PostgreSQLサーバ接続先の「IPアドレス」or「URL」を指定します。もし接続先がローカル環境（同じPC環境）であれば指定不要です。
   • ポート番号には、PostgreSQLサーバのポート番号を指定します。デフォルトで「5432」が設定されます。
   • ロール名、データベース名には、定義済みのPostgreSQLのロール名、データベース名を指定します。

 

psql -p 5432 -U postgres -d postgres

6. ローカル環境のPostgreSQLサーバに接続するためには、上記のコマンドを実行します。

 

psql -U postgres

7. 「接続コマンド（1）」は、このように省略することが可能です。

 

ユーザ postgres のパスワード:

Password for user postgres:

7. 接続コマンドを実行すると「PostgreSQLサーバに接続するためのパスワード」の入力が求められます。

 

psql (12.1)

8. 正しいパスワードを入力すると、上記のような表示がされ、接続成功します。

 

psql: エラー: サーバに接続できませんでした: FATAL:  password authentication failed for user "postgres"

psql: error: could not connect to server: FATAL:  password authentication failed for user "postgres"

9. 誤ったパスワードを入力すると、上記のような表示がされ、接続失敗します。

 

postgres=#

10. PostgreSQLに接続（ログイン）すると、プロンプト表示が上記のようになります。
    • プロンプトには「PostgreSQLのログインユーザ名」が表示されます。

 

select * from pg_database;

  oid  |  datname  | datdba | encoding | datcollate  |  datctype   | datistemplate | datallowconn | datconnlimit | datlastsysoid | datfrozenxid | datminmxid | dattablespace |               datacl
-------+-----------+--------+----------+-------------+-------------+---------------+--------------+--------------+---------------+--------------+------------+---------------+-------------------------------------
 13332 | postgres  |     10 |        6 | en_US.UTF-8 | en_US.UTF-8 | f             | t            |           -1 |         13331 |          479 |          1 |          1663 |
     1 | template1 |     10 |        6 | en_US.UTF-8 | en_US.UTF-8 | t             | t            |           -1 |         13331 |          479 |          1 |          1663 | {=c/postgres,postgres=CTc/postgres}
 13331 | template0 |     10 |        6 | en_US.UTF-8 | en_US.UTF-8 | t             | f            |           -1 |         13331 |          479 |          1 |          1663 | {=c/postgres,postgres=CTc/postgres}
(3 rows)

11. PostgreSQL接続後は、コマンドからSQL文を実行することができます。

 

 

PostgreSQL 切断

\q

1. PostgreSQLサーバに接続中の状態で、上記の切断コマンドを入力すると「psql」が終了し、PostgreSQLサーバから切断（ログアウト）されます。