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

Kesalahan perangkap

Topik ini menjelaskan bagaimana Amazon Redshift menangani kesalahan.

Ketika kueri atau perintah dalam prosedur tersimpan menyebabkan kesalahan, kueri berikutnya tidak berjalan dan transaksi dibatalkan. Tetapi Anda dapat menangani kesalahan menggunakan EXCEPTION blok.

[ <<label>> ]
[ DECLARE
  declarations ]
BEGIN
  statements
EXCEPTION
  WHEN OTHERS THEN
    statements
END;   

Ketika pengecualian terjadi, dan Anda menambahkan blok penanganan pengecualian, Anda dapat menulis RAISE pernyataan dan sebagian besar pernyataan PL/PG lainnya. SQL Misalnya, Anda dapat memunculkan pengecualian dengan pesan khusus atau menyisipkan catatan ke dalam tabel logging.

Saat memasuki blok penanganan pengecualian, transaksi saat ini dibatalkan dan transaksi baru dibuat untuk menjalankan pernyataan di blok. Jika pernyataan di blok berjalan tanpa kesalahan, transaksi dilakukan dan pengecualian dilemparkan kembali. Terakhir, prosedur yang disimpan keluar.

Satu-satunya kondisi yang didukung dalam blok pengecualian adalahOTHERS, yang cocok dengan setiap jenis kesalahan kecuali pembatalan kueri. Juga, jika terjadi kesalahan di blok penanganan pengecualian, itu dapat ditangkap oleh blok penanganan pengecualian luar.

Ketika kesalahan terjadi di dalam NONATOMIC prosedur, kesalahan tidak dilemparkan kembali jika ditangani oleh blok pengecualian. Lihat SQL pernyataan PL/PG RAISE untuk melempar pengecualian yang ditangkap oleh blok penanganan pengecualian. Pernyataan ini hanya valid di blok penanganan pengecualian. Untuk informasi selengkapnya, lihat MENAIKKAN.

Mengontrol apa yang terjadi setelah kesalahan dalam prosedur tersimpan, dengan CONTINUE handler

CONTINUEHandler adalah jenis handler pengecualian yang mengontrol aliran eksekusi dalam prosedur yang NONATOMIC disimpan. Dengan menggunakannya, Anda dapat menangkap dan menangani pengecualian tanpa mengakhiri blok pernyataan yang ada. Biasanya, ketika kesalahan terjadi dalam prosedur yang disimpan, aliran terganggu dan kesalahan dikembalikan ke pemanggil. Namun, dalam beberapa kasus penggunaan, kondisi kesalahan tidak cukup parah untuk menjamin gangguan aliran. Anda mungkin ingin menangani kesalahan dengan anggun, menggunakan logika penanganan kesalahan yang Anda pilih dalam transaksi terpisah, dan kemudian melanjutkan menjalankan pernyataan yang mengikuti kesalahan. Berikut ini menunjukkan sintaks.

[ DECLARE
  declarations ]
BEGIN
  statements
EXCEPTION
  [ CONTINUE_HANDLER | EXIT_HANDLER ] WHEN OTHERS THEN
    handler_statements
END;   

Ada beberapa tabel sistem yang tersedia untuk membantu Anda mengumpulkan informasi tentang berbagai jenis kesalahan. Lihat informasi selengkapnya di STL_LOAD_ERRORS, STL_ERROR, dan SYS_STREAM_SCAN_ERRORS. Ada juga tabel sistem tambahan yang dapat Anda gunakan untuk memecahkan masalah kesalahan. Informasi lebih lanjut tentang ini dapat ditemukan diTabel sistem dan tampilan referensi.

Contoh

Contoh berikut menunjukkan cara menulis pernyataan di blok penanganan pengecualian. Prosedur tersimpan menggunakan perilaku manajemen transaksi default.

CREATE TABLE employee (firstname varchar, lastname varchar);
INSERT INTO employee VALUES ('Tomas','Smith');
CREATE TABLE employee_error_log (message varchar);

CREATE OR REPLACE PROCEDURE update_employee_sp() AS
$$
BEGIN
    UPDATE employee SET firstname = 'Adam' WHERE lastname = 'Smith';
    EXECUTE 'select invalid';
EXCEPTION WHEN OTHERS THEN
    RAISE INFO 'An exception occurred.';
    INSERT INTO employee_error_log VALUES ('Error message: ' || SQLERRM);
END;
$$ 
LANGUAGE plpgsql;

CALL update_employee_sp();

INFO:  An exception occurred.
ERROR:  column "invalid" does not exist
CONTEXT:  SQL statement "select invalid"
PL/pgSQL function "update_employee_sp" line 3 at execute statement

