Processing Options and Settings (Analysis Services)

Applies to: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

When you process objects in Microsoft SQL Server SQL Server Analysis Services, you can select a processing option to control the type of processing that occurs for each object. Processing types differ from one object to another, and by changes that have occurred to the object since it was last processed. If you enable SQL Server Analysis Services to automatically select a processing method, it will use the method that returns the object to a fully processed state in the least time.

Processing settings let you control the objects that are processed, and the methods that are used to process those objects. Some processing settings are primarily used for batch processing jobs. For more information about batch processing, see Batch Processing (Analysis Services).

Note

This topic applies to multidimensional and data mining solutions. For information about tabular solutions, see Process Database, Table, or Partition (Analysis Services).

Processing Options

The following table describes the processing methods that are available in SQL Server Analysis Services, and identifies the objects for which each method is supported.

Mode Applies to Description
Process Default Cubes, databases, dimensions, measure groups, mining models, mining structures, and partitions. Detects the process state of database objects, and performs processing necessary to deliver unprocessed or partially processed objects to a fully processed state. If you change a data binding, Process Default will do a Process Full on the affected object.
Process Full Cubes, databases, dimensions, measure groups, mining models, mining structures, and partitions. Processes an SQL Server Analysis Services object and all the objects that it contains. When Process Full is executed against an object that has already been processed, SQL Server Analysis Services drops all data in the object, and then processes the object. This kind of processing is required when a structural change has been made to an object, for example, when an attribute hierarchy is added, deleted, or renamed.
Process Clear Cubes, databases, dimensions, measure groups, mining models, mining structures, and partitions. Drops the data in the object specified and any lower-level constituent objects. After the data is dropped, it is not reloaded.
Process Data Dimensions, cubes, measure groups, and partitions. Processes data only without building aggregations or indexes. If there is data is in the partitions, it will be dropped before re-populating the partition with source data.
Process Add Dimensions, measure groups, and partitions

Note: Process Add is not available for dimension processing in Management Studio, but you can write XMLA script performs this action.
For dimensions, adds new members and updates dimension attribute captions and descriptions.

For measure groups and partitions, adds newly available fact data and process only to the relevant partitions.
Process Update Dimensions Forces a re-read of data and an update of dimension attributes. Flexible aggregations and indexes on related partitions will be dropped.
Process Index Cubes, dimensions, measure groups, and partitions Creates or rebuilds indexes and aggregations for all processed partitions. For unprocessed objects, this option generates an error.

Processing with this option is needed if you turn off Lazy Processing.
Process Structure Cubes and mining structures If the cube is unprocessed, SQL Server Analysis Services will process, if it is necessary, all the cube's dimensions. After that, SQL Server Analysis Services will create only cube definitions. If this option is applied to a mining structure, it populates the mining structure with source data. The difference between this option and the Process Full option is that this option does not iterate the processing down to the mining models themselves.
Process Clear Structure Mining structures Removes all training data from a mining structure.

Processing Settings

The following table describes the processing settings that are available for use when you create a process operation.

Processing Option Description Option value
Parallel Used for batch processing. This setting causes SQL Server Analysis Services to fork off processing tasks to run in parallel inside a single transaction. If there is a failure, the result is a roll-back of all changes. You can set the maximum number of parallel tasks explicitly, or let the server decide the optimal distribution. The Parallel option is useful for speeding up processing.
Sequential (Transaction Mode) Controls the execution behavior of the processing job. Two options are available.

When you process using One Transaction, all changes are committed after the processing job succeeds. This means that all SQL Server Analysis Services objects affected by a particular processing job remain available for queries until the commit process. This makes the objects temporarily unavailable. Using Separate Transactions causes all objects that are affected by a process in processing job to be taken unavailable for queries as soon as that process succeeds.
One Transaction. The processing job runs as a transaction. If all processes inside the processing job succeed, all changes by the processing job are committed. If one process fails, all changes by the processing job are rolled back. One Transaction is the default value.

Separate Transactions. Each process in the processing job runs as a stand-alone job. If one process fails, only that process is rolled back and the processing job continues. Each job commits all process changes at the end of the job.
Writeback Table Option Controls how writeback tables are handled during processing. This option applies to writeback partitions in a cube. Use Existing. Uses the existing writeback table. This is default value.

Create. Creates a new writeback table and causes the process to fail if one already exists.

Create Always. Creates a new writeback table even if one already exists. An existing table is deleted and replaced.
Process Affected Objects Controls the object scope of the processing job. An affected object is defined by object dependency. For example, partitions are dependent on the dimensions that determine aggregation, but dimensions are not dependent on partitions. False is the default setting. False. The job processes the objects explicitly named in the job and all dependent objects. For example, if the processing job contains only dimensions, SQL Server Analysis Services processes just those objects explicitly identified in the job. If the processing job contains partitions, partition processing automatically invokes processing of affected dimensions.

True. The job processes the objects explicitly named in the job, all dependent objects, and all objects affected by the objects being processed without changing the state of the affected objects. For example, if the processing job contains only dimensions, SQL Server Analysis Services also processes all partitions affected by the dimension processing for partitions that are currently in a processed state. Affected partitions that are currently in an unprocessed state are not processed. However, because partitions are dependent on dimensions, if the processing job contains only partitions, partition processing automatically invokes processing of affected dimensions, even when the dimension is currently in an unprocessed state.
Dimension Key Errors Determines the action taken by SQL Server Analysis Services when errors occur during processing. When you select Use custom error configuration, you can select values for the following actions to control error-handling behavior.

When you select Use default error configuration, SQL Server Analysis Services uses the error configuration that is set for each object being processed. If an object is set to use default configuration settings, SQL Server Analysis Services uses the default settings that are listed for each option.
Key error action. If a key value does not yet exist in a record, one of these actions is selected to occur: Convert to unknown. The key is interpreted as an unknown member. This is the default setting.

Discard record. The record is discarded.
Processing error limit. Controls the number of errors processed by selecting one of these options: Ignore errors count. This will enable processing to continue regardless of the number of errors.

Stop on error. With this option, you control two additional settings. Number of errors lets you limit processing to the occurrence of a specific number of errors. On error action lets you determine the action when Number of errors is reached. You can select Stop processing, which causes the processing job to fail and roll back any changes, or Stop logging, which enables processing to continue without logging errors. Stop on error is the default setting with Number of errors set to 0 and On error action set to Stop processing.
The following error conditions. You can set the option value to control specific error-handling behavior.

When you select Use default error configuration, Analysis Services uses the error configuration that is set for each object being processed. If an object is set to use default configuration settings, Analysis Services uses the default settings that are listed for each option.
Key not found. Occurs when a key value exists in a partition but does not exist in the corresponding dimension. The default setting is Report and continue. Other settings are Ignore error and Report and stop.

Duplicate key. Occurs when more than one key value exists in a dimension. The default setting is Ignore error. Other settings are Report and continue and Report and stop.

Null key converted to unknown. Occurs when a key value is null and the Key error action is set to Convert to unknown. The default setting is Ignore error. Other settings are Report and continue and Report and stop.

Null key not allowed. Occurs when Key error action is set to Discard record. The default setting is Report and continue. Other settings are Ignore error and Report and stop.

See Also

Processing a multidimensional model (Analysis Services)