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 | スキーマ |
\dt | search_path にあるスキーマのテーブル |
\dt sales.* | スキーマ sales のテーブル |
\dt *.* | システムを含むすべてのスキーマのテーブル |
\dt+ | サイズと説明付きのテーブル |
\dv、\di、\ds | ビュー、インデックス、シーケンス |
\d orders | orders の列、インデックス、制約 |
\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 データを含むテーブルのサイズがわかります。