Amazon Redshift tidak akan lagi mendukung pembuatan Python UDFs baru mulai Patch 198. Python yang ada UDFs akan terus berfungsi hingga 30 Juni 2026. Untuk informasi lebih lanjut, lihat [posting blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # MERGE Secara kondisional menggabungkan baris dari tabel sumber ke dalam tabel target. Secara tradisional, ini hanya dapat dicapai dengan menggunakan beberapa pernyataan insert, update atau delete secara terpisah. Untuk informasi selengkapnya tentang operasi yang menggabungkan memungkinkan Anda menggabungkan, lihat [UPDATE](https://docs.aws.amazon.com/redshift/latest/dg/r_UPDATE.html), [DELETE](https://docs.aws.amazon.com/redshift/latest/dg/r_DELETE.html), dan [INSERT](https://docs.aws.amazon.com/redshift/latest/dg/r_INSERT_30.html). ## Sintaksis ``` MERGE INTO target_table USING source_table [ [ AS ] alias ] ON match_condition [ WHEN MATCHED THEN { UPDATE SET col_name = { expr } [,...] | DELETE } WHEN NOT MATCHED THEN INSERT [ ( col_name [,...] ) ] VALUES ( { expr } [, ...] ) | REMOVE DUPLICATES ] ``` ## Parameter *target\$1table* Tabel sementara atau permanen tempat pernyataan MERGE digabungkan. *source\$1table* *Tabel sementara atau permanen yang memasok baris untuk digabungkan menjadi target\$1table.* *source\$1table juga bisa menjadi tabel* Spectrum. *alias* Nama alternatif sementara untuk *source\$1table*. Parameter ini bersifat opsional. *Alias sebelumnya dengan AS juga* opsional. *match\$1condition* *Menentukan predikat yang sama antara kolom tabel sumber dan kolom tabel target yang digunakan untuk menentukan apakah baris di *source\$1table dapat dicocokkan dengan baris di target\$1table*.* Jika kondisi terpenuhi, MERGE menjalankan *matched\$1clause* untuk baris itu. Jika tidak, MERGE menjalankan *not\$1matched\$1clause* untuk baris itu. SAAT DICOCOKKAN Menentukan tindakan yang akan dijalankan ketika kondisi kecocokan antara baris sumber dan baris target mengevaluasi ke True. Anda dapat menentukan tindakan UPDATE atau tindakan DELETE. UPDATE Memperbarui baris yang cocok di *target\$1table*. Hanya nilai dalam *col\$1name* yang Anda tentukan yang diperbarui. DELETE *Menghapus baris yang cocok di target\$1table.* BILA TIDAK COCOK Menentukan tindakan yang akan dijalankan ketika kondisi kecocokan dievaluasi ke False atau Unknown. Anda hanya dapat menentukan tindakan insert insert untuk klausa ini. INSERT **Menyisipkan ke dalam baris *target\$1table* dari *source\$1table yang tidak cocok dengan baris apa pun di target\$1table*, menurut match\$1condition.** Target *col\$1name* dapat dicantumkan dalam urutan apa pun. Jika Anda tidak memberikan nilai *col\$1name*, urutan default adalah semua kolom tabel dalam urutan yang dideklarasikan. *col\$1name* Satu atau beberapa nama kolom yang ingin Anda ubah. Jangan sertakan nama tabel saat menentukan kolom target. *expr* Ekspresi mendefinisikan nilai baru untuk *col\$1name*. HAPUS DUPLIKAT Menentukan bahwa perintah MERGE berjalan dalam mode disederhanakan. Mode yang disederhanakan memiliki persyaratan sebagai berikut: + *target\$1table* dan *source\$1table* harus memiliki jumlah kolom yang sama, jenis kolom yang kompatibel, dan urutan kolom yang sama. + Hilangkan klausa WHEN dan klausa UPDATE dan INSERT dari perintah MERGE Anda. + Gunakan klausa REMOVE DUPLICATES dalam perintah MERGE Anda. Dalam mode yang disederhanakan, MERGE melakukan hal berikut: + *Baris di *target\$1table* yang memiliki kecocokan di *source\$1table* diperbarui agar sesuai dengan nilai di source\$1table.* + *Baris di *source\$1table* yang tidak memiliki kecocokan di *target\$1table disisipkan ke target\$1table*.* + Ketika beberapa baris di *target\$1table* cocok dengan baris yang sama di *source\$1table*, baris duplikat akan dihapus. Amazon Redshift menyimpan satu baris dan memperbaruinya. Baris duplikat yang tidak cocok dengan baris di *source\$1table* tetap tidak berubah. Menggunakan REMOVE DUPLICATES memberikan kinerja yang lebih baik daripada menggunakan WHEN MATCHED dan WHEN NOT MATCHED. *Sebaiknya gunakan REMOVE DUPLICATES jika *target\$1table* dan *source\$1table* kompatibel dan Anda tidak perlu mempertahankan baris duplikat di target\$1table.* ## Catatan penggunaan + Untuk menjalankan pernyataan MERGE, Anda harus menjadi pemilik *source\$1table dan target\$1table**, atau memiliki izin SELECT untuk tabel* tersebut. Selain itu, Anda harus memiliki izin UPDATE, DELETE, dan INSERT untuk *target\$1table* tergantung pada operasi yang disertakan dalam pernyataan MERGE Anda. + *target\$1table* tidak bisa berupa tabel sistem, tabel katalog, atau tabel eksternal. + *source\$1table dan target\$1table* *tidak bisa menjadi tabel* yang sama. + Anda tidak dapat menggunakan klausa WITH dalam pernyataan MERGE. + *Baris di *target\$1table* tidak dapat mencocokkan beberapa baris di source\$1table.* Pertimbangkan contoh berikut: ``` CREATE TABLE target (id INT, name CHAR(10)); CREATE TABLE source (id INT, name CHAR(10)); INSERT INTO target VALUES (1, 'Bob'), (2, 'John'); INSERT INTO source VALUES (1, 'Tony'), (1, 'Alice'), (3, 'Bill'); MERGE INTO target USING source ON target.id = source.id WHEN MATCHED THEN UPDATE SET id = source.id, name = source.name WHEN NOT MATCHED THEN INSERT VALUES (source.id, source.name); ERROR: Found multiple matches to update the same tuple. MERGE INTO target USING source ON target.id = source.id WHEN MATCHED THEN DELETE WHEN NOT MATCHED THEN INSERT VALUES (source.id, source.name); ERROR: Found multiple matches to update the same tuple. ``` Dalam kedua pernyataan MERGE, operasi gagal karena ada beberapa baris dalam `source` tabel dengan nilai ID. `1` + *match\$1condition* dan *expr* tidak dapat mereferensikan sebagian kolom tipe SUPER. Misalnya, jika objek tipe SUPER Anda adalah array atau struktur, Anda tidak dapat menggunakan elemen individual dari kolom tersebut untuk *match\$1condition* atau *expr*, tetapi Anda dapat menggunakan seluruh kolom. Pertimbangkan contoh berikut: ``` CREATE TABLE IF NOT EXISTS target (key INT, value SUPER); CREATE TABLE IF NOT EXISTS source (key INT, value SUPER); INSERT INTO target VALUES (1, JSON_PARSE('{"key": 88}')); INSERT INTO source VALUES (1, ARRAY(1, 'John')), (2, ARRAY(2, 'Bill')); MERGE INTO target USING source ON target.key = source.key WHEN matched THEN UPDATE SET value = source.value[0] WHEN NOT matched THEN INSERT VALUES (source.key, source.value[0]); ERROR: Partial reference of SUPER column is not supported in MERGE statement. ``` Untuk informasi selengkapnya tentang tipe SUPER, lihat [tipe SUPER](https://docs.aws.amazon.com/redshift/latest/dg/r_SUPER_type.html). + Jika *source\$1table* berukuran besar, mendefinisikan kolom gabungan dari *target\$1table dan *source\$1table** sebagai kunci distribusi dapat meningkatkan kinerja. + *Untuk menggunakan klausa HAPUS DUPLIKAT, Anda memerlukan izin SELECT, INSERT, dan DELETE untuk target\$1table.* + *source\$1table* dapat berupa tampilan atau subquery. Berikut ini adalah contoh pernyataan MERGE di mana *source\$1table* adalah subquery yang menghapus baris duplikat. ``` MERGE INTO target USING (SELECT id, name FROM source GROUP BY 1, 2) as my_source ON target.id = my_source.id WHEN MATCHED THEN UPDATE SET id = my_source.id, name = my_source.name WHEN NOT MATCHED THEN INSERT VALUES (my_source.id, my_source.name); ``` + Target tidak dapat menjadi sumber data dari setiap subquery dari pernyataan MERGE yang sama. Misalnya, perintah SQL berikut mengembalikan kesalahan seperti ERROR: Sumber view/subquery dalam pernyataan Merge tidak dapat referensi tabel target. karena referensi subquery `target` bukan. `source` ``` MERGE INTO target USING (SELECT id, name FROM target GROUP BY 1, 2) as my_source ON target.id = my_source.id WHEN MATCHED THEN UPDATE SET id = my_source.id, name = my_source.name WHEN NOT MATCHED THEN INSERT VALUES (my_source.id, my_source.name); ``` ## Contoh Contoh berikut membuat dua tabel, lalu menjalankan operasi MERGE pada mereka, memperbarui baris yang cocok dalam tabel target dan menyisipkan baris yang tidak cocok. Kemudian menyisipkan nilai lain ke dalam tabel sumber dan menjalankan operasi MERGE lain, kali ini menghapus baris yang cocok dan memasukkan baris baru dari tabel sumber. Pertama buat dan isi tabel sumber dan target. ``` CREATE TABLE target (id INT, name CHAR(10)); CREATE TABLE source (id INT, name CHAR(10)); INSERT INTO target VALUES (101, 'Bob'), (102, 'John'), (103, 'Susan'); INSERT INTO source VALUES (102, 'Tony'), (103, 'Alice'), (104, 'Bill'); SELECT * FROM target; id | name -----+------------ 101 | Bob 102 | John 103 | Susan (3 rows) SELECT * FROM source; id | name -----+------------ 102 | Tony 103 | Alice 104 | Bill (3 rows) ``` Selanjutnya, gabungkan tabel sumber ke dalam tabel target, perbarui tabel target dengan baris yang cocok dan masukkan baris dari tabel sumber yang tidak cocok. ``` MERGE INTO target USING source ON target.id = source.id WHEN MATCHED THEN UPDATE SET id = source.id, name = source.name WHEN NOT MATCHED THEN INSERT VALUES (source.id, source.name); SELECT * FROM target; id | name -----+------------ 101 | Bob 102 | Tony 103 | Alice 104 | Bill (4 rows) ``` Perhatikan bahwa baris dengan nilai id 102 dan 103 diperbarui agar sesuai dengan nilai nama dari tabel target. Juga, baris baru dengan nilai id 104 dan nilai nama Bill dimasukkan ke dalam tabel target. Selanjutnya, masukkan baris baru ke dalam tabel sumber. ``` INSERT INTO source VALUES (105, 'David'); SELECT * FROM source; id | name -----+------------ 102 | Tony 103 | Alice 104 | Bill 105 | David (4 rows) ``` Terakhir, jalankan operasi gabungan menghapus baris yang cocok di tabel target, dan menyisipkan baris yang tidak cocok. ``` MERGE INTO target USING source ON target.id = source.id WHEN MATCHED THEN DELETE WHEN NOT MATCHED THEN INSERT VALUES (source.id, source.name); SELECT * FROM target; id | name -----+------------ 101 | Bob 105 | David (2 rows) ``` Baris dengan nilai id 102, 103, dan 104 dihapus dari tabel target, dan baris baru dengan nilai id 105 dan nilai nama David dimasukkan ke dalam tabel target. Contoh berikut menunjukkan sintaks sederhana dari perintah MERGE yang menggunakan klausa REMOVE DUPLICATES. ``` CREATE TABLE target (id INT, name CHAR(10)); CREATE TABLE source (id INT, name CHAR(10)); INSERT INTO target VALUES (30, 'Tony'), (11, 'Alice'), (23, 'Bill'); INSERT INTO source VALUES (23, 'David'), (22, 'Clarence'); MERGE INTO target USING source ON target.id = source.id REMOVE DUPLICATES; SELECT * FROM target; id | name ---+------------ 30 | Tony 11 | Alice 23 | David 22 | Clarence (4 rows) ``` *Contoh berikut menunjukkan sintaks sederhana dari perintah MERGE yang menggunakan klausa REMOVE DUPLICATES, menghapus baris duplikat dari *target\$1table jika mereka memiliki baris yang cocok di source\$1table*.* ``` CREATE TABLE target (id INT, name CHAR(10)); CREATE TABLE source (id INT, name CHAR(10)); INSERT INTO target VALUES (30, 'Tony'), (30, 'Daisy'), (11, 'Alice'), (23, 'Bill'), (23, 'Nikki'); INSERT INTO source VALUES (23, 'David'), (22, 'Clarence'); MERGE INTO target USING source ON target.id = source.id REMOVE DUPLICATES; SELECT * FROM target; id | name ---+------------ 30 | Tony 30 | Daisy 11 | Alice 23 | David 22 | Clarence (5 rows) ``` Setelah MERGE berjalan, hanya ada satu baris dengan nilai ID 23 di *target\$1table*. *Karena tidak ada baris di *source\$1table* dengan nilai ID 30, dua baris duplikat dengan nilai ID 30 tetap berada di target\$1table.* ## Lihat juga [INSERT](r_INSERT_30.md), [UPDATE](r_UPDATE.md), [DELETE](r_DELETE.md)