This invention relates to a computing apparatus and method for managing a database. More specifically, it relates to an apparatus and method for assuring atomicity of.multi-row update operations such as in a relational database system.

In prior art data management systems, support is sometimes provided for assuring the automicity of operations effecting a database. Such an-operation is "atomic" if the operation either succeeds completely or it fails, in which latter case the state of the database is left unchanged.

The IBM Information Management System (IMS/VS) Version 1 (IBM is a registered trademark) provides support for assuring the atomicity of operations updating one record, or row of a table, at a time. However, there is no multi-row update facility in IMS/VS.

Database management systems which provide multirow updating operations include those based upon the relational mode, such as the IBM Research System R, an experimental database management system, and the IBM Sequel Query Language/Data System (SQL/DS). System R is described in M. W. Blasgen, et al, "System R:An Architectural Overview", IBM System Journal, Vol. 20, No. 1, 1981, pages 41-62. The IBM SQL/DS is described in "SQL/Data System Planning and Administration", IBM Publication SH4-5014-0, Program Number 5748-XXJ, Aug. 81, with the recovery considerations set forth at pages 9-1 to 9-19. Hereafter, reference to relational databases will be intended to include all database management models which allow multi-row update operations.

The SQL language, which is the external language for access to databases managed by System R or SQL/DS, provides operations for modifying the state of user- defined data, including UPDATE, DELETE, and INSERT operations which allow the SQL user to insert, update, or delete multiple rows (i.e., records) in a specified database table. As implemented in System R and SQL/DS, SQL allows partial success of such multi-row operations, such that a detected error in the middle of a multi-row UPDATE, for example, will cause termination of the operation with only a subset of the required records updated. This leaves the table in an inconsistent state, and the application program requesting the SQL operation has no practical means of determining exactly which records were or were not updated. If recoverable files are used, a rollback, or recovery operation must be performed when such an error is detected to cause all work within the entire unit of recovery (UR), i.e. transaction, to be undone. Unfortunately, this action not only cancels the effects of the operation causing the error, but also the effects of any other operation in the same unit of recovery. The problem is more serious if non-recoverable files are in use. In such a case the rollback process has no offoct, and the applciation programmer must handle the recovery of the data.

Various proposals have been made to avoid the necessity for backing out a complete transaction in the event of an error during a sequence of multi-row update operations. Thus, it has been suggested to "begin each complex operation with a savepoint and backing up to this savepoint" in the event of a failure during the operation. See, for example, Grey, et al, "The Recovery Manager of a Data Management System,, IBM Research Publication, Computer Science RJ 2623 (#33801), August 15, 1979. (See also, ACM Computing Surveys, Vol 13, No. 2, June 1981, pages 223-242.) Grey, in this discussion of the System R, notes that such a savepoint technique was not implemented, but was rather an unsolved language design problem.

The present invention is defined in the attached claims.

This invention provides a method and apparatus for assuring atomicity of user requested multi-row update operations to tables such as in a relational database, guaranteeing that for any update operation that succeeds all stated effects will have occurred and that for. any update operation that fails the system state as perceived by the user remains unchanged. This is accomplished by establishing, in response to a multi-row update operation request, an execution module containing machine language code instructions implementing the update operation request with a savepoint request at the beginning of the execution module. For each set of instructions in or called by the execution module which modifies the user perceived system state, undo information is logged selectively to a hard or soft log. Upon completing the execution module without error, the savepoint is dropped, causing all soft log information recorded since the savepoint to be deleted and releasing all resources held to guarantee restoration of the user perceived system state at the time of the savepoint request. Responsive to the detection of an error during execution of the module, the logged undo information is used to restore the user perceived state to that existing at the time of the savepoint request.

The invention will now be described with reference to the accompanying drawings.

• Figure 1 is a diagrammatic illustration of a database management system including a relational data system, a data manager, and hard and soft logs.
• Figure 2 is a diagrammatic illustration of a typical unit of recovery, distinguishing recovery and restore operations.
• Figure 3 is a diagram illustrating a typical SQL statement.
• Figure 4 is a diagrammatic illustration of various control blocks and data areas comprising the apparatus of the invention and referenced in executing the method of the invention.
• Figure 5 is a flow chart illustrating the procedures executed by an execution module implementing an INSERT operation.
• Figure 6 is a flow chart illustrating the procedures executed by an execution module implementing an UPDATE or DELETE operation.
• Figure 7 is a flow chart illustrating the savepoint operation shown in Figures 5 and 6.
• Figure 8 is a flow chart illustrating the restore operation shown in Figures 5 and 6.

