このページでは、列エンジンの使用率をモニタリングする方法について説明します。
EXPLAIN を使用してカラム型エンジンの使用を確認する
クエリの生成されたクエリプランに表示される新しい列型演算子をモニタリングするには、EXPLAIN ステートメントを使用して列型エンジンの使用状況を確認します。
EXPLAIN (ANALYZE,COSTS OFF,BUFFERS,TIMING OFF,SUMMARY OFF)
SELECT l_returnflag, l_linestatus, l_quantity, l_extendedprice,
l_discount, l_tax
FROM lineitem
WHERE l_shipdate <= date '1992-08-06'
;
QUERY PLAN
-----------------------------------------------------------------------------
Append (actual rows=3941797 loops=1)
Buffers: shared hit=9
-> Custom Scan (columnar scan) on lineitem (actual rows=3941797 loops=1)
Filter: (l_shipdate <= '1992-08-06'::date)
Rows Removed by Columnar Filter: 56054083
Columnar cache search mode: columnar filter only
Buffers: shared hit=9
-> Seq Scan on lineitem (never executed)
Filter: (l_shipdate <= '1992-08-06'::date)
Custom Scan (columnar scan)は、クエリプランに列エンジン スキャンが含まれていることを示します。Rows Removed by Columnar Filterには、列ベクトル化された実行によって除外された行の数が表示されます。Columnar cache search modeはcolumnar filter only、native、またはrow store scanです。プランナーは、費用とプッシュダウン評価機能に基づいて検索モードを自動的に選択します。
プランナーが native モードを選択すると、一部の列演算子がスキャンにプッシュダウンされます。
Rows Aggregated by Columnar Scanには、集計された行の数が表示されます。Rows Sorted by Columnar Scanには、並べ替えられた行数が表示されます。Rows Limited by Columnar Scanは、スキャンされた行数の制限付きのリストです。
結合では、列スキャン演算子で Late Materialization モードを使用することもできます。
EXPLAIN (ANALYZE,COSTS OFF,BUFFERS,TIMING OFF,SUMMARY OFF)
SELECT l_shipmode, o_orderpriority
FROM orders, lineitem
WHERE o_orderkey = l_orderkey
AND l_shipmode in ('AIR', 'FOB')
AND l_receiptdate >= date '1995-01-01'
;
QUERY PLAN
-----------------------------------------------------------------------------
Hash Join (actual rows=9865288 loops=1)
Hash Cond: (lineitem.l_orderkey = orders.o_orderkey)
Buffers: temp read=127738 written=127738
-> Append (actual rows=9865288 loops=1)
-> Custom Scan (columnar scan) on lineitem (actual rows=9865288 loops=1)
Filter: ((l_shipmode = ANY ('{AIR,FOB}'::bpchar[])) AND
(l_receiptdate >= '1995-01-01'::date))
Rows Removed by Columnar Filter: 50130592
Columnar cache search mode: native
-> Index Scan using idx_lineitem_orderkey_fkidx on lineitem
(never executed)
Filter: ((l_shipmode = ANY ('{AIR,FOB}'::bpchar[])) AND
(l_receiptdate >= '1995-01-01'::date))
-> Hash (actual rows=15000000 loops=1)
Buckets: 1048576 Batches: 32 Memory Usage: 37006kB
Buffers: temp written=83357
-> Append (actual rows=15000000 loops=1)
-> Custom Scan (columnar scan) on orders (actual rows=15000000
loops=1)
Rows Removed by Columnar Filter: 0
Columnar projection mode: late materialization
Columnar cache search mode: native
-> Seq Scan on orders (never executed)
Columnar projection mode は late materialization にできます。列オペレーターは、プランナーが一部列値のマテリアライゼーションを遅らせて投影を最適化するときに、このモードを自動的に選択します。
列ストア内の列を含むテーブルに関する情報を表示する
列ストア内の列を含むテーブルまたはマテリアライズド ビューに関する情報を表示するには、g_columnar_relations ビューをクエリします。
SELECT * FROM g_columnar_relations; ┌─[ RECORD 1 ]────────┬───────────────────┐ │ relation_name │ tbl_parallel_test │ │ schema_name │ public │ │ database_name │ advisor │ │ status │ Usable │ │ size │ 581431259 │ │ columnar_unit_count │ 3 │ │ invalid_block_count │ 0 │ │ total_block_count │ 8337 │ ├─[ RECORD 2 ]────────┼───────────────────┤ │ relation_name │ lineitem │ │ schema_name │ public │ │ database_name │ advisor │ │ status │ Usable │ │ size │ 423224944 │ │ columnar_unit_count │ 29 │ │ invalid_block_count │ 0 │ │ total_block_count │ 115662 │ ├─[ RECORD 3 ]────────┼───────────────────┤
列ストア内の列に関する情報を表示する
列ストア内の列に関する情報（列のサイズや最終アクセス時間など）は、g_columnar_columns ビューをクエリすることで確認できます。
SELECT database_name, schema_name, relation_name, column_name, size_in_bytes, last_accessed_time FROM g_columnar_columns;
最近のクエリのカラム型エンジン実行統計情報を表示する
g_columnar_stat_statements ビューを使用して、最近のクエリのカラム型エンジン実行統計情報を表示できます。このビューは、pg_stat_statements 拡張機能によって提供される pg_stat_statements ビューに列エンジンの統計情報を追加します。このビューを使用するには、まず pg_stat_statements 拡張機能を有効にする必要があります。
pg_stat_statements拡張機能を有効にします。CREATE EXTENSION pg_stat_statements;
- 統計情報を表示するクエリを実行します。これは手動で行うことも、アプリケーションで
pg_stat_statementsを有効にしてこれらのクエリを実行するまで十分な時間を待つこともできます。 g_columnar_stat_statementsビューとpg_stat_statementsビューをクエリします。次のクエリは、拡張機能pg_stat_statementsの作成前に収集された統計情報を含む、すべての列実行統計情報を取得します。useridの10値は、拡張機能pg_stat_statementsが作成される前に統計情報が収集されたことを示します。SELECT * FROM pg_stat_statements(TRUE) AS pg_stats FULL JOIN g_columnar_stat_statements AS g_stats ON pg_stats.userid = g_stats.user_id AND pg_stats.dbid = g_stats.db_id AND pg_stats.queryid = g_stats.query_id WHERE columnar_unit_read > 0; ┌─[ RECORD 1 ]────────┬─────────────────────────────── │ userid │ 10 │ │ dbid │ 33004 │ │ queryid │ 6779068104316758833 │ │ query │ SELECT l_returnflag, ↵│ │ │ l_linestatus, ↵│ │ │ l_quantity, ↵│ │ │ l_extendedprice, ↵│ │ │ l_discount, ↵│ │ │ l_tax ↵│ │ │FROM lineitem ↵│ │ │WHERE l_shipdate <= date $1│ │ calls │ 1 │ │ total_time │ 299.969983 │ │ min_time │ 299.969983 │ │ max_time │ 299.969983 │ │ mean_time │ 299.969983 │ │ stddev_time │ 0 │ │ rows │ 392164 │ │ shared_blks_hit │ 0 │ │ shared_blks_read │ 0 │ │ shared_blks_dirtied │ 0 │ │ shared_blks_written │ 0 │ │ local_blks_hit │ 0 │ │ local_blks_read │ 0 │ │ local_blks_dirtied │ 0 │ │ local_blks_written │ 0 │ │ temp_blks_read │ 0 │ │ temp_blks_written │ 0 │ │ blk_read_time │ 0 │ │ blk_write_time │ 0 │ │ user_id │ 10 │ │ db_id │ 33004 │ │ query_id │ 6779068104316758833 │ │ columnar_unit_read │ 29 │ │ page_read │ 115662 │ │ rows_filtered │ 0 │ │ columnar_scan_time │ 0 │ └─────────────────────┴───────────────────────────────┘
列ストアのメモリ使用量を表示する
カラム型エンジンで使用可能な未使用の RAM の量を確認するには、google_columnar_engine_memory_available 関数をクエリします。出力の整数は、使用可能なメモリをメガバイト（MB）単位で示します。
SELECT google_columnar_engine_memory_available();
カラム型エンジンのストレージ キャッシュを表示する
列エンジンのストレージ キャッシュに関するデータを表示してモニタリングするには、次の関数を呼び出します。
| 関数 | 説明 |
|---|---|
google_columnar_engine_storage_cache_used |
使用されているカラム型エンジン ストレージ キャッシュのサイズを返します。 |
google_columnar_engine_storage_cache_available |
未使用のカラム型エンジン ストレージ キャッシュのサイズを返します。 |
google_columnar_engine_storage_cache_total |
カラム型エンジン用に構成されたストレージ キャッシュのサイズの合計を返します。 |
次の例は、列型エンジンのストレージ キャッシュに関するデータを表示およびモニタリングするために使用される SQL 関数をクエリする方法を示しています。
SELECT SQL_FUNCTION;
SQL_FUNCTION は、上の表から使用する列エンジン ストレージ キャッシュ関数の名前に置き換えます。