updateResourceStatisticsConfig
Update the statistics configuration for a resource.
Location
/services/webservices/system/admin/resource/operations/
Request Elements
path: The path of a resource.
type: The type of the resource can only be a physical relational TABLE.
detail: The level of detail about the resources to include in the response. Valid values are NONE, SIMPLE, and FULL.
statisticsConfig: The statistics configuration of the given resource.
• cardinalityMin (optional): Minimum cardinality for this resource. Setting this value overrides gathered statistics.
• cardinalityMax (optional): Maximum cardinality for this resource. Setting this value overrides gathered statistics.
• cardinalityExpected (optional): Expected cardinality for this resource. Setting this value overrides gathered statistics.
• gatherEnabled (optional): Defines what statistics should be gathered for this resource. Valid values are DEFAULT, CUSTOM, DISABLED or TABLE_BOUNDARY. If not provided, the enable setting is left unaltered.
• maxTime (optional): From -1 to n in milliseconds. If not provided, the enable setting is left unaltered. 0 means no timeout; -1 means use data source default; 0 or greater overrides data source setting.
• columns (optional): Only applicable if gatherEnabled is set to CUSTOM.
• column: What specific data to get for each column.
name: Column name.
flags: Valid values are NONE, BOUNDARY or ALL.
Response Elements
statisticsConfig (optional): The statistics configuration of the given resource. This element is only present in the response if the detail level is not NONE.
• cardinalityMin (optional): Minimum cardinality for this resource.
• cardinalityMax (optional): Maximum cardinality for this resource.
• cardinalityExpected (optional): Expected cardinality for this resource.
• gatherEnabled (optional): What statistics should be gathered for this resource.
• maxTime (optional): Maximum amount of time the process should spend gathering data; 0 means no limit.
• columns (optional): Only available if gatherEnabled is set to CUSTOM.
• name: Simple column name.
• flags: NONE, BOUNDARY or ALL.
Faults
IllegalArgument: If the path is malformed or an illegal type is provided.
IllegalArgument: If statsGatherEnabled is not one of the valid values.
IllegalArgument: If a column does not support supplied flags.
NotAllowed: If the resource type is not of the right type or its parent data source is not configured.
NotFound: If the resource or any portion of the path to the resource does not exist.
Security: If the user does not have READ access on all items in path other than the last one.
Security: If the user does not have WRITE access on the last item in path.
Security: If the user does not have the ACCESS_TOOLS right.