Referring first to Figure 1, a high level storage map is shown illustrating, for example, two private address spaces in an IBM System/370 Multiple Virtual System implementing a database management system (DBMS) 10. The IBM System/370 architecture is described in IBM System/370 Principles of Operation, IBM Publication G_A22-7000-6. In this embodiment, by way of example, DBMS 10 includes a master (MST) region 12 and a database manager (DBM) region 14. Hard log 22 is maintained under control of MST 12 as is described in EP patent applications of E. Jenner, "Method and Apparatus for Restarting a Computer System", number , and of C. Mellow, et al, "Method and Apparatus for Logging Journal Data in a Computing Apparatus", number , applicants reference numbers SA981047 and SA981048, respectively.

Database manager 14 includes a relational data system (RDS) 16 and a data manager (DM) 17 which together manage the creation, modification, access, and deletion of data objects stored in database 24. Such operations may be performed in response to calls from applications or tasks running in allied address spaces (not shown). One approach to establishing connection between such allied address spaces and the facilities provided by DBMS 10 is described in R. Reinsch, "Method and Apparatus for Controlling Intersubsystem Access to Computing ·Functions and Data", EP patent application number , applicant's reference number SA981052.

The manner in which RDS 16 performs its functions is set forth in further detail in M. W. Blasgen, et al, "System R: An Architectural Overview", IBM System Journal, Vol. 20, No. 1, 1981, supra, and in D. J. Haderle, et al "Method and Apparatus for Online Definition of Database Descriptors", EP patent application number , applicant's reference number SA981050.

In Figure 3 is set forth a typical SQL statement or request 36, illustrating a command field 50, showing that an UPDATE is to be made to the file named EMPLOYEE, an operation field 52, showing that the SALARY field is to be incremented by 10%, and the selection criteria field 54, showing that the salary field is to be updated for those employees in department M10. The selection field 54 includes one or more predicates, a term which will be further described hereafter.

RDS 16 processes a SQL statement received from an application running in an allied address space into control blocks necessary to invoke the data manager 17 component within DBM 14 and into an execution module. Each execution module comprises a set of machine language instructions which implement the SQL statement being processed. The execution module will include calls to a defined set of protocols in data manager 17 for retrieving and modifying the data in database 24. (This set of protocols is referenced as MSI).

Referring now to Figure 4, a description will be given of various control blocks passed to the DBM 14 data manager from an execution module for data manipulation operations, including SQL INSERT, UPDATE, DELETE oporations. Illustrated in Eiqure 4 are manipulative system input block (MSIB) 60, manipulative system input field (MSIFLD) 70, manipulative system selection block (MSISELI.) 80, cursor block (CUB) 90, and pageset 100. MSIB 60 is the main anchor control block, and includes pointer 62 to CUB 90, pointer 64 to MSISELL 80, and pointer 66 to MSIFLD 70. CUB 90 contains information which identifies the position of the scan in the page set 100. This information includes, among other things, a code which identifies the type of cursor block, pageset 100 identifier 92, and RID number 94 which identifies the RID slot 112 of RIDs 100 which contains a pointer into page 102 to the record 106 to which the scan is positioned. MSISELL 80 specifies "sargable" predicates. Sargable predicates are predicates which have meaning to the data manager component of DBM 14. Non-sargable predicates are predicates which the data manager component cannot handle, and must be checked by RDS 16. MSISELL 80 includes the identifier of the field to which the predicate applies; the operation code of a comparison operator (greater than, less than, equal or greater than, equal or less than, not equal); a pointer to the value to be compared; and any boolean connectors, such as AND, OR. Each MSISELL 80 is used to specify one predicate. Multiple predicates are specified by using a plurality of MSISELLs and the boolean connector field. MSIFLD 70 specifies fields for which values are returned or supplied, and includes the identifier of the field; the field data type; the field length; and a pointer to related buffers 76, 78.

