Amazon Redshift tidak akan lagi mendukung penggunaan Python UDF setelah 30 Juni 2026. Kami akan mulai menegakkannya secara bertahap. Untuk informasi lebih lanjut tentang detail opsi akhir masa pakai dan migrasi Python, lihat posting blog yang diterbitkan pada 30 Juni 2025.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

EXPLAIN

Menampilkan rencana eksekusi untuk pernyataan kueri tanpa menjalankan kueri. Untuk informasi tentang alur kerja analisis kueri, lihatAlur kerja analisis kueri.

Sintaksis

EXPLAIN [ VERBOSE ] query
                  

Parameter

Catatan penggunaan

Kinerja EXPLAIN terkadang dipengaruhi oleh waktu yang dibutuhkan untuk membuat tabel sementara. Misalnya, kueri yang menggunakan optimasi subexpression umum memerlukan tabel sementara untuk dibuat dan dianalisis untuk mengembalikan output EXPLAIN. Rencana kueri tergantung pada skema dan statistik tabel sementara. Oleh karena itu, perintah EXPLAIN untuk jenis kueri ini mungkin membutuhkan waktu lebih lama untuk dijalankan dari yang diharapkan.

Anda dapat menggunakan EXPLAIN hanya untuk perintah berikut:

Perintah EXPLAIN akan gagal jika Anda menggunakannya untuk perintah SQL lainnya, seperti bahasa definisi data (DDL) atau operasi database.

Biaya unit relatif keluaran EXPLAIN digunakan oleh Amazon Redshift untuk memilih paket kueri. Amazon Redshift membandingkan ukuran berbagai perkiraan sumber daya untuk menentukan rencana.

Langkah-langkah perencanaan dan pelaksanaan kueri

Rencana eksekusi untuk pernyataan kueri Amazon Redshift tertentu memecah eksekusi dan perhitungan kueri menjadi urutan langkah dan operasi tabel terpisah yang akhirnya menghasilkan set hasil akhir untuk kueri. Untuk informasi tentang perencanaan kueri, lihatPemrosesan kueri.

Tabel berikut memberikan ringkasan langkah-langkah yang dapat digunakan Amazon Redshift dalam mengembangkan rencana eksekusi untuk setiap kueri yang dikirimkan pengguna untuk dieksekusi.

Menggunakan EXPLAIN untuk RLS

Jika kueri berisi tabel yang tunduk pada kebijakan keamanan tingkat baris (RLS), EXPLAIN menampilkan node RLS khusus. SecureScan Amazon Redshift juga mencatat jenis node yang sama ke tabel sistem STL_EXPLAIN. EXPLAIN tidak mengungkapkan predikat RLS yang berlaku untuk dim_tbl. Jenis SecureScan node RLS berfungsi sebagai indikator bahwa rencana eksekusi berisi operasi tambahan yang tidak terlihat oleh pengguna saat ini.

Contoh berikut menggambarkan SecureScan node RLS.

EXPLAIN
SELECT D.cint
FROM fact_tbl F INNER JOIN dim_tbl D ON F.k_dim = D.k
WHERE F.k_dim / 10 > 0;
                               QUERY PLAN
------------------------------------------------------------------------
 XN Hash Join DS_DIST_ALL_NONE  (cost=0.08..0.25 rows=1 width=4)
   Hash Cond: ("outer".k_dim = "inner"."k")
   ->  *XN* *RLS SecureScan f  (cost=0.00..0.14 rows=2 width=4)*
         Filter: ((k_dim / 10) > 0)
   ->  XN Hash  (cost=0.07..0.07 rows=2 width=8)
         ->  XN Seq Scan on dim_tbl d  (cost=0.00..0.07 rows=2 width=8)
               Filter: (("k" / 10) > 0)

Untuk mengaktifkan penyelidikan penuh terhadap paket kueri yang tunduk pada RLS, Amazon Redshift menawarkan izin sistem EXPLAIN RLS. Pengguna yang telah diberikan izin ini dapat memeriksa rencana kueri lengkap yang juga menyertakan predikat RLS.

Contoh berikut menggambarkan Seq Scan tambahan di bawah SecureScan node RLS juga menyertakan predikat kebijakan RLS (k_dim > 1).

