OSS Fan ~OSSでLinuxサーバ構築~

作成日: 2013/08/15
更新日: 2013/09/04

Linuxサーバ管理

PostgreSQLのメタコマンド実行例

トップページLinuxサーバ管理 > PostgreSQLのメタコマンド実行例
このエントリーをはてなブックマークに追加

概要

解説

 psqlでデータベースに接続した後で実行可能なPostgreSQL特有のメタコマンドについて紹介します。 代表的なメタコマンドについて実行例を表示していますが、PostgreSQLをインストールした直後に 実行したメタコマンドなので、ユーザオブジェクトはまだありません。 ほとんどがシステムオブジェクトの表示のみですが、ご了承ください。

サーバ構成

OSバージョン

Red Hat Enterprise Linux 5.9 x86_64

パッケージ一覧

postgresql90-9.0.13-1PGDG.rhel5.x86_64.rpm
postgresql90-libs-9.0.13-1PGDG.rhel5.x86_64.rpm
postgresql90-server-9.0.13-1PGDG.rhel5.x86_64.rpm

手順

psqlの起動・停止

psqlの起動(データベースへの接続)

 SQLやメタコマンドを実行するためのpsqlを起動します。 psqlはOracleで言うSQl*Plusです。 PostgreSQLをインストールしたユーザで実行します。

# su - postgres
-bash-3.2$ psql
パスワード:
psql (9.0.13)
"help" でヘルプを表示します.

postgres=#

psqlの終了(データベースからの切断)

 psqlの終了はコマンドライン上で終了のためのメタコマンドを実行します。 exit と打っても終了しません。

postgres=# \q
-bash-3.2$

メタコマンド

 メタコマンドに S を付けた場合は、システムオブジェクトも表示します。

 メタコマンドに + を付けた場合は、追加情報を表示します。

 S と + を両方付けることもできます。

データベースの一覧を表示

 初期状態で表示されるのはテンプレート2つと空のDBです。 postgresという名のDBはPostgreSQLの管理情報が書き込まれているような雰囲気がありますが、 ただの空のDBです。Oracleでいうusers表領域です。

postgres-# \l
                                        データベース一覧
   名前    |  所有者  | エンコーディング | 照合順序 | Ctype(変換演算子) |      アクセス権
-----------+----------+------------------+----------+-------------------+-----------------------
 postgres  | postgres | UTF8             | C        | C                 |
 template0 | postgres | UTF8             | C        | C                 | =c/postgres          +
           |          |                  |          |                   | postgres=CTc/postgres
 template1 | postgres | UTF8             | C        | C                 | =c/postgres          +
           |          |                  |          |                   | postgres=CTc/postgres
(3 行)

postgres-# \l+
                                                                    データベース一覧
   名前    |  所有者  | エンコーディング | 照合順序 | Ctype(変換演算子) |      アクセス権       | サ
イズ  | テーブルスペース |           説明
-----------+----------+------------------+----------+-------------------+-----------------------+---
------+------------------+---------------------------
 postgres  | postgres | UTF8             | C        | C                 |                       | 53
69 kB | pg_default       |
 template0 | postgres | UTF8             | C        | C                 | =c/postgres          +| 52
73 kB | pg_default       |
           |          |                  |          |                   | postgres=CTc/postgres |
      |                  |
 template1 | postgres | UTF8             | C        | C                 | =c/postgres          +| 52
73 kB | pg_default       | default template database
           |          |                  |          |                   | postgres=CTc/postgres |
      |                  |
(3 行)

テーブル、ビュー、シーケンスの一覧を表示

 初期状態ではユーザオブジェクトは存在していません。 システムオブジェクトのみ表示されます。

postgres-# \d
postgres-# \d+
postgres-# \dS
                     リレーションの一覧
  スキーマ  |           名前           |    型    |  所有者