Dalam contoh ini, jika kita memanggilupdate_employee_sp, pesan informasi Pengecualian terjadi. dinaikkan dan pesan kesalahan dimasukkan ke dalam employee_error_log log tabel logging. Pengecualian asli dilemparkan lagi sebelum prosedur yang disimpan keluar. Kueri berikut menunjukkan catatan yang dihasilkan dari menjalankan contoh.

SELECT * from employee;

firstname | lastname 
-----------+----------
 Tomas     | Smith

SELECT * from employee_error_log;

          message                     
------------------------------------------------
 Error message: column "invalid" does not exist

Untuk informasi selengkapnyaRAISE, termasuk bantuan pemformatan dan daftar level tambahan, lihatPernyataan PL/PGSQL yang didukung.

Contoh berikut menunjukkan cara menulis pernyataan di blok penanganan pengecualian. Prosedur tersimpan menggunakan perilaku manajemen NONATOMIC transaksi. Dalam contoh ini, tidak ada kesalahan yang dilemparkan kembali ke pemanggil setelah panggilan prosedur selesai. UPDATEPernyataan tersebut tidak dibatalkan karena kesalahan dalam pernyataan berikutnya. Pesan informasi dimunculkan dan pesan kesalahan dimasukkan dalam tabel logging.

CREATE TABLE employee (firstname varchar, lastname varchar); 
INSERT INTO employee VALUES ('Tomas','Smith'); 
CREATE TABLE employee_error_log (message varchar);

-- Create the SP in NONATOMIC mode
CREATE OR REPLACE PROCEDURE update_employee_sp_2() NONATOMIC AS
$$
BEGIN
    UPDATE employee SET firstname = 'Adam' WHERE lastname = 'Smith';
    EXECUTE 'select invalid';
EXCEPTION WHEN OTHERS THEN
    RAISE INFO 'An exception occurred.';
    INSERT INTO employee_error_log VALUES ('Error message: ' || SQLERRM);
END;
$$ 
LANGUAGE plpgsql;

CALL update_employee_sp_2();
INFO:  An exception occurred.
CALL

SELECT * from employee;

 firstname | lastname 
-----------+----------
 Adam      | Smith
(1 row)

SELECT * from employee_error_log;

                    message                     
------------------------------------------------
 Error message: column "invalid" does not exist
(1 row)

Contoh ini menunjukkan cara membuat prosedur dengan dua sub blok. Ketika prosedur tersimpan dipanggil, kesalahan dari sub blok pertama ditangani oleh blok penanganan pengecualian. Setelah sub blok pertama selesai, prosedur terus mengeksekusi sub blok kedua. Anda dapat melihat dari hasil bahwa tidak ada kesalahan yang dilemparkan ketika panggilan prosedur selesai. Karyawan UPDATE dan INSERT operasi di atas meja berkomitmen. Pesan kesalahan dari kedua blok pengecualian dimasukkan dalam tabel logging.

CREATE TABLE employee (firstname varchar, lastname varchar); 
INSERT INTO employee VALUES ('Tomas','Smith'); 
CREATE TABLE employee_error_log (message varchar);

CREATE OR REPLACE PROCEDURE update_employee_sp_3() NONATOMIC AS
$$
BEGIN
    BEGIN
        UPDATE employee SET firstname = 'Adam' WHERE lastname = 'Smith';
        EXECUTE 'select invalid1';
    EXCEPTION WHEN OTHERS THEN
        RAISE INFO 'An exception occurred in the first block.';
        INSERT INTO employee_error_log VALUES ('Error message: ' || SQLERRM);
    END;
    BEGIN
        INSERT INTO employee VALUES ('Edie','Robertson');
        EXECUTE 'select invalid2';
    EXCEPTION WHEN OTHERS THEN
        RAISE INFO 'An exception occurred in the second block.';
        INSERT INTO employee_error_log VALUES ('Error message: ' || SQLERRM);
    END;
END;
$$ 
LANGUAGE plpgsql;

CALL update_employee_sp_3();
INFO:  An exception occurred in the first block.
INFO:  An exception occurred in the second block.
CALL

SELECT * from employee;

 firstname | lastname  
-----------+-----------
 Adam      | Smith
 Edie      | Robertson
(2 rows)

SELECT * from employee_error_log;

                     message                     
-------------------------------------------------
 Error message: column "invalid1" does not exist
 Error message: column "invalid2" does not exist
(2 rows)

Contoh berikut menunjukkan bagaimana menggunakan handler CONTINUE pengecualian. Sampel ini membuat dua tabel dan menggunakannya dalam prosedur tersimpan. CONTINUEHandler mengontrol aliran eksekusi dalam prosedur tersimpan dengan perilaku manajemen NONATOMIC transaksi.

