# Patent

## Title
Methods and systems for providing fault recovery to side effects occurring during data processing

## Abstract

Embodiments may recover from faults by forming a new set of rows by removing rows associated with faulting save operations and repeating the saving and forming operations using the new set of rows until a set of rows that can be saved from the known start state without fault is determined. When the subset of successful rows is found, embodiments are able to provide assurance that no side effects (i.e., code or operations triggered by saving of a data to a particular location) have been executed on behalf of any of the failed rows (side effects from custom PL/SOQL code included) by deferring execution of triggers until an entire set of rows can be saved and committed.

## Background
CROSS REFERENCE TO RELATED APPLICATIONS
This application claims the benefit of U.S. Provisional Patent Application 60/849,693 entitled METHOD FOR IMPLEMENTING BOTH BULK AND ROW BASED SAVE LOGIC IN AN OBJECT RELATIONAL MAPPING LAYER AND APPLICATION FRAMEWORK, by Craig Weissman et al., filed Oct. 4, 2006, the entire contents of which are incorporated herein by reference.
U.S. patent application Ser. No. 11/678,477 entitled METHODS AND SYSTEMS FOR BULK ROW SAVE LOGIC IN AN OBJECT RELATIONAL MAPPING LAYER AND APPLICATION FRAMEWORK, by Craig Weissman et al., filed on even date herewith is related to the present application, and is hereby incorporated by reference in its entirety.


COPYRIGHT NOTICE
A portion of the disclosure of this patent document contains material which is subject to copyright protection. The copyright owner has no objection to the facsimile reproduction by anyone of the patent document or the patent disclosure, as it appears in the Patent and Trademark Office patent file or records, but otherwise reserves all copyright rights whatsoever.
FIELD OF THE INVENTION
The current invention relates generally to bulk save mechanisms in a database network system.
BACKGROUND
The subject matter discussed in the background section should not be assumed to be prior art merely as a result of its mention in the background section. Similarly, a problem mentioned in the background section or associated with the subject matter of the background section should not be assumed to have been previously recognized in the prior art. The subject matter in the background section merely represents different approaches, which in and of themselves may also be inventions.
In conventional database systems, users access their data resources in one logical database. A user of such a conventional system typically retrieves data from and stores data on the system using the user's own systems. A user system might remotely access one of a plurality of server systems that might in turn access the database system. Data retrieval from the system might include the issuance of a query from the user system to the database system. The database system might process the request for information received in the query and send to the user system information relevant to the request. During this process, data may be transformed through various formats and protocols in the various tiers of the system: from XML or HTML text to Java Objects to relational data structures and back again. In particular the latter transition is known in the industry as the O/R (object/relational) boundary and is the subject of much developer headache and 3rd party development tool support (because the representation one uses typically in a procedural language like Java, for a complex object, is typically quite different from the optimal manner in which that data is stored and indexed in a relational database (which is the dominant location for enterprise data of this sort)).
Unfortunately, conventional 3rd party approaches to lower-level O/R processing do not support save operations performed in bulk, becoming inefficient if, for example, the number of items to be saved to the database system is relatively high.
Accordingly, it is desirable to provide techniques enabling an API of the database system to improve performance and provide greater robustness of the database system.
BRIEF SUMMARY
In accordance with embodiments, there are provided mechanisms and methods for saving multiple rows together through an object relational mapping layer to a database. These mechanisms and methods for saving multiple rows together can enable embodiments to detect faults in the save operation(s) and recover. The ability of embodiments to detect faults in the save operation(s) and recover can enable embodiments to provide a robust forgiving published API that saves a set of rows together whenever possible.
In an embodiment and by way of example, a method for saving multiple rows together through an object relational mapping layer to a database is provided. The method embodiment includes receiving, at an API in a known start state, a set of rows to save together. The set of rows is saved together until each row in the set of rows has been saved. A new set of rows is formed from the set of rows by removing rows associated with faulting during saving. The saving and forming can be repeated using the new set of rows until a set of rows that can be saved from the known start state without fault is determined. When a set of rows that can be saved from the known start state without fault is determined, then the set of rows may be committed.
In another embodiment and again by way of example, a method for providing fault recovery to side effects occurring during data processing is provided. The method embodiment includes detecting a fault in processing a set of rows of a database. At least one of the set of rows includes at least one side effect. Each of the set of rows processed can be rolled back and processing retried on a subset of the set of rows in which rows associated with faults have been removed until a subset of the set of rows in which each row of the subset of rows is able to be processed. The subset of rows may be processed to the database and the at least one side effect executed, thereby ensuring that no side effects have occurred from executing code on behalf of any rows associated with a fault.
While the present invention is described with reference to an embodiment in which techniques for saving multiple rows together are implemented in a system having an application server providing a front end for an on-demand database service capable of supporting multiple tenants, the present invention is not limited to multi-tenant databases nor deployment on application servers. Embodiments may be practiced using other database architectures, i.e., ORACLE®, DB2® by IBM and the like without departing from the scope of the embodiments claimed.
Any of the above embodiments may be used alone or together with one another in any combination. Inventions encompassed within this specification may also include embodiments that are only partially mentioned or alluded to or are not mentioned or alluded to at all in this brief summary or in the abstract. Although various embodiments of the invention may have been motivated by various deficiencies with the prior art, which may be discussed or alluded to in one or more places in the specification, the embodiments of the invention do not necessarily address any of these deficiencies. In other words, different embodiments of the invention may address different deficiencies that may be discussed in the specification. Some embodiments may only partially address some deficiencies or just one deficiency that may be discussed in the specification, and some embodiments may not address any of these deficiencies.



