PostgreSQLでデータベースサイズを確認する方法：クイックガイド

2025年9月23日著者：Matthew Rathbone

データベースの世界に足を踏み入れてから、PostgreSQLデータベースのサイズを調べる必要に迫られることがよくありました。キャパシティプランニングのため、経時的な増加を監視するため、あるいは単なる好奇心からでも、PostgreSQL でデータベースサイズを確認する方法を知っておくと非常に便利です。

よく聞かれる質問に「PostgreSQLデータベースのサイズはどうやって確認するのか？」というものがあります。実は、思っているほど複雑ではありません。SQLの基本知識があれば誰でも実行できる、シンプルなSQLクエリを使うだけです。これらのクエリはPostgreSQLのシステムカタログから情報を取得し、データに関する正確な測定値を返してくれます。

このガイドを読み終える頃には、ご自身のPostgreSQLデータベースのサイズを測定する方法がはっきり理解できているはずです。これらのクエリを実行しながら、データベースサイズを視覚的に監視したい場合は、Beekeeper StudioのPostgreSQLクライアントが直感的なデータベース管理インターフェースを提供しています。それでは早速、便利なコマンドを一緒に見ていきましょう！

PostgreSQLのデータベースサイズを理解する

PostgreSQLを扱う際、私が最初に確認するようになったことの1つがデータベースのサイズです。これは単にストレージ容量を管理するためだけではありません。データベースサイズを把握することで、パフォーマンスに関する知見が得られ、将来の増加に備えた計画も立てやすくなります。

PostgreSQLでは、総サイズを構成する主な要素が2つあります。ベースデータとインデックスです。ベースデータにはすべてのテーブルとその行が含まれ、インデックスはデータ取得を高速化するためにテーブルに関連付けられた特別な検索構造です。

PostgreSQLでデータベースの総サイズを確認する基本的な例を以下に示します：

SELECT pg_size_pretty(pg_database_size('your_database_name'));

このコマンドは「your_database_name」のサイズを人が読みやすい形式で返します。「your_database_name」は実際のデータベース名に置き換えてください。

では、もっと詳細な情報が欲しい場合はどうでしょうか？各テーブルやインデックスがどれだけの容量を使っているか知りたい場合は、次のスクリプトが役立ちます：

SELECT
   relname AS "Table",
   pg_size_pretty(pg_total_relation_size(relid)) As "Size"
FROM
   pg_catalog.pg_statio_user_tables
ORDER BY
   pg_total_relation_size(relid) DESC;

このSQL文を実行すると、ベースデータとインデックスの両方を含むサイズ順に、すべてのユーザーテーブルの一覧が表示されます。

ただし、結果の解釈には注意が必要です！初心者は、テーブルのサイズを減らせばすぐにディスク容量が解放されると考えがちです。実際には、PostgreSQLはMVCC（Multi-Version Concurrency Control、多版型同時実行制御）という仕組みを使用しているため、トランザクション処理によってディスク使用量は時間とともに変動します。つまり、テーブルからデータを削除しても、ディスク容量がすぐに解放されるとは限りません。

つまり、PostgreSQLのデータベースサイズを把握することは、ストレージ管理だけが目的ではありません。データを理解し、増加に備え、最適なパフォーマンスを確保することでもあります。データベース、テーブル、インデックスのサイズを定期的に確認しましょう。この習慣は、健全で効率的なデータベースを維持するうえで大いに役立ちます！

PostgreSQLでデータベースサイズを確認するための前提条件

PostgreSQLでデータベースサイズを確認する方法に入る前に、いくつかの必須事項を確認しておきましょう。前提条件を整えておくことで、作業をよりスムーズかつ効率的に進められます。

まず、稼働中のPostgreSQLデータベースにアクセスできる必要があります。当たり前に思えるかもしれませんが、必要なことです。ローカル環境でもリモートでホストされていても、起動していることを確認してください。

次に、データベースでSQL文を実行するための権限が必要です。多くの場合、「スーパーユーザー」または「データベース所有者」の権限が求められます。権限がないと、データベースサイズの情報を取得するためのコマンドを実行できません。

-- You can use this command to verify your current user role
SELECT current_user;

続いて、SQL（Structured Query Language）の基本的な構文とコマンドを理解しておく必要があります。ここでは、 psql （PostgreSQLの対話型ターミナル）、PGAdmin4、またはお好みのツールなどのインターフェースを使って、PostgreSQLサーバー上で直接SQLクエリを実行します。

最後に、データ単位をよく理解しておくと、結果を解釈する際に役立ちます。PostgreSQLは通常、データベースサイズをバイト単位で返しますが、すぐに人間には読みにくい大きな数値になってしまいます！バイトがキロバイト（KB）、メガバイト（MB）、ギガバイト（GB）などにどう換算されるかを理解しておけば、これらの数値の意味がわかりやすくなります。

よく使う換算は以下のとおりです：

1キロバイト = 1024バイト
1メガバイト = 1024キロバイト
1ギガバイト = 1024メガバイト

まとめると、PostgreSQLでデータベースサイズを確認する前に、適切なアクセス権限、SQLの構文とコマンドへの理解、稼働中のPostgreSQLインスタンスへの接続、そしてデータ単位の理解が必要です。これで、PostgreSQLのデータベースサイズを確認する具体的なコマンドに進む準備が整いました。それでは、PostgreSQLデータベースサイズの確認方法を詳しく見ていきましょう。この作業にはSQLクエリを使います。各ステップを順を追って説明します。

まず、データベースに直接アクセスできるPostgreSQLのコマンドラインツール（psql）を開きます。そこから必要な認証情報でログインしてください。これでクエリを実行する準備が整いました！