EXPLAIN SELECT D.cint
FROM fact_tbl F INNER JOIN dim_tbl D ON F.k_dim = D.k
WHERE F.k_dim / 10 > 0;
                                   QUERY PLAN
---------------------------------------------------------------------------------
 XN Hash Join DS_DIST_ALL_NONE  (cost=0.08..0.25 rows=1 width=4)
   Hash Cond: ("outer".k_dim = "inner"."k")
   *->  XN RLS SecureScan f  (cost=0.00..0.14 rows=2 width=4)
         Filter: ((k_dim / 10) > 0)*
         ->  *XN* *Seq Scan on fact_tbl rls_table  (cost=0.00..0.06 rows=5 width=8)
               Filter: (k_dim > 1)*
   ->  XN Hash  (cost=0.07..0.07 rows=2 width=8)
         ->  XN Seq Scan on dim_tbl d  (cost=0.00..0.07 rows=2 width=8)
               Filter: (("k" / 10) > 0)

Sementara izin EXPLAIN RLS diberikan kepada pengguna, Amazon Redshift mencatat paket kueri lengkap termasuk predikat RLS dalam tabel sistem STL_EXPLAIN. Kueri yang dijalankan saat izin ini tidak diberikan akan dicatat tanpa internal RLS. Memberikan atau menghapus izin EXPLAIN RLS tidak akan mengubah apa yang telah dicatat Amazon Redshift ke STL_EXPLAIN untuk kueri sebelumnya.

AWS Lake Formation-RLS melindungi hubungan Redshift

Contoh berikut menggambarkan SecureScan node LF, yang dapat Anda gunakan untuk melihat Formation-RLS relasi Lake.

EXPLAIN
SELECT *
FROM lf_db.public.t_share
WHERE a > 1;
QUERY PLAN
---------------------------------------------------------------
XN LF SecureScan t_share  (cost=0.00..0.02 rows=2 width=11)
(2 rows)

Contoh

Contoh berikut mengembalikan rencana kueri untuk kueri yang memilih EVENTID, EVENTNAME, VENUEID, dan VENUENAME dari tabel EVENT dan VENUE:

explain
select eventid, eventname, event.venueid, venuename
from event, venue
where event.venueid = venue.venueid;

                                QUERY PLAN
--------------------------------------------------------------------------
XN Hash Join DS_DIST_OUTER  (cost=2.52..58653620.93 rows=8712 width=43)
Hash Cond: ("outer".venueid = "inner".venueid)
->  XN Seq Scan on event  (cost=0.00..87.98 rows=8798 width=23)
->  XN Hash  (cost=2.02..2.02 rows=202 width=22)
->  XN Seq Scan on venue  (cost=0.00..2.02 rows=202 width=22)
(5 rows)

Contoh berikut mengembalikan rencana kueri untuk kueri yang sama dengan output verbose:

explain verbose
select eventid, eventname, event.venueid, venuename
from event, venue
where event.venueid = venue.venueid;

                                QUERY PLAN
--------------------------------------------------------------------------
{HASHJOIN
:startup_cost 2.52
:total_cost 58653620.93
:plan_rows 8712
:plan_width 43
:best_pathkeys <>
:dist_info DS_DIST_OUTER
:dist_info.dist_keys (
TARGETENTRY
{
VAR
:varno 2
:varattno 1
...

XN Hash Join DS_DIST_OUTER  (cost=2.52..58653620.93 rows=8712 width=43)
Hash Cond: ("outer".venueid = "inner".venueid)
->  XN Seq Scan on event  (cost=0.00..87.98 rows=8798 width=23)
->  XN Hash  (cost=2.02..2.02 rows=202 width=22)
->  XN Seq Scan on venue  (cost=0.00..2.02 rows=202 width=22)
(519 rows)

Contoh berikut mengembalikan rencana kueri untuk pernyataan CREATE TABLE AS (CTAS):

explain create table venue_nonulls as
select * from venue
where venueseats is not null;

QUERY PLAN
-----------------------------------------------------------
XN Seq Scan on venue  (cost=0.00..2.02 rows=187 width=45)
Filter: (venueseats IS NOT NULL)
(2 rows)