BRIEF DESCRIPTION OF THE DRAWINGS
In the following drawings like reference numbers are used to refer to like elements. Although the following figures depict various examples of the invention, the invention is not limited to the examples depicted in the figures.
FIG. 1 illustrates a block diagram of an example of an environment wherein an on-demand database service might be used;
FIG. 2 illustrates a block diagram of an embodiment of elements of FIG. 1 and various possible interconnections between these elements;
FIG. 3A illustrates an operational flow diagram of a high level overview of a technique for saving multiple rows together in an embodiment;
FIG. 3B illustrates an operational flow diagram of a high level overview of a technique for providing fault recovery to side effects occurring during data processing in an embodiment; and
FIGS. 4A-4B illustrate block diagrams of an example of a technique for saving multiple rows together in an embodiment.



DETAILED DESCRIPTION
General Overview
Systems and methods are provided for saving multiple rows together through an object relational mapping layer to a database. Saving multiple rows together can enable embodiments to detect faults in the save operation(s) and recover. Embodiments may recover from faults by forming a new set of rows by removing rows associated with faulting save operations and repeating the saving and forming operations using the new set of rows until a set of rows that can be saved from the known start state without fault is determined. When the subset of successful rows is found, embodiments are able to provide assurance that no side effects (i.e., code or operations triggered by saving of a data to a particular location) have been executed on behalf of any of the failed rows (side effects from custom PL/SOQL code included) by deferring execution of triggers until an entire set of rows can be saved and committed.
When a rollback of save operations occurs responsive to a fault detected in one or more save operations, a whole service notion of rollback—including rollback of governor limits (i.e., limits placed on resource usage)—can be performed. Rollback of an entire service provides a simple and easy to understand programming model to the user because users do not need to worry about the retry logic itself using up resource limits in unpredictable ways.
Embodiments process data from clients using a bulk array for efficiency and speed, including techniques in multiple programming environments and languages. As an example, a client-side Simple Object Access Protocol (SOAP) API embodiment saves can be specified as arrays of objects to encourage efficient use of Internet round trips.
As used herein, the term multi-tenant database system refers to those systems in which various elements of hardware and software of the database system may be shared by one or more customers. For example, a given application server may simultaneously process requests for a great number of customers, and a given database table may store rows for a potentially much greater number of customers. As used herein, the term query plan refers to a set of steps used to access information in a database system.
Next, mechanisms and methods for saving multiple rows together through an object relational mapping layer to a database will be described with reference to example embodiments.
System Overview
FIG. 1 illustrates a block diagram of an environment 10 wherein an on-demand database service might be used. Environment 10 may include user systems 12, network 14, system 16, processor system 17, application platform 18, network interface 20, tenant data storage 22, system data storage 24, program code 26, and process space 28. In other embodiments, environment 10 may not have all of the components listed and/or may have other elements instead of, or in addition to, those listed above.
Environment 10 is an environment in which an on-demand database service exists. User system 12 may be any machine or system that is used by a user to access a database user system. For example, any of user systems 12 can be a handheld computing device, a mobile phone, a laptop computer, a work station, and/or a network of computing devices. As illustrated in FIG. 1 (and in more detail in FIG. 2) user systems 12 might interact via a network 14 with an on-demand database service, which is system 16.
An on-demand database service, such as system 16, is a database system that is made available to outside users that do not need to necessarily be concerned with building and/or maintaining the database system, but instead may be available for their use when the users need the database system (e.g., on the demand of the users). Some on-demand database services may store information from one or more tenants stored into tables of a common database image to form a multi-tenant database system (MTS). Accordingly, “on-demand database service 16” and “system 16” will be used interchangeably herein. A database image may include one or more database objects. A relational database management system (RDMS) or the equivalent may execute storage and retrieval of information against the database object(s). Application platform 18 may be a framework that allows the applications of system 16 to run, such as the hardware and/or software, e.g., the operating system. In an embodiment, on-demand database service 16 may include an application platform 18 that enables creation, managing and executing one or more applications developed by the provider of the on-demand database service, users accessing the on-demand database service via user systems 12, or third party application developers accessing the on-demand database service via user systems 12.
The users of user systems 12 may differ in their respective capacities, and the capacity of a particular user system 12 might be entirely determined by permissions (permission levels) for the current user. For example, where a salesperson is using a particular user system 12 to interact with system 16, that user system has the capacities allotted to that salesperson. However, while an administrator is using that user system to interact with system 16, that user system has the capacities allotted to that administrator. In systems with a hierarchical role model, users at one permission level may have access to applications, data, and database information accessible by a lower permission level user, but may not have access to certain applications, database information, and data accessible by a user at a higher permission level. Thus, different users will have different capabilities with regard to accessing and modifying application and database information, depending on a user's security or permission level.
Network 14 is any network or combination of networks of devices that communicate with one another. For example, network 14 can be any one or any combination of a LAN (local area network), WAN (wide area network), telephone network, wireless network, point-to-point network, star network, token ring network, hub network, or other appropriate configuration. As the most common type of computer network in current use is a TCP/IP (Transfer Control Protocol and Internet Protocol) network, such as the global internetwork of networks often referred to as the “Internet” with a capital “I,” that network will be used in many of the examples herein. However, it should be understood that the networks that the present invention might use are not so limited, although TCP/IP is a frequently implemented protocol.
User systems 12 might communicate with system 16 using TCP/IP and, at a higher network level, use other common Internet protocols to communicate, such as HTTP, FTP, AFS, WAP, etc. In an example where HTTP is used, user system 12 might include an HTTP client commonly referred to as a “browser” for sending and receiving HTTP messages to and from an HTTP server at system 16. Such an HTTP server might be implemented as the sole network interface between system 16 and network 14, but other techniques might be used as well or instead. In some implementations, the interface between system 16 and network 14 includes load sharing functionality, such as round-robin HTTP request distributors to balance loads and distribute incoming HTTP requests evenly over a plurality of servers. At least as for the users that are accessing that server, each of the plurality of servers has access to the MTS' data; however, other alternative configurations may be used instead.
In one embodiment, system 16, shown in FIG. 1, implements a web-based customer relationship management (CRM) system. For example, in one embodiment, system 16 includes application servers configured to implement and execute CRM software applications as well as provide related data, code, forms, webpages and other information to and from user systems 12 and to store to, and retrieve from, a database system related data, objects, and Webpage content. With a multi-tenant system, data for multiple tenants may be stored in the same physical database object, however, tenant data typically is arranged so that data of one tenant is kept logically separate from that of other tenants so that one tenant does not have access to another tenant's data, unless such data is expressly shared. In certain embodiments, system 16 implements applications other than, or in addition to, a CRM application. For example, system 16 may provide tenant access to multiple hosted (standard and custom) applications, including a CRM application. User (or third party developer) applications, which may or may not include CRM, may be supported by the application platform 18, which manages creation, storage of the applications into one or more database objects and executing of the applications in a virtual machine in the process space of the system 16.
One arrangement for elements of system 16 is shown in FIG. 1, including a network interface 20, application platform 18, tenant data storage 22 for tenant data 23, system data storage 24 for system data 25 accessible to system 16 and possibly multiple tenants, program code 26 for implementing various functions of system 16, and a process space 28 for executing MTS system processes and tenant-specific processes, such as running applications as part of an application hosting service. Additional processes that may execute on system 16 include database indexing processes.
Several elements in the system shown in FIG. 1 include conventional, well-known elements that are explained only briefly here. For example, each user system 12 could include a desktop personal computer, workstation, laptop, PDA, cell phone, or any wireless access protocol (WAP) enabled device or any other computing device capable of interfacing directly or indirectly to the Internet or other network connection. User system 12 typically runs an HTTP client, e.g., a browsing program, such as Microsoft's Internet Explorer browser, Netscape's Navigator browser, Opera's browser, or a WAP-enabled browser in the case of a cell phone, PDA or other wireless device, or the like, allowing a user (e.g., subscriber of the multi-tenant database system) of user system 12 to access, process and view information, pages and applications available to it from system 16 over network 14. Each user system 12 also typically includes one or more user interface devices, such as a keyboard, a mouse, trackball, touch pad, touch screen, pen or the like, for interacting with a graphical user interface (GUI) provided by the browser on a display (e.g., a monitor screen, LCD display, etc.) in conjunction with pages, forms, applications and other information provided by system 16 or other systems or servers. For example, the user interface device can be used to access data and applications hosted by system 16, and to perform searches on stored data, and otherwise allow a user to interact with various GUI pages that may be presented to a user. As discussed above, embodiments are suitable for use with the Internet, which refers to a specific global internetwork of networks. However, it should be understood that other networks can be used instead of the Internet, such as an intranet, an extranet, a virtual private network (VPN), a non-TCP/IP based network, any LAN or WAN or the like.
According to one embodiment, each user system 12 and all of its components are operator configurable using applications, such as a browser, including computer code run using a central processing unit such as an Intel Pentium® processor or the like. Similarly, system 16 (and additional instances of an MTS, where more than one is present) and all of their components might be operator configurable using application(s) including computer code to run using a central processing unit such as processor system 17, which may include an Intel Pentium® processor or the like, and/or multiple processor units. A computer program product embodiment includes a machine-readable storage medium (media) having instructions stored thereon/in which can be used to program a computer to perform any of the processes of the embodiments described herein. Computer code for operating and configuring system 16 to intercommunicate and to process webpages, applications and other data and media content as described herein are preferably downloaded and stored on a hard disk, but the entire program code, or portions thereof, may also be stored in any other volatile or non-volatile memory medium or device as is well known, such as a ROM or RAM, or provided on any media capable of storing program code, such as any type of rotating media including floppy disks, optical discs, digital versatile disk (DVD), compact disk (CD), microdrive, and magneto-optical disks, and magnetic or optical cards, nanosystems (including molecular memory ICs), or any type of media or device suitable for storing instructions and/or data. Additionally, the entire program code, or portions thereof, may be transmitted and downloaded from a software source over a transmission medium, e.g., over the Internet, or from another server, as is well known, or transmitted over any other conventional network connection as is well known (e.g., extranet, VPN, LAN, etc.) using any communication medium and protocols (e.g., TCP/IP, HTTP, HTTPS, Ethernet, etc.) as are well known. It will also be appreciated that computer code for implementing embodiments of the present invention can be implemented in any programming language that can be executed on a client system and/or server or server system such as, for example, C, C++, HTML, any other markup language, JavaTM, JavaScript, ActiveX, any other scripting language, such as VBScript, and many other programming languages as are well known may be used. (JavaTM is a trademark of Sun Microsystems, Inc.).
According to one embodiment, each system 16 is configured to provide webpages, forms, applications, data and media content to user (client) systems 12 to support the access by user systems 12 as tenants of system 16. As such, system 16 provides security mechanisms to keep each tenant's data separate unless the data is shared. If more than one MTS is used, they may be located in close proximity to one another (e.g., in a server farm located in a single building or campus), or they may be distributed at locations remote from one another (e.g., one or more servers located in city A and one or more servers located in city B). As used herein, each MTS could include one or more logically and/or physically connected servers distributed locally or across one or more geographic locations. Additionally, the term “server” is meant to include a computer system, including processing hardware and process space(s), and an associated storage system and database application (e.g., OODBMS or RDBMS) as is well known in the art. It should also be understood that “server system” and “server” are often used interchangeably herein. Similarly, the database object described herein can be implemented as single databases, a distributed database, a collection of distributed databases, a database with redundant online or offline backups or other redundancies, etc., and might include a distributed database or storage network and associated processing intelligence.
FIG. 2 also illustrates environment 10. However, in FIG. 2 elements of system 16 and various interconnections in an embodiment are further illustrated. FIG. 2 shows that user system 12 may include processor system 12A, memory system 12B, input system 12C, and output system 12D. FIG. 2 shows network 14 and system 16. FIG. 2 also shows that system 16 may include tenant data storage 22, tenant data 23, system data storage 24, system data 25, User Interface (UI) 30, Application Program Interface (APT) 32, PL/SOQL 34, save routines 36, application setup mechanism 38, applications servers 1001-100N, system process space 102, tenant process spaces 104, tenant management process space 110, tenant storage area 112, user storage 114, and application metadata 116. In other embodiments, environment 10 may not have the same elements as those listed above and/or may have other elements instead of, or in addition to, those listed above.
User system 12, network 14, system 16, tenant data storage 22, and system data storage 24 were discussed above in FIG. 1. Regarding user system 12, processor system 12A may be any combination of one or more processors. Memory system 12B may be any combination of one or more memory devices, short term, and/or long term memory. Input system 12C may be any combination of input devices, such as one or more keyboards, mice, trackballs, scanners, cameras, and/or interfaces to networks. Output system 12D may be any combination of output devices, such as one or more monitors, printers, and/or interfaces to networks. As shown by FIG. 2, system 16 may include a network interface 20 (of FIG. 1) implemented as a set of HTTP application servers 100, an application platform 18, tenant data storage 22, and system data storage 24. Also shown is system process space 102, including individual tenant process spaces 104 and a tenant management process space 110. Each application server 100 may be configured to tenant data storage 22 and the tenant data 23 therein, and system data storage 24 and the system data 25 therein to serve requests of user systems 12. The tenant data 23 might be divided into individual tenant storage areas 112, which can be either a physical arrangement and/or a logical arrangement of data. Within each tenant storage area 112, user storage 114 and application metadata 116 might be similarly allocated for each user. For example, a copy of a user's most recently used (MRU) items might be stored to user storage 114. Similarly, a copy of MRU items for an entire organization that is a tenant might be stored to tenant storage area 112. A UI 30 provides a user interface and an API 32 provides an application programmer interface to system 16 resident processes to users and/or developers at user systems 12. The tenant data and the system data may be stored in various databases, such as one or more OracleTM databases.
Application platform 18 includes an application setup mechanism 38 that supports application developers' creation and management of applications, which may be saved as metadata into tenant data storage 22 by save routines 36 for execution by subscribers as one or more tenant process spaces 104 managed by tenant management process 110 for example. Invocations to such applications may be coded using PL/SOQL 34 that provides a programming language style interface extension to API 32. A detailed description of some PL/SOQL language embodiments is discussed in commonly owned U.S. Provisional Patent Application 60/828,192 entitled, PROGRAMMING LANGUAGE METHOD AND SYSTEM FOR EXTENDING APIS TO EXECUTE IN CONJUNCTION WITH DATABASE APIS, by Craig Weissman, filed Oct. 4, 2006, which is incorporated in its entirety herein for all purposes. Invocations to applications may be detected by one or more system processes, which manages retrieving application metadata 116 for the subscriber making the invocation and executing the metadata as an application in a virtual machine.
Each application server 100 may be communicably coupled to database systems, e.g., having access to system data 25 and tenant data 23, via a different network connection. For example, one application server 100, might be coupled via the network 14 (e.g., the Internet), another application server 100N-1 might be coupled via a direct network link, and another application server 100N might be coupled by yet a different network connection. Transfer Control Protocol and Internet Protocol (TCP/IP) are typical protocols for communicating between application servers 100 and the database system. However, it will be apparent to one skilled in the art that other transport protocols may be used to optimize the system depending on the network interconnect used.
In certain embodiments, each application server 100 is configured to handle requests for any user associated with any organization that is a tenant. Because it is desirable to be able to add and remove application servers from the server pool at any time for any reason, there is preferably no server affinity for a user and/or organization to a specific application server 100. In one embodiment, therefore, an interface system implementing a load balancing function (e.g., an F5 Big-EP load balancer) is communicably coupled between the application servers 100 and the user systems 12 to distribute requests to the application servers 100. In one embodiment, the load balancer uses a least connections algorithm to route user requests to the application servers 100. Other examples of load balancing algorithms, such as round robin and observed response time, also can be used. For example, in certain embodiments, three consecutive requests from the same user could hit three different application servers 100, and three requests from different users could hit the same application server 100. In this manner, system 16 is multi-tenant, wherein system 16 handles storage of, and access to, different objects, data and applications across disparate users and organizations.
As an example of storage, one tenant might be a company that employs a sales force where each salesperson uses system 16 to manage their sales process. Thus, a user might maintain contact data, leads data, customer follow-up data, performance data, goals and progress data, etc., all applicable to that user's personal sales process (e.g., in tenant data storage 22). In an example of a MTS arrangement, since all of the data and the applications to access, view, modify, report, transmit, calculate, etc., can be maintained and accessed by a user system having nothing more than network access, the user can manage his or her sales efforts and cycles from any of many different user systems. For example, if a salesperson is visiting a customer and the customer has Internet access in their lobby, the salesperson can obtain critical updates as to that customer while waiting for the customer to arrive in the lobby.
While each user's data might be separate from other users' data regardless of the employers of each user, some data might be organization-wide data shared or accessible by a plurality of users or all of the users for a given organization that is a tenant. Thus, there might be some data structures managed by system 16 that are allocated at the tenant level while other data structures might be managed at the user level. Because an MTS might support multiple tenants including possible competitors, the MTS should have security protocols that keep data, applications, and application use separate. Also, because many tenants may opt for access to an MTS rather than maintain their own system, redundancy, up-time, and backup are additional functions that may be implemented in the MTS. In addition to user-specific data and tenant-specific data, system 16 might also maintain system level data usable by multiple tenants or other data. Such system level data might include industry reports, news, postings, and the like that are sharable among tenants.
In certain embodiments, user systems 12 (which may be client systems) communicate with application servers 100 to request and update system-level and tenant-level data from system 16 that may require sending one or more queries to tenant data storage 22 and/or system data storage 24. System 16 (e.g., an application server 100 in system 16) automatically generates one or more SQL statements (e.g., one or more SQL queries) that are designed to access the desired information. System data storage 24 may generate query plans to access the requested data from the database.
Each database can generally be viewed as a collection of objects, such as a set of logical tables, containing data fitted into predefined categories. A “table” is one representation of a data object, and may be used herein to simplify the conceptual description of objects and custom objects according to the present invention. It should be understood that “table” and “object” may be used interchangeably herein. Each table generally contains one or more data categories logically arranged as columns or fields in a viewable schema. Each row or record of a table contains an instance of data for each category defined by the fields. For example, a CRM database may include a table that describes a customer with fields for basic contact information such as name, address, phone number, fax number, etc. Another table might describe a purchase order, including fields for information such as customer, product, sale price, date, etc. In some multi-tenant database systems, standard entity tables might be provided for use by all tenants. For CRM database applications, such standard entities might include tables for Account, Contact, Lead, and Opportunity data, each containing pre-defined fields. It should be understood that the word “entity” may also be used interchangeably herein with “object” and “table”.
In some multi-tenant database systems, tenants may be allowed to create and store custom objects, or they may be allowed to customize standard entities or objects, for example by creating custom fields for standard objects, including custom index fields. U.S. patent application Ser. No. 10/817,161, filed Apr. 2, 2004, entitled “CUSTOM ENTITIES AND FIELDS IN A MULTI-TENANT DATABASE SYSTEM”, and which is hereby incorporated herein by reference, teaches systems and methods for creating custom objects as well as customizing standard objects in a multi-tenant database system. In certain embodiments, for example, all custom entity data rows are stored in a single multi-tenant physical table, which may contain multiple logical tables per organization. It is transparent to customers that their multiple “tables” are in fact stored in one large table or that their data may be stored in the same table as the data of other customers.
The following detailed description will first describe a high level overview of a technique for saving multiple rows together in accordance with aspects and embodiments of the present invention. An example of detecting and recovering from failures in a save of multiple rows is then detailed. Following the example of detecting and recovering from failures, examples of some of the many types of operations that may be performed together in sets according to the techniques described herein are provided.
FIG. 3A illustrates an operational flow diagram of a high level overview of a technique for saving multiple rows together in an embodiment. In one embodiment, the technique for saving multiple rows together shown in FIG. 3A is operable with an implemented in the multi-tenant database system 16. As shown in FIG. 3A, a set of rows to save together is received (block 302) at an API in a known start state. For example and without limitation, this can include receiving information to save to a set of rows in a Simple Object Access Protocol (SOAP) transaction.
The set of rows is saved (block 304) together until each row in the set of rows has been saved. By way of example and without limitation, this can include recording fault information for any row associated with a save operation that faults. A new set of rows is formed (block 306) from the set of rows by removing rows associated with faulting during saving. In embodiments, this can include removing rows corresponding to faults from the set of rows to save together to form the new set of rows to save together.
The saving (block 304) and forming (block 306) can be repeated (block 308) using the new set of rows until a set of rows that can be saved from the known start state without fault is determined. This can include rolling back saving the set of rows to the known start state. Embodiments may roll back governor limits (i.e., resource limitations) placed upon code executing on behalf of rows that are being rolled back in order to prevent resource allocations from being used up by user's trying a procedure, detecting a failure and then rolling back the procedure in the user's code. A detailed description of governor limits in PL/SOQL language embodiments may be found in commonly owned U.S. Provisional Patent Application 60/828,757 entitled, PROGRAMMING LANGUAGE METHOD AND SYSTEM FOR EXTENDING APIS TO EXECUTE IN CONJUNCTION WITH DATABASE APIS, by Craig Weissman, filed Oct. 9, 2006, which is incorporated in its entirety herein for all purposes.
When a set of rows that can be saved from the known start state without fault is determined, then the set of rows may be committed (block 310). By executing side effects, such as code or operations execution is triggered by saving or other operations performed on data to certain rows, only after a set of rows is successfully saved and committed, the process of determining that a set of rows can be saved without incurring a fault enables embodiments to ensure that no side effects have occurred from executing code on behalf of any rows failing to be saved.
FIG. 3B is an operational flow diagram illustrating a high level overview of a technique for providing fault recovery to side effects occurring during data processing in an embodiment. A fault in processing a set of rows of a database is detected (block 312). At least one of the set of rows includes at least one side effect. For example and without limitation, this can include at least one of a pre-operation trigger, a post-operation trigger, or a code snippet. Each of the set of rows processed is rolled back (block 314) and processing is retried on a subset of the set of rows in which rows associated with faults have been removed until a subset of the set of rows in which each row of the subset of rows is able to be processed (block 316). By way of example and without limitation, this can include rolling back governor limits placed upon code executing on behalf of rows that are being rolled back. The subset of rows is processed (block 318) to the database and the at least one side effect is executed, thereby ensuring that no side effects have occurred from executing code on behalf of any rows associated with a fault. In embodiments, this can include updating resources used and checking against governor limits.
FIGS. 4A-4B illustrate block diagrams of an example of a technique for saving multiple rows together in an embodiment. In FIG. 4A, a set of rows 402-408 are to be saved together into a tenant data area 114 of database 22 of FIG. 2. Rows 402 and 408 have side effects associated with them, namely code snippet 402a is triggered to execute prior to saving row 402. Code snippet 402a could also be triggered after saving 402 or any other of a variety of trigger configurations. Similarly, row 408 includes a code snippet 408a that is triggered to execute prior to saving row 408. Again, other types of triggers could be used, but pre-saving triggers are selected for this example for illustrative purposes.
Again with reference to FIG. 4A, in an embodiment and by way of example, a first attempt to save rows 402-408 results in failure reports (“x”) being returned for row C 404 and row E 408. Because one or more failure reports have been received responsive to an attempted save operation, the save operations of rows 402-408 are rolled back to the starting state. Further, any side effects 402a, 408a that were permitted to execute are also rolled back. Additionally, any resource usage counted against governor limits by executing side effects 402a, , 408a is also rolled back.
Now with reference to FIG. 4B, a second attempt is made to find a block of rows that can be saved without receiving failure reports. As illustrated in FIG. 4B, row C 404 and row E 408 are removed from the set of rows that the system is attempting to save to the tenant data 114 of database 22 because row C 404 and row E 408 are associated with a prior failing save operation. Now a new set of rows, including row B 402 and row D 406 are saved to tenant data 114, resulting in good return codes (“ok”). Accordingly, the system will once again roll back the save, execute any code or operations associated with pre-save triggers corresponding to rows to be saved, such as snippet 402a, perform a save of the block of rows and then commit the saved rows. In the foregoing example, the process of determining that a set of rows can be saved without incurring a fault enables embodiments to ensure that no side effects have occurred from executing code on behalf of any rows failing to be saved.
Bulk processing techniques provided by embodiments described herein can extend to processing any of the following operations in bulk: (i) processing and packaging of the API messages themselves; (ii) internal object representation as a list of rows being operated upon; (iii) INSERT routines in PL/SQL; (iv) Lookup routines for de-duplicate matching when doing record updates; (v) UPDATE routines in PL/SQL for record changes; (vi) DELETE routines in PL/SQL; (vii) INSERT, UPDATE, DELETE routines include semantically complicated bookkeeping routines, all in bulk, such as: (a) MRU (most-recently used list) maintenance; (b) Row-level sharing maintenance; and (c) Entity store count maintenance; (viii) Reload of data after an update in preparation for performing post-save logic (known as workflow); and (ix) Workflow implementation itself, including the bulk queue and processing of tasks such as Email, child row creation, outbound SOAP messages, and the like. Each embodiment disclosed herein may be used or otherwise combined with any of the other embodiments disclosed. Any element of any embodiment may be used in any embodiment.
While the invention has been described by way of example and in terms of the specific embodiments, it is to be understood that the invention is not limited to the disclosed embodiments. To the contrary, it is intended to cover various modifications and similar arrangements as would be apparent to those skilled in the art. Therefore, the scope of the appended claims should be accorded the broadest interpretation so as to encompass all such modifications and similar arrangements.