CREATE TABLE tbl_1 (a int);
CREATE TABLE tbl_error_logging(info varchar, err_state varchar, err_msg varchar);

CREATE OR REPLACE PROCEDURE sp_exc_handling_1() NONATOMIC AS
$$
BEGIN
    INSERT INTO tbl_1 VALUES (1);
    -- Expect an error for the insert statement following, because of the invalid value
    INSERT INTO tbl_1 VALUES ("val");
    INSERT INTO tbl_1 VALUES (2);
EXCEPTION CONTINUE_HANDLER WHEN OTHERS THEN
    INSERT INTO tbl_error_logging VALUES ('Encountered error', SQLSTATE, SQLERRM);
END;
$$ LANGUAGE plpgsql;

Panggil prosedur yang disimpan:

CALL sp_exc_handling_1();

Aliran berlangsung seperti ini:

Setelah Anda memanggil prosedur tersimpan sampel, tabel berisi catatan berikut:

Contoh penanganan kesalahan tambahan berikut menggunakan EXIT handler dan handler. CONTINUE Ini menciptakan dua tabel: tabel data dan tabel logging. Ini juga menciptakan prosedur tersimpan yang menunjukkan penanganan kesalahan:

CREATE TABLE tbl_1 (a int);
CREATE TABLE tbl_error_logging(info varchar, err_state varchar, err_msg varchar);

CREATE OR REPLACE PROCEDURE sp_exc_handling_2() NONATOMIC AS
$$
BEGIN
    INSERT INTO tbl_1 VALUES (1);
    BEGIN
        INSERT INTO tbl_1 VALUES (100);
        -- Expect an error for the insert statement following, because of the invalid value
        INSERT INTO tbl_1 VALUES ("val");
        INSERT INTO tbl_1 VALUES (101);
    EXCEPTION EXIT_HANDLER WHEN OTHERS THEN
        INSERT INTO tbl_error_logging VALUES ('Encountered error', SQLSTATE, SQLERRM);
    END;
    INSERT INTO tbl_1 VALUES (2);
    -- Expect an error for the insert statement following, because of the invalid value
    INSERT INTO tbl_1 VALUES ("val");
    INSERT INTO tbl_1 VALUES (3);
EXCEPTION CONTINUE_HANDLER WHEN OTHERS THEN
    INSERT INTO tbl_error_logging VALUES ('Encountered error', SQLSTATE, SQLERRM);
END;
$$ LANGUAGE plpgsql;

Setelah Anda membuat prosedur yang disimpan, sebut saja dengan yang berikut:

CALL sp_exc_handling_2();

Ketika kesalahan terjadi di blok pengecualian bagian dalam, yang dikurung oleh set bagian dalam BEGIN danEND, itu ditangani oleh handler. EXIT Setiap kesalahan yang terjadi di blok luar ditangani oleh handlerCONTINUE.

Setelah Anda memanggil prosedur tersimpan sampel, tabel berisi catatan berikut:

Jika tabel tbl_error_logging tidak ada, itu menimbulkan pengecualian.

Contoh berikut menunjukkan bagaimana menggunakan handler CONTINUE pengecualian dengan FOR loop. Sampel ini membuat tiga tabel dan menggunakannya dalam satu FOR lingkaran dalam prosedur tersimpan. FORLoop adalah varian set hasil, yang berarti bahwa itu mengulangi hasil kueri:

CREATE TABLE tbl_1 (a int);
INSERT INTO tbl_1 VALUES (1), (2), (3);
CREATE TABLE tbl_2 (a int);
CREATE TABLE tbl_error_logging(info varchar, err_state varchar, err_msg varchar);

CREATE OR REPLACE PROCEDURE sp_exc_handling_loop() NONATOMIC AS
$$
DECLARE
 rec RECORD;
BEGIN
    FOR rec IN SELECT a FROM tbl_1
    LOOP
        IF rec.a = 2 THEN
            -- Expect an error for the insert statement following, because of the invalid value
            INSERT INTO tbl_2 VALUES("val");
        ELSE
            INSERT INTO tbl_2 VALUES (rec.a);
        END IF;
    END LOOP;
EXCEPTION CONTINUE_HANDLER WHEN OTHERS THEN
    INSERT INTO tbl_error_logging VALUES ('Encountered error', SQLSTATE, SQLERRM);
END;
$$ LANGUAGE plpgsql;

Panggil prosedur yang disimpan:

CALL sp_exc_handling_loop();

Setelah Anda memanggil prosedur tersimpan sampel, tabel berisi catatan berikut:

Catatan penggunaan mengenai CONTINUE handler: