Aurora DSQL のシステムテーブルとコマンド

Aurora DSQL でサポートされているシステムテーブルやカタログ、およびシステムに関する情報 (バージョンなど) を取得するための便利なクエリについては、以下のセクションを参照してください。

システムテーブル

Aurora DSQL は PostgreSQL と互換性があるため、PostgreSQL の多くのシステムカタログテーブルとビューが Aurora DSQL にも存在します。

重要な PostgreSQL カタログテーブルとビュー

次の表は、Aurora DSQL で使用できる最も一般的なテーブルとビューを示しています。

サポートされているカタログテーブルとサポートされていないカタログテーブル

次の表は、Aurora DSQL でサポートされているテーブルとサポートされていないテーブルを示しています。

サポートされているシステムビューとサポートされていないシステムビュー

次の表は、Aurora DSQL でサポートされているビューとサポートされていないビューを示しています。

sys.jobs ビュー

sys.jobs は、非同期ジョブに関するステータス情報を提供します。例えば、非同期インデックスを作成すると、Aurora DSQL は job_uuid を返します。この job_uuid と sys.jobs を使って、ジョブのステータスを検索できます。

SELECT * FROM sys.jobs;

Aurora DSQL は、次のようなレスポンスを返します。

           job_id           |  status   | details |  job_type   | class_id | object_id |    object_name    |       start_time       |      update_time
----------------------------+-----------+---------+-------------+----------+-----------+-------------------+------------------------+------------------------
 wqhu6ewifze5xitg3umt24h5ua | completed |         | INDEX_BUILD |     1259 |     26433 | public.nt2_c1_idx | 2025-09-25 22:07:31+00 | 2025-09-25 22:07:46+00
 kkngzf33dndl3daacxehpx5eba | completed |         | ANALYZE     |     1259 |     26419 | public.nt         | 2025-09-25 21:57:05+00 | 2025-09-25 21:57:27+00
 fyopxjb6ovdn7po6lrkj63cyea | completed |         | DROP        |     1259 |     26422 |                   | 2025-09-25 22:05:57+00 | 2025-09-25 22:06:03+00

次の表では、sys.jobs ビューの列について説明します。

sys.iam_pg_role_mappings ビュー

ビュー sys.iam_pg_role_mappings には、IAM ユーザーに付与されたアクセス許可に関する情報が表示されます。例えば、DQSLDBConnect が Aurora DSQL に管理者以外のユーザーへのアクセスを許可する IAM ロールで、testuser という名前のユーザーに DQSLDBConnect ロールと対応するアクセス許可が付与されている場合、sys.iam_pg_role_mappings ビューをクエリして、どのユーザーにどのアクセス許可が付与されているかを確認できます。

SELECT * FROM sys.iam_pg_role_mappings;

役立つシステムメタデータクエリ

これらのクエリを使用して、テーブルのフルスキャンなどの高コストのオペレーションを実行せずに、テーブル統計とシステムメタデータを取得します。

テーブルの推定行数を取得する

テーブルのフルスキャンを実行せずにテーブル内の行数の概算数を取得するには、次のクエリを使用します。

SELECT reltuples FROM pg_class WHERE relname = 'table_name';

このコマンドにより、以下のような出力が返されます。

  reltuples
--------------
 9.993836e+08

このアプローチは、Aurora DSQL の大きなテーブルに対する SELECT COUNT(*) よりも効率的です。

現在の Aurora DSQL メジャーバージョンを取得する

Aurora DSQL クラスターの現在のメジャーバージョンを取得するには、次のクエリを使用します。

SELECT * FROM sys.dsql_major_version();

このコマンドにより、以下のような出力が返されます。

 dsql_major_version
--------------------
                  1

これにより、Aurora DSQL で SQL 接続がオンになっているメジャーバージョンが返されます。

現在の PostgreSQL バージョンを取得する

Aurora DSQL クラスターの現在の PostgreSQL バージョンを取得するには、次のクエリを実行します。

SHOW server_version;

このコマンドにより、以下のような出力が返されます。

 server_version
----------------
 16.13

これにより、Aurora DSQL で SQL 接続がオンになっている PostgreSQL バージョンが返されます。

ANALYZE コマンド

ANALYZE コマンドは、データベース内のテーブルの内容に関する統計を収集し、結果を pg_stats システムビューに保存します。その後、クエリプランナーはこれらの統計を使用して、最も効率的なクエリの実行プランを決定します。

Aurora DSQL では、明示的なトランザクション内で ANALYZE コマンドを実行することはできません。ANALYZE はデータベーストランザクションのタイムアウト制限の対象ではありません。

手動介入の必要性を減らし、統計を一貫して最新の状態に保つために、Aurora DSQL はバックグラウンド処理として ANALYZE を自動的に実行します。このバックグラウンドジョブは、テーブルで観測された変化率に基づいて自動的にトリガーされます。これは、前回の分析以降に挿入、更新、または削除された行 (タプル) の数にリンクされます。

ANALYZE はバックグラウンドで非同期的に実行され、そのアクティビティは次のクエリを使用してシステムビュー sys.jobs でモニタリングできます。

SELECT * FROM sys.jobs WHERE job_type = 'ANALYZE';

主な考慮事項

バックグラウンド ANALYZE ジョブは自動的にトリガーされ、手動 ANALYZE で収集するタイプの統計と同じものを収集し、デフォルトでユーザーテーブルに適用します。システムテーブルとカタログテーブルは、この自動プロセスから除外されます。