## Claims

1. A computerized method comprising:
receiving a set of rows to be saved together as a set to a database;
performing a first saving operation, but not committing, wherein the first saving operation saves the set of rows to the database without committing the set of rows to the database;
detecting, by a computer interfaced with the database, a fault in performing the first saving operation to save the set of rows to the database;
rolling back, by the computer, the set of rows saved but not committed to the database during the first saving operation by rolling back resource allocations associated with performing the first saving operation on behalf of a user in order to prevent the resource allocations from being used up by the user's trying the first saving operation and the subsequent rolling back the set of rows saved but not committed to the database during the first saving operation;
forming a new subset of rows derived from the set of rows by removing one or more rows associated with the fault during the first saving operation;
performing a second saving operation, but not committing, wherein the second saving operation saves the new subset of rows to the database without committing the new set of rows to the database;
determining the new set of rows to be saved to the database without fault;
committing the new set of rows to the database responsive to determining the new set of rows to be saved to the database without fault; and
ensuring that no side effects have occurred from executing code on behalf of any rows associated with a fault including updating, by the computer, allocated resources used in the performing the first saving operation and checking the allocated resources used against governor limits.

2. The method of claim 1, wherein detecting the fault in performing the first saving operation includes:
detecting, by the computer, a fault in processing the set of rows with the database, wherein at least one of the rows associated with the fault includes at least one of a pre-operation trigger, a post-operation trigger, or a code snippet.