Referring now to Figure 2; a transaction comprising a plurality of SQL statements 33, 34, 36, and 40 is illustrated as a unit of recovery 30. A unit of recovery (UR) is the work done by a process which affects the state of one or more recoverable resources 24 from one point of consistency to another. The scope of a UR may include multiple execution modules. The UR 30 of Figure 2 includes the execution modules which implement SQL statements 33, 34, 36, and 40. The start of the UR is at 32, the beginning of INSERT statement 33, and extends in time to a point beyond the current SQL DELETE statement 38, which begins at point 40. Assume that an error occurs at 42, during execution of a multi-row DELETE operation 38, which is not a system crash or some other loss of volatile storage (including soft log 20). By this invention, a restore operation is provided which restores the database to its point at the beginning 40 of the current SQL statement 40, without impacting changes made within this same UR 30 by, say, SQL UPDATE statement 36. Without this invention, a recovery operation 46 utilizing hard log 22, such as is described in the copending Jenner application, would be necessary. (If the error results in loss of soft log 20, then the recovery operation of Jenner would still be available to recover the database to its state at start UR 32. )

Thus, in performing the procedures of this invention, DM 17 utilizes soft log 20 in main storage and the hard log on DASD 22. Each time a change is made to a data object in a database 24, DM 17 writes or stores a record or records in the hard or soft log. Hard log 22 is used if the pageset is recoverable and if the page containing the update may have been copied to DASD 24. The pageset is considered to be recoverable if the effects of committed changes are guaranteed to survive system failures by DBMS 10. Soft log 20 is used if the pageset is not recoverable or if the page is guaranteed not to have been copied to DASD 24. Each record on hard log 22 representing a change to database 24 includes the following three fields: (1) hard log header, (2) data manager log header, and (3) appendage. The hard log header includes a field specifying the log record type and a field containing a pointer to the previous hard log record. The data manager log header includes the following four fields:

• 1. A pageset identifier field which identifies the pageset to which the change is made. In this example, a pageset is a set of one to 32 data sets which are logically concatenated to form a linear address space of up to 2^**32 bytes. A data set is a specific portion of DASD storage 24 which is read from and written to via the MVS operating system.
• 2. A page identifier field which identifies the page in the pageset being changed. In this example, a page is a 4096 or 32768 byte contiguous area in a pageset which begins on a 4096 or 32768 byte boundary.
• 3. A field identifying the DBM _'14 data manager 17 procedure which is making the change.
• 4. A flag indicating whether the hard log record contains UNDO, REDO or UNDO/REDO information. UNDO information is that information required to reverse an update operation in order that it appear that the operation was never performed. REDO information is that information required to re-perform an update operation.

The appendage format depends upon the type of modification. In some cases the appendage will contain before and after images of the data object being changed, , and in other cases the appendage will contain information necessary to conduct a reversing operation.

Each time a change is made to a data object in a non-recoverable database 24 and each time a savepoint is established, DM17 stores a soft log record in soft log 20. A soft log 20 record includes the following:

• 1.. A soft log record header, which includes (a) a pointer to the previous soft log 20 record, (b) the length of this log record, and (c) an operation code identifying the log record type.
• 2. An appendage whose format depends on the log record type.

If the log record is for a data change then the appendage will contain UNDO information. If the log record describes a savepoint, then the appendage will contain the following: .

• 1. A user supplied savepoint name.
• 2. A pointer to the previous savepoint soft log 20 record.
• 3. The relative byte address (RBA) of the first hard log 22 record written by the savepoint module writing this soft log record.
• 4. A list of entries describing cursor blocks (CUBs) whose positions are to be saved, including (a) the record identifier (RID) contained the CUB and (b) the position of the CUB (i.e. CUB position WRT record: before, at, after). A cursor block (CUB) is a DM 17 control block used to maintain position on a row or record in a database. Each CUB represents, among other things, positions within data manager objects such as indexes and page sets 100.

