"Governance" is the name given to NetSuite's system for detecting and halting long-running, runaway, or resource-intensive scripts.
Each script type has governance limits that it cannot exceed, and there are four types of governance limits in place for each script type.
If a script exceeds its governance limit in any one of these four areas, NetSuite will throw an uncatchable exception and terminate the script immediately.
NetSuite limits the API usage of your scripts with a system based on "usage units". Some NetSuite API calls, particularly the ones that perform a read or write action on the database, cost a specific number of units each time they are invoked. Each script type then has a maximum number of units that can be used during each execution of the script.
If a script exceeds its API usage limit, NetSuite terminates the script by throwing an
Below are a few examples of unit costs for common operations. For an exhaustive list of Governance costs, see the article titled "API Governance" in NetSuite Help.
|Loading a Saved Search|
|Retrieving Search Results|
|Scheduling a task|
|Requesting a URL|
|Sending an email|
|Creating a custom record|
|Creating an Employee record|
|Creating a Sales Order record|
|Saving a custom record|
|Saving a Contact record|
|Saving a Purchase Order record|
Different operations use different amounts of units, and certain operations cost a different amount based on the record type being used. The larger the number of units a function costs, typically the longer it will take to execute.
Transactions are the largest of the record types, so working with them costs the largest amount of units. Conversely, custom records are very lightweight, and so do not cost many units. Standard NetSuite records that are not Transactions, like Customers, Employees, or Contacts, sit in between the two in terms of cost.
These are the usage limits by script type:
|Script Type||Usage Limit|
|Mass Update||10,000 per record|
NetSuite also uses the governance system to detect and halt runaway scripts by using a timeout mechanism and an instruction counter.
If a script takes too much time to run, NetSuite will stop it by throwing an
In addition, runaway scripts can be detected and halted based on their "Instruction Count". If the defined instruction count limits are exceeded, NetSuite will stop the script by throwing an
There is, unfortunately, no Help documentation that defines:
It is simply important to know that if you encounter either the
SSS_TIME_LIMIT_EXCEEDED error or the
SSS_INSTRUCTION_COUNT_EXCEEDED error in one of your scripts, you have processing that is taking too long. Focus your investigation on your loop structures to determine where optimizations may be made.
If your script exceeds the memory usage limit, NetSuite will terminate your script by throwing a
Every variable declared, every function defined, every Object stored contributes to the memory usage of your script.
Both the Scheduled Script and the Map/Reduce Script have documented
50MB memory limits. There is also a documented limit of
10MB for the size of any String passed in to or returned from a RESTlet. There is no other documentation on the specific limits for a given script.