3. A non-transitory machine-readable storage medium having instructions stored thereon that, when executed by one or more processors, cause the one or more processors to perform operations comprising:
receiving a set of rows to be saved together as a set to a database;
performing a first saving operation, but not committing, wherein the first saving operation saves the set of rows to the database without committing the set of rows to the database;
detecting a fault in performing the first saving operation to save the set of rows to the database;
rolling back the set of rows saved but not committed to the database during the first saving operation by rolling back resource allocations associated with performing the first saving operation on behalf of a user in order to prevent the resource allocations from being used UP by the user's trying the first saving operation and the subsequent rolling back the set of rows saved but not committed to the database during the first saving operation;
forming a new subset of rows derived from the set of rows by removing one or more rows associated with the fault during the first saving operation;
performing a second saving operation, but not committing, wherein the second saving operation saves the new subset of rows to the database without committing the new set of rows to the database;
determining the new set of rows to be saved to the database without fault;
committing the new set of rows to the database responsive to determining the new set of rows to be saved to the database without fault; and
ensuring that no side effects have occurred from executing code on behalf of any rows associated with a fault including updating allocated resources used in the performing the first saving operation and checking the allocated resources used against the governor limits.

4. The non-transitory machine-readable storage medium as recited in claim 3, wherein detecting the fault in performing the first saving operation includes:
detecting a fault in processing the set of rows with the database, wherein at least one of the rows associated with the fault includes at least one of a pre-operation trigger, a post-operation trigger, or a code snippet.

