サイトの全体構成

psql の主要機能（Windows 上）

psql は，PostgreSQL に関する各種操作を，簡単に行えるツール．

Ubuntu については，別ページ »で説明している．

【サイト内の主な PostgreSQL 関連ページ】

Windows での，PostgreSQL 14.5，pgAdmin 4，PostGIS 3 のインストール，psql によるテーブル定義とレコード挿入: 別ページ »で説明している．
Ubuntu での，PostgreSQL 14, pgAdmin 4, PostGIS 3 のインストール: 別ページ »で説明している．
PostgreSQL の活用: 別ページ »にまとめている．

【関連する外部ページ】

PostgreSQL 公式ページ: http://www.postgresql.org/
カーネル設定: http://www.postgresql.jp/document/14/html/kernel-resources.html
インストール: http://www.postgresql.jp/document/14/html/installation.html

1. 前準備

PostgreSQL のインストール

Windows での，PostgreSQL 14.5，pgAdmin 4，PostGIS 3 のインストール，psql によるテーブル定義とレコード挿入: 別ページ »で説明している．
Ubuntu での，PostgreSQL 14, pgAdmin 4, PostGIS 3 のインストール: 別ページ »で説明している．

あらかじめ決めておく事項

このページでは，データベースの作成を行うので，作成するデータベースのデータベース名と文字コード（エンコーディング）を決めておくこと．このページでは，次のように書く．

データベース名: mydb
データベース名は，自由に決めてよいが，半角文字（つまり英字と英記号）を使い，スペースを含まないこと，
文字コード（エンコーディング）: UTF8

このページでは，データベース・一般ユーザのアカウントを作成するので，そのユーザ名とパスワードを決めておくこと．このページでは次のように書く．

ユーザ名: testuser
パスワード: hoge$#34hoge5
※ 説明上，単純に hoge$#34hoge5 と書いているが，必ず，これとは違う適切なパスワードを設定すること）

データベース・一般ユーザのアカウント作成やデータベースの作成と権限の設定には， PostgreSQL データベース管理者のユーザ名とパスワードが必要になるので，前もって調べておくこと．このページでは，Postgres データベース管理者のユーザ名を pgadmin と書く．

2. psql の基本操作

psql --version: psql バージョン確認:
psql: psql 起動
\copy: テーブルのコピー
\d, \d+: テーブル等の情報の表示
\db, \db+: テーブル空間の表示
\c: データベースへの接続、現在接続しているデータベースとユーザの確認
\l: データベースの情報の表示
\q: 終了

3. psql の起動と終了

psql コマンド

Windows のコマンドプロンプトの起動
psql -U postgresの実行
「postgres」はPostgres データベース管理者のユーザ名
```
psql -U postgres
```
Postgres データベース管理者のパスワード
プロンプトが出るので， PostgreSQL データベース管理者 (postgres) のパスワード を入力する．
画面にパスワードが表示されないのは正常動作．
「\c」により，使用されている PostgreSQL のロール名と，オープンされているデータベース名を確認．
```
\c
```
「\l」により，データベースの確認
postgres, template0, template1 の 3 つのデータベースが表示されることを確認．
```
\l
```
「\q」で psql を終了する

SQL Shell の利用

Windows のスタートメニューで， →「PostgreSQL 12」 →「SQL Shell (psql)」と操作する．

その後，次のように回答する．

Server [localhost]: Enter キー
Database [postgres]: 使用したデータベース名
Port [5432]: Enter キー
Username [postgres]: Enter キー
Client Encoding [SJIS]: Enter キー
ユーザ postgres のパスワード: インストール時に設定したパスワード

4. PostgreSQL で，一般ユーザのアカウント（ユーザ名とパスワード）作成と削除

ロール，既定（デフォルト）で使用されるデータベース名，使用中のロール名の確認

「psql -U postgres」を実行したとする
ロールの一覧，現在使用中のデータベース名とロール名の確認
```
\c
\du
```

アカウント作成

アカウント（ユーザ名とパスワード）を作成するには， create user コマンドを使用する．

ユーザ名 testuser のユーザを新しく作成したいときは， psql で次のように操作する．
```
create user testuser with password 'hoge$#34hoge5' createdb;
```
確認のため，いま作成したユーザで，psql を起動してみる．

アカウントの削除

アカウントを削除したいときは，psql で，「drop user testuser」のように操作する．

5. データベースの作成

データベースを作成するには，create databaseコマンドw使用する．

データベース名 mydbのデータベースを作成したいときには，次のように操作する．
文字コード（エンコーディング）は，UTF8に設定
実行後，エラーメッセージが出ないことを確認
```
create database mydb encoding 'UTF8';
```
- -E UTF8 : 文字コード（エンコーディング）
- mydb : データベース名

6. SQL の実行，SQL 実行結果のファイル出力

テーブル定義とレコード挿入

create table commodity (
    type integer primary key not null,
    name text not null,
    price integer);
insert into commodity values( 1, 'apple', 50 );
insert into commodity values( 2, 'orange', 20 );
insert into commodity values( 3, 'strawberry', 100 );
insert into commodity values( 4, 'watermelon', 150 );
insert into commodity values( 5, 'melon', 200 );
insert into commodity values( 6, 'banana', 100 );

SQL 問い合わせ

select * from commodity;

期待される結果．

      TYPE NAME       PRICE
       ---- ---------- -----
          1 apple         50
          2 orange        20
          3 strawberry   100
          4 watermelon   150
          5 melon        200
          6 banana       100

以下は，動作画面．

7. psql のオプション

データベースの一覧表示

データベースの一覧表示は，「psql -U pgadmin -l」で行う． Windows の場合は，コマンドプロンプトで実行．

SQL 実行結果のファイル出力

psql の起動において，「-L ＜ファイル名＞」を付ける．

ファイルに入った SQL の実行

psql の起動において，「-f ＜ファイル名＞」を付ける．

テーブルのインポート，エクスポート

テーブルのインポート，エクスポートには，PostgreSQL の copy コマンドを使う． Windows の場合には，2つ注意点がある．

インポートの例
```
copy WORK from E'd:\\KEN_ALL_UTF8.csv' with csv;
```
※ バックスラッシュを使いたいので，エスケープ文字列であることを意味する「E」を，文字列の前につける．
エクスポートの例
```
copy ZIP2 to E'C:\\Program Files\\PostgreSQL\\8.3\\data\\zip.csv' with CSV;
```
※ バックスラッシュを使いたいので，エスケープ文字列であることを意味する「E」を，文字列の前につける．
※ PostgreSQL の data ディレクトリ（PostgreSQL のインストールディレクトリの下））C:\\Program Files\\PostgreSQL\\8.3\\data\\ 以外を，copy コマンドの出力先として指定すると「ERROR: could not open file ... for writing: Permission denied」というエラーが出て動かないので注意．

本サイトは金子邦彦研究室のWebページである．

資料等の公開では，原則，「クリエイティブコモンズ BY NC SA」として公開するようにしている． PDFファイル，パワーポイントファイルなどには，「クリエイティブコモンズ BY NC SA」を明記するとともに，ロゴを記載するようにしている（作業が間に合っていない分もあるのでご容赦ください）．

公開している資料をご利用になる場合の，再配布の条件，剽窃の防止などについて，別ページ »で説明再配布や資料改変の際には，そのページをご確認ください．

サイトマップは，サイトマップのページをご覧下さい．本サイト内の検索は，サイト内検索のページをご利用下さい．

問い合わせ先：金子邦彦（かねこくにひこ） [image]