Menu

PostgreSQL のテーブル一覧とデータベース一覧を表示する方法

psql では \l でデータベースの一覧、\c で接続先の切り替え、\dt でテーブルの一覧を表示します。SQL では pg_database、information_schema.tables、information_schema.columns を検索します。

このページのコードはエディタで実行できます。編集してすぐに結果を確認できます。

psql では、\l でデータベースの一覧、\c dbname でそのデータベースへの接続、\dt で現在のデータベースにあるテーブルの一覧を表示します。SQL やほかのクライアントからは、システムカタログを検索します。データベースは pg_database、テーブルは information_schema.tables です。

2 つのテーブルが BASE TABLE、ビューが VIEW として返り、どれも public スキーマにあります。WHERE の条件はシステムカタログを除外しています。除外しないと数百行が加わります。ビューを外すには AND table_type = 'BASE TABLE' を追加してください。

データベースとテーブルを見る psql のコマンド

これらは psql のメタコマンドです。psql がそれぞれをカタログへのクエリに変換するので、ほかのクライアントやアプリケーションのコードでは使えません。

コマンド表示する内容
\lデータベース (\l+ でサイズも表示)
\c shopデータベース shop に接続
\conninfo接続中のデータベース、ユーザー、ホスト
\dnスキーマ
\dtsearch_path にあるスキーマのテーブル
\dt sales.*スキーマ sales のテーブル
\dt *.*システムを含むすべてのスキーマのテーブル
\dt+サイズと説明付きのテーブル
\dv、\di、\dsビュー、インデックス、シーケンス
\d ordersorders の列、インデックス、制約
\d+ orders上記に加えてストレージとコメント
\duロール

シェルからは、psql -l でデータベースの一覧を表示して終了し、-c で 1 つのコマンドを実行します。

psql -l
psql -d shop -c '\dt'

psql を -E 付きで起動すると、各メタコマンドの裏で実行される SQL が表示されます。カタログテーブルを覚えるのに手っ取り早い方法です。

SQL でデータベースの一覧を表示する

サーバー上のデータベースは、それぞれ pg_database の 1 行です。template0 と template1 は CREATE DATABASE がコピーするテンプレートなので、除外します。

このページでは、実行のたびに lesson_ で始まる名前の新しいデータベースが作られます。結果にはそのデータベースと、どのサーバーにも作られるデフォルトのデータベース postgres が表示されます。接続中のデータベースは SELECT current_database() で取得できます。

テーブルの列を確認する

psql では \d orders でテーブルの定義を表示します。SQL では、information_schema.columns に列ごとに 1 行が入っています。

主キーは常に NOT NULL なので、id の is_nullable は NO です。column_default は空になります。identity 列の値はデフォルト値ではなくシーケンスから取られるためです。

pg_catalog を直接検索する

information_schema は SQL 標準のビューで、何らかの権限を持つオブジェクトしか表示しません。pg_catalog にある PostgreSQL 固有のカタログには、インデックスの定義など、より多くの情報があります。

インデックスが 3 つ表示されます。UNIQUE から作られた orders_email_key、主キーから作られた orders_pkey、そして自分で作った部分インデックスです。それぞれに、インデックスを作り直すための CREATE INDEX 文が付いています。pg_tables はテーブルだけを表示します。ビューとマテリアライズドビューは pg_views と pg_matviews で確認します。

すべてのテーブルの行数を数える

カタログには正確な行数は保存されていません。pg_class.reltuples にはプランナーの推定値が入っていて、VACUUM と ANALYZE が更新します。大きなテーブルを見つけるには十分な精度で、-1 はそのテーブルが一度も分析されていないことを表します。

SELECT relname, reltuples::bigint AS estimated_rows
FROM pg_class
WHERE relkind = 'r' AND relnamespace = 'public'::regnamespace
ORDER BY reltuples DESC;

正確な数が必要なら SELECT count(*) FROM orders を実行します。これはテーブル全体を読みます。カタログテーブルは PostgreSQL マニュアルの System Catalogs に説明があります。

よくある質問

PostgreSQL に SHOW TABLES や SHOW DATABASES はありますか?

ありません。これらは MySQL のコマンドです。PostgreSQL の SHOW はサーバーの設定値を読むコマンドなので、SHOW TABLES は "unrecognized configuration parameter" というエラーになります。psql では \dt と \l を使うか、information_schema.tables と pg_database を検索してください。

\dt で "Did not find any relations" と表示されるのはなぜですか?

テーブルがあるデータベースとは別のデータベースに接続しているか、テーブルが search_path に含まれないスキーマにあるかのどちらかです。\conninfo で接続先を確認してから、\dt *.* か \dt schema_name.* を試してください。

PostgreSQL でデータベースを切り替えるには?

1 つの接続は 1 つのデータベースに属し、SQL に USE 文はありません。psql では \c other_db を実行すると新しい接続が開きます。シェルからは psql -d other_db で起動します。

PostgreSQL でテーブルのサイズを確認するには?

psql では \dt+ でサイズの列が追加されます。SQL では pg_size_pretty(pg_total_relation_size('orders')) で、インデックスと TOAST データを含むテーブルのサイズがわかります。

Coddyのプログラミング言語のイラスト

Coddyでコードを学ぼう

始める