------------+--------------------------+----------+----------
 pg_catalog | pg_aggregate             | テーブル | postgres
 pg_catalog | pg_am                    | テーブル | postgres
(中略)
 pg_catalog | pg_user_mappings         | ビュー   | postgres
 pg_catalog | pg_views                 | ビュー   | postgres
(80 行)

postgres-# \dS+
                               リレーションの一覧
  スキーマ  |           名前           |    型    |  所有者  |   サイズ   | 説明
------------+--------------------------+----------+----------+------------+------
 pg_catalog | pg_aggregate             | テーブル | postgres | 8192 bytes |
 pg_catalog | pg_am                    | テーブル | postgres | 8192 bytes |
(中略)
 pg_catalog | pg_user_mappings         | ビュー   | postgres | 0 bytes    |
 pg_catalog | pg_views                 | ビュー   | postgres | 0 bytes    |
(80 行)

データベースユーザの一覧を表示

 初期状態ではスーパーユーザのみ存在しています。

postgres-# \du
                                ロール一覧
 ロール名 |                        属性                        | メンバー
----------+----------------------------------------------------+----------
 postgres | スーパーユーザ, ロールを作成できる, DBを作成できる | {}

postgres-# \du+
                                   ロール一覧
 ロール名 |                        属性                        | メンバー | 説明
----------+----------------------------------------------------+----------+------
 postgres | スーパーユーザ, ロールを作成できる, DBを作成できる | {}       |

postgres-# \duS
                                ロール一覧
 ロール名 |                        属性                        | メンバー
----------+----------------------------------------------------+----------
 postgres | スーパーユーザ, ロールを作成できる, DBを作成できる | {}

postgres-# \duS+
                                   ロール一覧
 ロール名 |                        属性                        | メンバー | 説明
----------+----------------------------------------------------+----------+------
 postgres | スーパーユーザ, ロールを作成できる, DBを作成できる | {}       |

スキーマの一覧を表示

 初期状態では情報スキーマやシステムカタログが存在しています。

postgres-# \dn
         スキーマ一覧
        名前        |  所有者
--------------------+----------
 information_schema | postgres
 pg_catalog         | postgres
 pg_toast           | postgres
 pg_toast_temp_1    | postgres
 public             | postgres
(5 行)

postgres-# \dn+
                                      スキーマ一覧
        名前        |  所有者  |      アクセス権      |               説明
--------------------+----------+----------------------+----------------------------------
 information_schema | postgres | postgres=UC/postgres+|
                    |          | =U/postgres          |
 pg_catalog         | postgres | postgres=UC/postgres+| system catalog schema
                    |          | =U/postgres          |
 pg_toast           | postgres |                      | reserved schema for TOAST tables
 pg_toast_temp_1    | postgres |                      |
 public             | postgres | postgres=UC/postgres+| standard public schema
                    |          | =UC/postgres         |
(5 行)

postgres-# \dnS
         スキーマ一覧
        名前        |  所有者
--------------------+----------
 information_schema | postgres
 pg_catalog         | postgres
 pg_toast           | postgres
 pg_toast_temp_1    | postgres
 public             | postgres
(5 行)

postgres-# \dnS+
                                      スキーマ一覧
        名前        |  所有者  |      アクセス権      |               説明
--------------------+----------+----------------------+----------------------------------
 information_schema | postgres | postgres=UC/postgres+|
                    |          | =U/postgres          |
 pg_catalog         | postgres | postgres=UC/postgres+| system catalog schema
                    |          | =U/postgres          |
 pg_toast           | postgres |                      | reserved schema for TOAST tables
 pg_toast_temp_1    | postgres |                      |
 public             | postgres | postgres=UC/postgres+| standard public schema
                    |          | =UC/postgres         |
(5 行)

テーブルの一覧を表示

 初期状態ではユーザテーブルは存在していません。

postgres-# \dt
postgres-# \dt+
postgres-# \dtS
                     リレーションの一覧
  スキーマ  |          名前           |    型    |  所有者