5. An apparatus comprising:
a processor; and
one or more stored sequences of instructions which, when executed by the processor, cause the processor to carry out the steps of:
receiving a set of rows to be saved together as a set to a database;
performing a first saving operation, but not committing, wherein the first saving operation saves the set of rows to the database without committing the set of rows to the database;
detecting a fault in performing the first saving operation to save the set of rows to the database;
rolling back the set of rows saved but not committed to the database during the first saving operation by rolling back resource allocations associated with performing the first saving operation on behalf of a user in order to prevent the resource allocations from being used UP by the user's trying the first saving operation and the subsequent rolling back the set of rows saved but not committed to the database during the first saving operation;
forming a new subset of rows derived from the set of rows by removing one or more rows associated with the fault during the first saving operation;
performing a second saving operation, but not committing, wherein the second saving operation saves the new subset of rows to the database without committing the new set of rows to the database;
determining the new set of rows to be saved to the database without fault;
committing the new set of rows to the database responsive to determining the new set of rows to can be saved to the database without fault; and
ensuring that no side effects have occurred from executing code on behalf of any rows associated with a fault including updating allocated resources used in the performing the first saving operation and checking the allocated resources used against governor limits.

6. The apparatus of claim 5, wherein detecting the fault in performing the first saving operation includes:
the one or more stored sequences having further instructions for detecting a fault in processing the set of rows with the database, wherein at least one of the rows associated with the fault includes at least one of a pre-operation trigger, a post-operation trigger, or a code snippet.

