PolarDB:pg_hint_plan

Petunjuk metode pemindaian

Petunjuk metode pemindaian memaksa penggunaan metode pemindaian tertentu pada tabel target, yang diidentifikasi berdasarkan alias-nya jika tersedia.

Berlaku untuk: tabel standar, tabel turunan, tabel unlogged, tabel temporary, tabel sistem

Tidak berlaku untuk: tabel eksternal, fungsi tabel, pernyataan nilai konstan, common table expressions (CTEs), tampilan, subkueri

/*+
    SeqScan(t1)
    IndexScan(t2 t2_pkey)
 */
SELECT * FROM table1 t1 JOIN table2 t2 ON (t1.key = t2.key);

Petunjuk metode join

Petunjuk metode join memaksa penggunaan algoritma join tertentu untuk sekumpulan tabel.

Berlaku untuk: tabel standar, tabel turunan, tabel unlogged, tabel temporary, tabel eksternal, tabel sistem, fungsi tabel, perintah nilai konstan, CTEs

Tidak berlaku untuk: tampilan, subkueri

Petunjuk urutan join

Petunjuk urutan join menentukan urutan tabel saat dilakukan join. Dua bentuk sintaks didukung:

• Leading(t1 t2 t3) — hanya menentukan urutan join tanpa membatasi arah pada setiap level

• Leading((t1 t2) t3) — menentukan urutan sekaligus arah join (tanda kurung bersarang menunjukkan pasangan join)

/*+
    NestLoop(t1 t2)
    MergeJoin(t1 t2 t3)
    Leading(t1 t2 t3)
  */
SELECT * FROM table1 t1
    JOIN table2 t2 ON (t1.key = t2.key)
    JOIN table3 t3 ON (t2.key = t3.key);

Dalam contoh ini:

• NestLoop(t1 t2) — menggunakan nested loop join untuk t1 dan t2

• MergeJoin(t1 t2 t3) — menggunakan merge join untuk hasil join (t1, t2) yang kemudian di-join dengan t3

• Leading(t1 t2 t3) — melakukan join ketiga tabel dalam urutan t1 → t2 → t3

Petunjuk koreksi jumlah baris

Petunjuk koreksi jumlah baris mengganti estimasi jumlah baris yang digunakan pengoptimal untuk hasil join. Petunjuk ini berguna ketika statistik pengoptimal tidak akurat.

/*+ Rows(a b #10) */ SELECT ...; -- Tetapkan hasil join menjadi tepat 10 baris
/*+ Rows(a b +10) */ SELECT ...; -- Tambahkan 10 ke estimasi jumlah baris
/*+ Rows(a b -10) */ SELECT ...; -- Kurangi 10 dari estimasi jumlah baris
/*+ Rows(a b *10) */ SELECT ...; -- Kalikan estimasi jumlah baris dengan 10

Petunjuk eksekusi paralel

Petunjuk eksekusi paralel mengontrol tingkat paralelisme untuk suatu kueri.

Berlaku untuk: tabel standar, tabel turunan, tabel unlogged, tabel sistem. Tabel internal dalam tampilan dapat ditargetkan berdasarkan nama asli atau alias-nya.

Tidak berlaku untuk: tabel eksternal, klausa konstan, CTEs, tampilan, subkueri

Contoh 1: Atur paralelisme untuk dua tabel dalam join.

EXPLAIN /*+ Parallel(c1 3 hard) Parallel(c2 5 hard) */
       SELECT c2.a FROM c1 JOIN c2 ON (c1.a = c2.a);

Output:

QUERY PLAN
-------------------------------------------------------------------------------
 Hash Join  (cost=2.86..11406.38 rows=101 width=4)
   Hash Cond: (c1.a = c2.a)
   ->  Gather  (cost=0.00..7652.13 rows=1000101 width=4)
         Workers Planned: 3
         ->  Parallel Seq Scan on c1  (cost=0.00..7652.13 rows=322613 width=4)
   ->  Hash  (cost=1.59..1.59 rows=101 width=4)
         ->  Gather  (cost=0.00..1.59 rows=101 width=4)
               Workers Planned: 5
               ->  Parallel Seq Scan on c2  (cost=0.00..1.59 rows=59 width=4)

Contoh 2: Atur paralelisme untuk agregasi tabel tunggal.

EXPLAIN /*+ Parallel(tl 5 hard) */ SELECT sum(a) FROM tl;

Output:

QUERY PLAN
-----------------------------------------------------------------------------------
 Finalize Aggregate  (cost=693.02..693.03 rows=1 width=8)
   ->  Gather  (cost=693.00..693.01 rows=5 width=8)
         Workers Planned: 5
         ->  Partial Aggregate  (cost=693.00..693.01 rows=1 width=8)
               ->  Parallel Seq Scan on tl  (cost=0.00..643.00 rows=20000 width=4)

Petunjuk parameter GUC

Petunjuk parameter GUC mengubah nilai parameter GUC hanya selama pembuatan rencana kueri. Perubahan ini tidak memengaruhi pernyataan lain. Jika parameter GUC yang sama muncul beberapa kali, nilai terakhir yang berlaku.

/*+ Set(random_page_cost 2.0) */
SELECT * FROM table1 t1 WHERE key = 'value';