------------+-------------------------+----------+----------
 pg_catalog | pg_aggregate            | テーブル | postgres
 pg_catalog | pg_am                   | テーブル | postgres
(中略)
 pg_catalog | pg_type                 | テーブル | postgres
 pg_catalog | pg_user_mapping         | テーブル | postgres
(44 行)

postgres-# \dtS+
                               リレーションの一覧
  スキーマ  |          名前           |    型    |  所有者  |   サイズ   | 説明
------------+-------------------------+----------+----------+------------+------
 pg_catalog | pg_aggregate            | テーブル | postgres | 8192 bytes |
 pg_catalog | pg_am                   | テーブル | postgres | 8192 bytes |
(中略)
 pg_catalog | pg_type                 | テーブル | postgres | 56 kB      |
 pg_catalog | pg_user_mapping         | テーブル | postgres | 0 bytes    |
(44 行)

インデックスの一覧を表示

 初期状態ではユーザインデックスは存在していません。

postgres-# \di
postgres-# \di+
postgres-# \diS
                                            リレーションの一覧
  スキーマ  |                  名前                   |      型      |  所有者  |        テーブル
------------+-----------------------------------------+--------------+----------+-------------------------
 pg_catalog | pg_aggregate_fnoid_index                | インデックス | postgres | pg_aggregate
 pg_catalog | pg_am_name_index                        | インデックス | postgres | pg_am
(中略)
 pg_catalog | pg_user_mapping_oid_index               | インデックス | postgres | pg_user_mapping
 pg_catalog | pg_user_mapping_user_server_index       | インデックス | postgres | pg_user_mapping
(84 行)

postgres-# \diS+
                                                      リレーションの一覧
  スキーマ  |                  名前                   |      型      |  所有者  |        テーブル         |   サイズ   | 説明
------------+-----------------------------------------+--------------+----------+-------------------------+------------+------
 pg_catalog | pg_aggregate_fnoid_index                | インデックス | postgres | pg_aggregate            | 16 kB      |
 pg_catalog | pg_am_name_index                        | インデックス | postgres | pg_am                   | 16 kB      |
(中略)
 pg_catalog | pg_user_mapping_oid_index               | インデックス | postgres | pg_user_mapping         | 8192 bytes |
 pg_catalog | pg_user_mapping_user_server_index       | インデックス | postgres | pg_user_mapping         | 8192 bytes |
(84 行)

ビューの一覧を表示

 初期状態ではユーザビューは存在していません。

postgres-# \dv
postgres-# \dv+
postgres-# \dvS
                    リレーションの一覧
  スキーマ  |           名前           |   型   |  所有者
------------+--------------------------+--------+----------
 pg_catalog | pg_cursors               | ビュー | postgres
 pg_catalog | pg_group                 | ビュー | postgres
(中略)
 pg_catalog | pg_user_mappings         | ビュー | postgres
 pg_catalog | pg_views                 | ビュー | postgres
(36 行)

postgres=# \dvS+
                             リレーションの一覧
  スキーマ  |           名前           |   型   |  所有者  | サイズ  | 説明
------------+--------------------------+--------+----------+---------+------
 pg_catalog | pg_cursors               | ビュー | postgres | 0 bytes |
 pg_catalog | pg_group                 | ビュー | postgres | 0 bytes |
(中略)
 pg_catalog | pg_user_mappings         | ビュー | postgres | 0 bytes |
 pg_catalog | pg_views                 | ビュー | postgres | 0 bytes |
(36 行)

シーケンスの一覧を表示

 初期状態ではシーケンスは存在していません。

postgres-# \ds
postgres-# \ds+
postgres-# \dsS
postgres-# \dsS+

システムカタログの一覧を表示

 システムカタログには大事な管理情報が格納されています。 間違って書き換えないように注意してください。

