SIMPAN TRANSAKSI (T-SQL)

Artikel
12/22/2023

Berlaku untuk:SQL Server Azure SQL Database Azure SQL Managed Instance

Mengatur titik penyimpanan dalam transaksi.

Sintaksis

SAVE { TRAN | TRANSACTION } { savepoint_name | @savepoint_variable }  
[ ; ]

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

savepoint_name
Adalah nama yang ditetapkan ke titik penyimpanan. Nama titik simpan harus sesuai dengan aturan untuk pengidentifikasi, tetapi dibatasi hingga 32 karakter. savepoint_name selalu peka huruf besar/kecil, bahkan ketika instans SQL Server tidak peka huruf besar/kecil.

@savepoint_variable
Adalah nama variabel yang ditentukan pengguna yang berisi nama titik simpan yang valid. Variabel harus dideklarasikan dengan jenis data char, varchar, nchar, atau nvarchar . Lebih dari 32 karakter dapat diteruskan ke variabel, tetapi hanya 32 karakter pertama yang akan digunakan.

Keterangan

Pengguna dapat mengatur titik penyimpanan, atau penanda, dalam transaksi. Titik penyimpanan menentukan lokasi tempat transaksi dapat kembali jika bagian dari transaksi dibatalkan secara kondisional. Jika transaksi digulung balik ke titik penyimpanan, transaksi harus dilanjutkan ke penyelesaian dengan lebih banyak pernyataan Transact-SQL jika diperlukan dan pernyataan COMMIT TRANSACTION, atau harus dibatalkan sama sekali dengan menggulirkan transaksi kembali ke awalnya. Untuk membatalkan seluruh transaksi, gunakan formulir ROLLBACK TRANSACTION transaction_name. Semua pernyataan atau prosedur transaksi dibatalkan.

Nama titik simpan duplikat diizinkan dalam transaksi, tetapi pernyataan ROLLBACK TRANSACTION yang menentukan nama titik simpan hanya akan mengembalikan transaksi ke TRANSAKSI SIMPAN terbaru menggunakan nama tersebut.

SAVE TRANSACTION tidak didukung dalam transaksi terdistribusi yang dimulai secara eksplisit dengan BEGIN DISTRIBUTED TRANSACTION atau diekskalasikan dari transaksi lokal.

Penting

Pernyataan TRANSAKSI ROLLBACK yang menentukan savepoint_name merilis kunci apa pun yang diperoleh di luar titik penyimpanan, dengan pengecualian eskalasi dan konversi. Kunci ini tidak dilepaskan, dan tidak dikonversi kembali ke mode kunci sebelumnya.

Izin

Memerlukan keanggotaan dalam peran publik.

Contoh

Contoh berikut menunjukkan cara menggunakan titik penyimpanan transaksi untuk mengembalikan hanya modifikasi yang dilakukan oleh prosedur tersimpan jika transaksi aktif dimulai sebelum prosedur tersimpan dijalankan.

USE AdventureWorks2022;  
GO  
IF EXISTS (SELECT name FROM sys.objects  
           WHERE name = N'SaveTranExample')  
    DROP PROCEDURE SaveTranExample;  
GO  
CREATE PROCEDURE SaveTranExample  
    @InputCandidateID INT  
AS  
    -- Detect whether the procedure was called  
    -- from an active transaction and save  
    -- that for later use.  
    -- In the procedure, @TranCounter = 0  
    -- means there was no active transaction  
    -- and the procedure started one.  
    -- @TranCounter > 0 means an active  
    -- transaction was started before the   
    -- procedure was called.  
    DECLARE @TranCounter INT;  
    SET @TranCounter = @@TRANCOUNT;  
    IF @TranCounter > 0  
        -- Procedure called when there is  
        -- an active transaction.  
        -- Create a savepoint to be able  
        -- to roll back only the work done  
        -- in the procedure if there is an  
        -- error.  
        SAVE TRANSACTION ProcedureSave;  
    ELSE  
        -- Procedure must start its own  
        -- transaction.  
        BEGIN TRANSACTION;  
    -- Modify database.  
    BEGIN TRY  
        DELETE HumanResources.JobCandidate  
            WHERE JobCandidateID = @InputCandidateID;  
        -- Get here if no errors; must commit  
        -- any transaction started in the  
        -- procedure, but not commit a transaction  
        -- started before the transaction was called.  
        IF @TranCounter = 0  
            -- @TranCounter = 0 means no transaction was  
            -- started before the procedure was called.  
            -- The procedure must commit the transaction  
            -- it started.  
            COMMIT TRANSACTION;  
    END TRY  
    BEGIN CATCH  
        -- An error occurred; must determine  
        -- which type of rollback will roll  
        -- back only the work done in the  
        -- procedure.  
        IF @TranCounter = 0  
            -- Transaction started in procedure.  
            -- Roll back complete transaction.  
            ROLLBACK TRANSACTION;  
        ELSE  
            -- Transaction started before procedure  
            -- called, do not roll back modifications  
            -- made before the procedure was called.  
            IF XACT_STATE() <> -1  
                -- If the transaction is still valid, just  
                -- roll back to the savepoint set at the  
                -- start of the stored procedure.  
                ROLLBACK TRANSACTION ProcedureSave;  
                -- If the transaction is uncommitable, a  
                -- rollback to the savepoint is not allowed  
                -- because the savepoint rollback writes to  
                -- the log. Just return to the caller, which  
                -- should roll back the outer transaction.  
  
        -- After the appropriate rollback, echo error  
        -- information to the caller.  
        DECLARE @ErrorMessage NVARCHAR(4000);  
        DECLARE @ErrorSeverity INT;  
        DECLARE @ErrorState INT;  
  
        SELECT @ErrorMessage = ERROR_MESSAGE();  
        SELECT @ErrorSeverity = ERROR_SEVERITY();  
        SELECT @ErrorState = ERROR_STATE();  
  
        RAISERROR (@ErrorMessage, -- Message text.  
                   @ErrorSeverity, -- Severity.  
                   @ErrorState -- State.  
                   );  
    END CATCH  
GO

Lihat Juga

BEGIN TRANSACTION (Transact-SQL)
TRANSAKSI PENERAPAN (T-SQL)
COMMIT WORK (Transact-SQL)
ERROR_LINE (T-SQL)
ERROR_MESSAGE (T-SQL)
ERROR_NUMBER (T-SQL)
ERROR_PROCEDURE (T-SQL)
ERROR_SEVERITY (T-SQL)
ERROR_STATE (T-SQL)
RAISERROR (Transact-SQL)
TRANSAKSI ROLLBACK (Transact-SQL)
ROLLBACK WORK (Transact-SQL)
MENCOBA... CATCH (Transact-SQL)
XACT_STATE (T-SQL)