すべてのデータベースが使用しているディスク容量の概要を把握するには、次のシンプルなクエリを使います：

SELECT pg_size_pretty(pg_database_size(pg_database.datname)) AS size_in_mb,
pg_database.datname as database_name
FROM pg_database ORDER BY pg_database_size(pg_database.datname) DESC;

このコマンドを実行すれば完了です！すべてのデータベースの一覧が、読みやすい形式のサイズとともに表示されます。

では、特定の1つのデータベースの情報だけが欲しい場合はどうでしょうか？ご心配なく、その方法もあります！次のクエリの「your_database」をご自身のデータベース名に置き換えてください：

SELECT pg_size_pretty(pg_database_size('your_database'));

これで、そのデータベースのサイズが得られます。

なお、これらのコマンドはどちらもインデックスを含まないデータサイズのみを返す点に注意してください。インデックスも含めたい場合は、 pg_database_size の代わりに pg_total_relation_size を使用します。この2つを混同しないことが重要です！

これらのクエリを実行する際によくある間違いは、タイプミスや構文の誤りです。SQLは1文字やスペース1つの位置がずれているだけでも容赦しません！Enterキーを押す前に必ず見直しましょう。また、大文字と小文字が区別される点にも注意してください。「Your_Database」と「your_database」はまったく別のものとして扱われます。

PostgreSQLの管理作業の効率化に役立てば幸いです！データベースを扱う際は、正確さと細部への注意がすべてであることを忘れないでください。

PostgreSQLのデータベースサイズ確認時によくある問題と解決策

PostgreSQLの世界を深く探っていくと、途中でいくつかの壁にぶつかるのは珍しいことではありません。例えば、PostgreSQLでデータベースサイズを確認しようとすると、よくある問題に遭遇することがあります。でも心配はいりません！シンプルな解決策とともに、これらの課題を乗り越える方法をご紹介します。

典型的な問題の1つは、権限不足です。データベースのサイズを確認できるのは、スーパーユーザーまたは適切な権限を持つユーザーだけです。「permission denied」というエラーメッセージが表示される場合は、おそらくこれが原因です。ただし、解決は簡単です！方法は次のとおりです：

GRANT pg_read_all_stats TO username;

username を実際のユーザー名に置き換えるだけで完了です！

もう1つよくつまずくのが、SQLクエリではテーブル名やスキーマ名の大文字と小文字が区別されることを忘れてしまう点です。小文字で入力しているのに実際の名前に大文字が含まれている場合（またはその逆）、クエリは正確な結果を返しません。解決策は？名前を常にダブルクォートで囲むことです：

SELECT pg_size_pretty(pg_database_size("YourDatabase"));

3つ目のよくある間違いは、マテリアライズドビューのサイズを確認する前にリフレッシュし忘れることです。マテリアライズドビューは元のテーブルのデータが変更されても自動的に更新されないため、古い情報が表示される可能性があります。

SQLでマテリアライズドビューをリフレッシュする方法は次のとおりです：

REFRESH MATERIALIZED VIEW your_view_name;

最後に、データベースサイズの確認に使用する関数がお使いのPostgreSQLのバージョンでサポートされているか確認してください。 pg_size_pretty、 pg_total_relation_size などは、それぞれ異なるバージョンのPostgreSQLで追加されたものなので、必ず確認しましょう！

以上です！これらは、PostgreSQLでデータベースサイズを調べる際によくある問題とその解決策です。これらのヒントを押さえておけば、PostgreSQLのデータベース管理をマスターする道のりは順調です。

まとめ：データベースサイズの知識で効率を最大化する

PostgreSQLデータベースのサイズを確認する方法を理解することは、単なる便利な小技ではなく、さまざまな面で効率を最大化するのに役立つ必須の知識です。まず、データベースの正確なサイズを知ることで、現在使用しているストレージ容量を明確に把握できます。これは、スケーラビリティや増加に備えた計画を立てるうえで非常に重要です。

例えば、次のシンプルなコマンドを見てみましょう：

SELECT pg_size_pretty(pg_database_size('your_database_name'));

「your_database_name」をデータベース名に置き換えれば完了です！サイズがわかります。コーヒーを1杯淹れるくらい簡単です！

ただし、そのシンプルさに油断してはいけません。「your_database_name」を置き換え忘れたり、自分のデータベース名を打ち間違えたりといったよくあるミスをする開発者を数多く見てきました。こうしたミスは些細に思えるかもしれませんが、誤った結果、さらに悪い場合はまったく結果が返らないことにつながります！

もう1つ重要な点は、この情報を手元に置いておくことでデータ取得時間の最適化に役立つことです。データベースのサイズを把握していれば、効率的なクエリを設計し、インデックスをより効果的に管理できるようになります。

次の例を見てみましょう：

SELECT *,pg_size_pretty(total_bytes) AS total
    , pg_size_pretty(index_bytes) AS INDEX
    , pg_size_pretty(toast_bytes) AS toast
    , pg_size_pretty(table_bytes) AS TABLE
  FROM (
  SELECT *, total_bytes-index_bytes-COALESCE(toast_bytes,0) AS table_bytes
    FROM (
      SELECT c.oid,nspname AS table_schema, relname AS TABLE_NAME
          , c.reltuples AS row_estimate
          , pg_total_relation_size(c.oid) AS total_bytes
          , pg_indexes_size(c.oid) AS index_bytes
          , COALESCE(pg_total_relation_size(reltoastrelid), 0) AS toast_bytes
      FROM pg_class c
      LEFT JOIN pg_namespace n ON n.oid = c.relnamespace
      WHERE relkind = 'r'
  ) a) a;