postgres-# \dS
postgres=# \dS
                     リレーションの一覧
  スキーマ  |           名前           |    型    |  所有者
------------+--------------------------+----------+----------
 pg_catalog | pg_aggregate             | テーブル | postgres
 pg_catalog | pg_am                    | テーブル | postgres
(中略)
 pg_catalog | pg_user_mappings         | ビュー   | postgres
 pg_catalog | pg_views                 | ビュー   | postgres
(80 行)

postgres-# \dS+
                               リレーションの一覧
  スキーマ  |           名前           |    型    |  所有者  |   サイズ   | 説明
------------+--------------------------+----------+----------+------------+------
 pg_catalog | pg_aggregate             | テーブル | postgres | 8192 bytes |
 pg_catalog | pg_am                    | テーブル | postgres | 8192 bytes |
(中略)
 pg_catalog | pg_user_mappings         | ビュー   | postgres | 0 bytes    |
 pg_catalog | pg_views                 | ビュー   | postgres | 0 bytes    |
(80 行)

postgres-# \dSS
                     リレーションの一覧
  スキーマ  |           名前           |    型    |  所有者
------------+--------------------------+----------+----------
 pg_catalog | pg_aggregate             | テーブル | postgres
 pg_catalog | pg_am                    | テーブル | postgres
(中略)
 pg_catalog | pg_user_mappings         | ビュー   | postgres
 pg_catalog | pg_views                 | ビュー   | postgres
(80 行)

postgres-# \dSS+
                               リレーションの一覧
  スキーマ  |           名前           |    型    |  所有者  |   サイズ   | 説明
------------+--------------------------+----------+----------+------------+------
 pg_catalog | pg_aggregate             | テーブル | postgres | 8192 bytes |
 pg_catalog | pg_am                    | テーブル | postgres | 8192 bytes |
(中略)
 pg_catalog | pg_user_mappings         | ビュー   | postgres | 0 bytes    |
 pg_catalog | pg_views                 | ビュー   | postgres | 0 bytes    |
(80 行)

関数の一覧を表示

 初期状態ではユーザ関数は存在していません。 ただシステム関数は大量に存在しています。

postgres-# \df
                        関数一覧
 スキーマ | 名前 | 結果のデータ型 | 引数のデータ型 | 型
----------+------+----------------+----------------+----
(0 行)

postgres-# \df+
                                               関数一覧
 スキーマ | 名前 | 結果のデータ型 | 引数のデータ型 | 型 | 揮発性 | 所有者 | 言語 | ソースコード | 説明
----------+------+----------------+----------------+----+--------+--------+------+--------------+------
(0 行)

postgres-# \dfS

                                                                                関数一覧
  スキーマ  |                     名前                     |          結果のデータ型           |
                                                                                                                 引数のデータ型

             |          型
------------+----------------------------------------------+-----------------------------------+------------------------------------
------------------------------------------------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------------------------------------------------
-------------+----------------------
 pg_catalog | RI_FKey_cascade_del                          | trigger                           |


             | trigger(トリガ)
 pg_catalog | RI_FKey_cascade_upd                          | trigger                           |


             | trigger(トリガ)
(後略)
postgres-# \dfS+


                                                                                                               関数一覧
  スキーマ  |                     名前                     |          結果のデータ型           |
                                                                                                                 引数のデータ型

             |          型          | 揮発性 |  所有者  |   言語   |
                    ソースコード                                                                                    |
                                       説明
------------+----------------------------------------------+-----------------------------------+------------------------------------
------------------------------------------------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------------------------------------------------
-------------+----------------------+--------+----------+----------+----------------------------------------------------------------
--------------------------------------------------------------------------------------------------------------------+---------------
--------------------------------------------------------------------------------------------------
 pg_catalog | RI_FKey_cascade_del                          | trigger                           |


             | trigger(トリガ)    | 揮発性 | postgres | internal | RI_FKey_cascade_del
                                                                                                                    | referential in
