PolarDB:ベストプラクティス

概要

ePQをクエリに使用する場合、 PolarDB for PostgreSQL (Compatible with Oracle) はePQオプティマイザを使用して、複数の計算ノードで並列に実行できる実行プランを生成します。 ePQの実行エンジンは、複数の計算ノード上でのプランの実行を調整し、複数のノードのCPU、メモリ、およびI/O帯域幅を使用してデータをスキャンおよび計算します。

サーバーレスのエラスティックスケーリングを実現するには、Grand Unified Configuration (GUC) パラメーターを使用して、ePQに参加する計算ノードの数 (スケールアウト) と各ノードの並列処理の程度 (スケールアップ) を動的に調整できます。

使用上の注意

ePQは、PolarDB for PostgreSQL (Oracle 2.0と互換) では使用できません。

ePQの有効化

次のステートメントは、t1という名前のテーブルのePQ機能を有効にします。 PolarDB PX Optimizerがプランで返された場合、ePQは有効になります。

SET polar_enable_px = 1;
EXPLAIN SELECT * FROM t1;
                                  QUERY PLAN
-------------------------------------------------------------------------------
 PX Coordinator 6:1  (slice1; segments: 6)  (cost=0.00..431.00 rows=1 width=8)
   ->  Partial Seq Scan on t1  (cost=0.00..431.00 rows=1 width=8)
 Optimizer: PolarDB PX Optimizer
(3 rows)

SELECT * FROM t1;

GUCパラメータ

=> CREATE EXTENSION polar_monitor;
CREATE EXTENSION

=> SELECT name,slot_name,type FROM polar_cluster_info WHERE type = 'Replica';
 name  | slot_name |  type
-------+-----------+---------
 node2 | replica1  | Replica
 node3 | replica2  | Replica
(2 rows)

=> SET polar_px_nodes = 'node2,node3';
=> SHOW polar_px_nodes;
 polar_px_nodes
----------------
 node2,node3
(1 row)

ERROR:  over px max workers, already xxx workers, max 30 workers

ベストプラクティス

特定のテーブルにePQの使用を許可

特定のテーブルでのみePQを実行する場合は、polar_px_enable_check_workersをonに設定します。 また、ePQを実行するテーブルにpx_workersオプションを明示的に設定する必要があります。

ALTER TABLE t1 SET (px_workers = 1);

ePQ機能の有効化

グローバルレベル

PolarDBコンソールで、polar_enable_pxをonに設定し、ePQをグローバルに有効にします。 デフォルトでは、ePQはトランザクションクエリと分析クエリの両方に使用されます。

次のサンプルSQL文を使用して、実行計画を表示します。 PolarDB PX Optimizerがプランで返された場合、ePQは有効になります。

=> EXPLAIN SELECT * FROM t1;
                                  QUERY PLAN
-------------------------------------------------------------------------------
 PX Coordinator 6:1  (slice1; segments: 6)  (cost=0.00..431.00 rows=1 width=8)
   ->  Partial Seq Scan on t1  (cost=0.00..431.00 rows=1 width=8)
 Optimizer: PolarDB PX Optimizer
(3 rows)

セッションレベル

セッション内で実行されるすべてのクエリのePQを有効にするには、 polar_enable_pxをONに設定します。

SET polar_enable_px = ON;

データベースレベルとユーザーレベル

ePQがグローバルまたはセッションレベルで有効になった後、システムは他の実行メソッドを使用する前に、並列実行の対象となるすべてのクエリに対して自動的にePQを使用します。 ベストプラクティスの観点から、ePQは、短いトランザクションクエリよりも、分析ワークロードが重い長いクエリに適しています。 短いクエリの場合、接続の確立、データの交換、およびePQの使用中の計算ノード間の接続の破壊に関連するオーバーヘッドは、クエリのパフォーマンスを低下させる可能性があります。

特定のビジネスニーズにePQが必要な場合、ePQを必要とする分析SQLクエリをメインデータベースから抽出し、ePQクエリ用に構成された別のデータベースで実行できます。

ALTER DATABASE ap_database SET polar_enable_px = ON;

または、特定のアカウントを使用して、ePQを必要とする分析SQLクエリを実行できます。

ALTER ROLE ap_role SET polar_enable_px = ON;

クエリレベル

夜間のレポートタスクなど、セッション内の特定のクエリにのみePQを使用する場合は、pg_hint_planプラグインとSQLヒントを使用して、これらのクエリのePQを有効にします。 SQLヒントを機能させるには、pg_hint_planプラグインがGUCパラメーターshared_preload_librariesに追加されていることを確認します。

Prepend /* + PX() */ to a query to enable ePQ for the query.

=> /*+ PX() */ EXPLAIN SELECT * FROM t1;
                                    QUERY PLAN
----------------------------------------------------------------------------------
 PX Coordinator 6:1  (slice1; segments: 6)  (cost=0.00..431.03 rows=1000 width=8)
   ->  Partial Seq Scan on t1  (cost=0.00..431.00 rows=167 width=8)
 Optimizer: PolarDB PX Optimizer
(3 rows)

Prepend /* + NoPX() */ をクエリに追加して、クエリのePQを無効にします。

=> /*+ NoPX() */ EXPLAIN SELECT * FROM t1;
                      QUERY PLAN
------------------------------------------------------
 Seq Scan on t1  (cost=0.00..15.00 rows=1000 width=8)
(1 row)

前払い/* + PX(N) * / へ単一ノードの並列処理でePQを有効にするクエリN. 次の例では、の値 Nは6.

=> /*+ PX(6) */ EXPLAIN SELECT * FROM t1;
                                     QUERY PLAN
------------------------------------------------------------------------------------
 PX Coordinator 12:1  (slice1; segments: 12)  (cost=0.00..431.02 rows=1000 width=8)
   ->  Partial Seq Scan on t1  (cost=0.00..431.00 rows=84 width=8)
 Optimizer: PolarDB PX Optimizer
(3 rows)