7. A computerized method comprising:
transmitting by a computer code to receive a set of rows to be saved together as a set to a database;
transmitting by a computer code to perform a first saving operation, but not committing, wherein the first saving operation saves the set of rows to the database without committing the set of rows to the database;
transmitting by a computer code to detect a fault in performing the first saving operation to save the set of rows to the database;
transmitting by a computer code to roll back the set of rows saved but not committed to the database during the first saving operation by rolling back resource allocations associated with performing the first saving operation on behalf of a user in order to prevent the resource allocations from being used UP by the user's trying the first saving operation and the subsequent rolling back the set of rows saved but not committed to the database during the first saving operation;
transmitting by a computer code to form a new subset of rows derived from the set of rows by removing one or more rows associated with the fault during the first saving operation;
transmitting by a computer code to perform a second saving operation, but not committing, wherein the second saving operation saves the new subset of rows to the database without committing the new set of rows to the database;
transmitting by a computer code to determine the new set of rows to be saved to the database without fault;
transmitting by a computer code to commit the new set of rows to the database responsive to determining the new set of rows to be saved to the database without fault; and
transmitting by a computer code to ensure that no side effects have occurred from executing code on behalf of any rows associated with a fault including updating allocated resources used in the performing the first saving operation and checking the allocated resources used against governor limits.

8. The computerized method of claim 7, wherein the code to detect the fault in performing the first saving operation includes:
transmitting by a computer code to detect a fault in processing the set of rows with the database, wherein at least one of the rows associated with the fault includes at least one of a pre-operation trigger, a post-operation trigger, or a code snippet.