tegrity ON DELETE CASCADE
 pg_catalog | RI_FKey_cascade_upd                          | trigger                           |


             | trigger(トリガ)    | 揮発性 | postgres | internal | RI_FKey_cascade_upd
                                                                                                                    | referential in
tegrity ON UPDATE CASCADE
(後略)

テーブル、ビュー、シーケンスの一覧と、それらに設定されているテーブル単位の権限を表示

 オブジェクトに対するアクセス権を確認できます。 初期状態ではオブジェクトが存在していません。

postgres-# \dp
                         アクセス権
 スキーマ | 名前 | 型 | アクセス権 | アクセス権限を剥奪する
----------+------+----+------------+------------------------
(0 行)

postgres-# \dp+
                         アクセス権
 スキーマ | 名前 | 型 | アクセス権 | アクセス権限を剥奪する
----------+------+----+------------+------------------------
(0 行)

postgres-# \dpS
                         アクセス権
 スキーマ | 名前 | 型 | アクセス権 | アクセス権限を剥奪する
----------+------+----+------------+------------------------
(0 行)

postgres-# \dpS+
                         アクセス権
 スキーマ | 名前 | 型 | アクセス権 | アクセス権限を剥奪する
----------+------+----+------------+------------------------
(0 行)

データベースユーザのパスワードを変更

 データベースユーザのパスワードを変更することができます。 ユーザ名を指定しない場合はログインしているデータベースユーザのパスワードを変更します。 引数でデータベースユーザを指定した場合は、そのユーザのパスワードを変更します。

postgres-# \password
新しいパスワード:     ←パスワードを入力
もう一度入力してください:←上と同じパスワードを入力
postgres-# \password postgres
新しいパスワード:     ←パスワードを入力
もう一度入力してください:←上と同じパスワードを入力

メタコマンドの一覧を表示

 他にもpsqlのメタコマンドはたくさん準備されています。 メタコマンドの一覧を表示するメタコマンドも準備されていますので、 分からなくなったときに使えます。

postgres-# \?
一般
  \copyright             PostgreSQL の使い方と配布条件を表示
  \g [ファイル] または ';'  クエリー実行(し、結果をファイルまたは |パイプ へ書き出す)
  \h [名前]              SQL コマンドの文法ヘルプ、* で全コマンド
  \q                     psql を終了する

クエリーバッファ
  \e [ファイル]          現在のクエリーバッファ(やファイル)を外部エディタで編集する
  \e [関数名]            関数定義を外部エディタで編集
  \p                     クエリーバッファの内容を表示する
  \r                     クエリーバッファをリセット(クリア)する
  \s [ファイル]          ヒストリを表示またはファイルに保存する
  \w ファイル            クエリーバッファの内容をファイルに書き出す

入出力
  \copy ...              クライアントホストに対し、データストリーム
                          を使って SQL コピーを行う
  \echo [文字列]         文字列を標準出力に書き出す
  \i ファイル            ファイルからコマンドを読み込んで実行する
  \o [ファイル]          すべてのクエリーの結果をファイルまたは |パイプ へ送る
  \qecho [文字列]        文字列をクエリー出力ストリームに出力(\o を参照)