Now, by way of explanation of the operation of the above control blocks and modules, the atomicity protocol of the invention is implemented using a savepoint/restore mechanism provided by the data manager component of DBM 14. These two operations enable any user of the data manager to return the state of database 24 to a predefined point 40 (a 'savepoint) within UR 30, negating any effects of any modifications which occurred after that point 40.

Each execution module which implements a SQL multi- row UPDATE, INSERT, or DELETE utilizes the savepoint and restore operations to guarantee atomicity. These execution modules are set forth in Figures 5 and 6. The execution module for update/delete of Figure 6 is also set forth in pseudo code in Table 3. At the beginning of the execution module, before any database 24 change is made, a savepoint command 150 (see also Figure 7) is issued to the data manager component of DBM 14. As input to this operation, a name, unique within the UR 30, is passed which identifies the savepoint 150 (for the example of Fig. 2, this would be point 40, at the start of the current SQL statement 38), and a list of cursor blocks 90 whose states are to be saved. Table 4 sets forth the create savepoint procedure in pseudo code.

If an error 160 (42) is detected by the execution module (Figures 5 or 6), then a restore-162 is issued (as is illustrated in Figure 8) in which the name specified on the savepoint operation 150 is passed as a parameter. Restore 162 returns the state of all user and system data to what it was at the point 40 at which the savepoint 150 was issued, according to the method set forth in Figure 8 and Table 5, including the steps of getting 190 the soft log 20 savepoint 150 record; getting 192 from the soft log record the RBA of the hard log 22 savepoint 150 record; processing 194 hard log 22 UNDO records from failure 42, 160 back to the savepoint 150 RBA 40; and setting 196 CUBs 90 RDI 94 values to the positions which existed at the savepoint 40, 150.

All execution modules which implement SQL operations which change the state of database 24 use the savepoint 150 and restore 162 operations to insure atomicity. Other SQL operations which are interpreted (such as definitional and authorization statements) rather than having compiled code generated utilize the same approach. That is, a savepoint 150 is issued before any database 24 change is made and a restore 162 is issued if an error is detected after any such database change. The net effect of this implementation is that the SQL user perceives all operations to be atomic, either succeeding completely or leaving database 24 unchanged.

Thus, soft log 20 is created in volatile storage for each unit of recovery and is managed on a last-in first- out (LIFO) basis. When the data manager 17 component of DBM 14 is required to make any change to a CUB 90 or to a non-recoverable data page or to a recoverable page which is guaranteed not to have been copied to DASD 24, it inserts a record into the soft log 20 for the unit of recovery (UR) requesting the change. This record contains precisely the information required to undo the effects of the modification to the CUB 90 or data page 102. The name of the module to be invoked to accomplish the undo operation is also specified in the soft log 20 record. The hard log 22 is used to record both UNDO and REDO information for changes made to data pages 102 which may have been copied to DASD 24 and REDO only information for pages which are guaranteed not to have been copied to DASD.

If an execution module (Figure 5 or 6) in a UR 30 issues a savepoint 150 command then a special record with the specified savepoint name is inserted into both soft log 20 and hard log 22. If a restore 162 is issued then the UNDO records are read and removed from both logs 20, 22 in LIFO order 44, and the described operations performed until the savepoint 150 record containing the name specified on the restore 162 is found.

It is alr;o possible for multiple savopoints 150 to be stacked by a UR 30. Consider, for example, a UR which has issued two savepoint 150 commands with no restore 162 command between them. The contents of the soft log 20 would appear as in Table 1: Stacked Savepoints.

At this point, the UR could issue RESTORE SP2, which would back out all changes to the database 24 made since savepoint SP2. The soft log 20 would then contain the information set forth in Table 2: Stacked Savepoints With Restore.

If, however, RESTORE SP1 was issued, then all records of soft log 20 are processed and deleted.

In order to enhance the efficiency of the UNDO process, the data manager component of DBM 14 may adopt the strategy that each soft log 20 record describes a change to a single page 102 of storage and that this change can be applied using only information contained in the page 102 and the log 20,22 record. Thus, no other pages, directories, or catalogs need to be accessed to accomplish UNDO.

The data manager component of DBM 14 simplifies the atomicity protocol of the invention by providing an operator which allows other components to write records in soft log 20 or in hard log 22. Thus, modifications to resources managed by other components can be backed out with this mechanism. The data manager,component of DBM 14 also uses soft log 20 and hard log 22 to guarantee the atomicity of its own operations. Thus, any component using the data manager component of DBM 14 need not be concerned with the consistency of data 24 between calls.

Soft log 20 is the critical component for this preferred embodiment of the atomicity protocol of the invention because it provides a centralized mechanism for managing the information required to undo changes to user and system data.