情報
  (修飾子: S = システムオブジェクトを表示 + = 付加情報)
  \d[S+]                 テーブル、ビュー、シーケンスの一覧を表示する
  \d[S+]  名前           テーブル、ビュー、シーケンス、インデックスの説明を表示する
  \da[S]  [パターン]     集約関数の一覧を表示する
  \db[+]  [パターン]     テーブルスペースの一覧を表示する
  \dc[S]  [パターン]     変換ルールの一覧を表示する
  \dC     [パターン]     キャストの一覧を表示する
  \dd[S]  [パターン]     オブジェクトのコメントを表示する
  \ddp    [パターン]     デフォルト権限の一覧を表示する
  \dD[S]  [パターン]     ドメインの一覧を表示する
  \des[+] [パターン]     外部サーバーの一覧を表示する
  \deu[+] [パターン]     ユーザマッピングの一覧を表示する
  \dew[+] [パターン]     外部データラッパーの一覧を表示する
  \df[antw][S+] [パターン]      関数(集約/通常/トリガー/ウィンドウのみ)の一覧を表示する
  \dF[+]  [パターン]     テキスト検索設定の一覧を表示する
  \dFd[+] [パターン]     テキスト検索用辞書の一覧を表示する
  \dFp[+] [パターン]     テキスト検索用パーサーの一覧を表示する
  \dFt[+] [パターン]     テキスト検索用テンプレートの一覧を表示する
  \dg[+]  [パターン]     ロール(グループ)の一覧を表示する
  \di[S+] [パターン]     インデックスの一覧を表示する
  \dl                    ラージオブジェクトの一覧を表示する。\lo_list と同じ。
  \dn[+]  [パターン]     スキーマの一覧を表示する
  \do[S]  [名前]         演算子の一覧を表示する
  \dp     [パターン]     テーブル、ビュー、シーケンスのアクセス権一覧を表示する
  \drds [パターン1 [パターン2]] データベース毎のロール(ユーザー)設定の一覧を表示する
  \ds[S+] [パターン]     シーケンスの一覧を表示する
  \dt[S+] [パターン]     テーブルの一覧を表示する
  \dT[S+] [パターン]     データ型の一覧を表示する
  \du[+]  [パターン]     ロール(ユーザー)の一覧を表示する
  \dv[S+] [パターン]     ビューの一覧を表示する
  \l[+]                  データベースの一覧を表示する
  \z      [パターン]     \dp と同じ

書式設定
  \a                     出力モードの 'unaligned' / 'aligned' を切り替える
  \C タイトル            テーブルのタイトルをセットする。指定がなければ解除
  \f [文字列]            クエリー出力の際に桁揃えを行わない(unaligned)場合に
                          使用するフィールド区切り文字を表示または設定する
  \H                     HTML の出力モードを切り替える(現在: オフ)
  \pset 名前 [値]        テーブル出力のオプションを設定する
                         (名前 := {format|border|expanded|fieldsep|footer|null|
                         numericlocale|recordsep|tuples_only|title|tableattr|pager})
  \t [on|off]            行のみを表示するか? (現在: オフ)
  \T [文字列]            HTML の <table> タグの属性をセット。引数がなければ解除
  \x [on|off]            拡張出力の切り替え(現在: オフ)

接続
  \c[onnect] [DB名|- ユーザ名|- ホスト名|- ポート番号|-]
                         新しいデータベースに接続する (現在: "postgres")
  \encoding [エンコーディング]
                         クライアントのエンコーディングを表示またはセット
  \password [ユーザ名]   ユーザのパスワードを安全に変更する

オペレーティングシステム
  \cd [DIR]              カレントディレクトリを変更
  \timing [on|off]       コマンドのタイミングを切り替える(現在: オフ)
  \! [コマンド]          シェルでコマンドを実行、もしくは会話型シェルを起動

変数
  \prompt [テキスト] 変数名    ユーザに内部変数をセットするよう促す
  \set [変数名 [値]]
                         内部変数の値をセット。引数がない場合は一覧表示。
  \unset 変数名          内部変数を削除する

ラージオブジェクト
  \lo_export LOBOID ファイル名
  \lo_import ファイル名 [コメント]
  \lo_list
  \lo_unlink LOBOID     ラージオブジェクトの操作

プロフィール

らのっち

損害保険会社のIT企画部に勤務するSEです。OSSを勉強中です。

<所属>
日本PostgreSQLユーザ会とくしまOSS普及協議会

■■■ 当サイトは Internet Explorer 11 と Mozilla Firefox 43 で動作確認済みです。 ■■■