Limitations and requirements for data snapshots

  • Release version: Yokohama
  • Updated January 30, 2025
  • 3 minutes to read
  • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Limitations and requirements for data snapshots

    This document outlines the limitations and requirements for using data snapshots in ServiceNow, specifically for the Yokohama release (updated January 30, 2025). Data snapshots enable tracking and analysis of indicator data changes over time but come with specific constraints at the instance, table, indicator, breakdown, and field levels. Understanding these constraints helps ensure successful implementation and optimal performance when leveraging data snapshots in your ServiceNow environment.

    Show full answer Show less

    Instance-level limitations

    • Database: Only instances with RaptorDB Professional (PostgreSQL) are supported; Oracle and MariaDB/MySQL are not.
    • Domain Separation: Data snapshots are not supported in domain-separated instances.

    Table-level limitations

    • System Tables: Tables prefixed with sys are unsupported.
    • Table Size and Change Volume:
      • Change Data Capture (CDC) requires manageable delta tracking; very large indicator sources or those with over 30 million records are unsupported due to performance risks.
      • If any contributing table has more than 1 million changes in the last month, data snapshots are disabled for that indicator.
    • Benchmarking Indicators: Not supported at the table level.

    Indicator- and breakdown-level limitations

    • Benchmarking indicators and indicators without conditions are not supported.
    • Scripted breakdown mappings and aggregations are unsupported.
    • Breakdowns on purely string or numeric fields are not supported; however, breakdowns on Choice fields (strings or integers) are supported (e.g., Incident.Category supported, but Short Description is not).
    • Only specific query operators are supported, varying by field type; several common operators are unsupported.
    • Formula indicators require all contributing indicators to support data snapshots; formula methods within formulas are not supported.
    • Only automated and formula indicators and automated breakdowns are supported; manual or external indicators/breakdowns are excluded.
    • Indicators based on database views are supported only if join conditions involve sysid fields exclusively, without uppercase characters in prefixes, and no duplicate prefixes across tables.
    • Indicators can have up to 250 breakdown or aggregation fields.
    • Only daily collection jobs with a single timezone are supported; multiple timezones are not supported.
    • Historical data processing supports only data collected after data snapshot enablement; older data with more than two breakdown levels returns no results.
    • Breakdown matrices are not applicable; all breakdown combinations are supported by design.
    • Collection periods and time configurations on data collectors are ignored; all collections are daily, respecting only the timezone on the collection record.

    Field-level limitations

    • The Label for unmatched option on breakdown sources is ignored.
    • The Value when nil option on automated indicators is ignored.
    • Security types defined in breakdown sources are not supported.
    • Data collection job settings such as start/end periods or specific time configurations do not affect data snapshots; only the timezone on the data collection record matters.
    • Bucket groups are not supported.
    • Related list conditions do not apply to data snapshots.

    Additional feature-specific limitations

    • Targets and Thresholds: Support up to two filters.
    • KPI Signals: Support only one filter.
    • Indicator Scorecard Visualizations: Support up to two filters.
    • Scoresheets: Manual changes to scoresheets have no effect for indicators enabled with data snapshots.
    • String fields in indicator or source conditions: Limited to 4000 characters.

    Practical Implications for ServiceNow Customers

    When planning to leverage data snapshots, ensure your instance uses RaptorDB Professional and is not domain-separated. Large data sources or highly dynamic tables may not be eligible due to size and change volume constraints. Design indicators and breakdowns within supported parameters, avoiding unsupported field types, operators, and scripted elements. Understand that data snapshots operate on daily collections and have limited support for multi-timezone and historical data. Awareness of these limitations will help you optimize your indicator configurations and maintain expected performance and data integrity when using data snapshots.

    Several features of indicators and breakdowns are not supported with data snapshots and multiple breakdowns.

    Instance-level limitations

    Limitation or unsupported feature Notes
    Database requirements Only instances with the RaptorDB Professional (PostgreSQL) database are supported, not Oracle or MariaDB/MySQL. (Checked when plugin is activated.)
    Domain separation Domain-separated instances are not supported.

    Table-level limitations

    Limitation or unsupported feature Notes
    System tables System tables (named sys_*) are not supported.
    Technical limitations on table size Change data capture (CDC) works by determining and tracking the data that has changed (the "deltas"). If an indicator source is too large for data snapshots to track the deltas, multiple breakdowns are not supported for that indicator.
    Licensing limitations on table size Data sources with more than 30 million records are not supported, due to potential performance issues.
    High volume of changes If any table that contributes to an indicator, either as a data source or through breakdowns or conditions, has had more than 1 million changes in the last month, data snapshots are not enabled for that indicator.
    Benchmarking indicators Not supported

    Indicator- and breakdown-level limitations

    Limitation or unsupported feature Notes

    Benchmarking indicators

    Not supported

    Indicators with no conditions Not supported
    Scripted breakdown mappings/aggregations Not supported
    Breakdowns/aggregations on string and numeric type fields are not supported The same limitations apply as with classic Performance Analytics breakdowns and indicators: Breakdowns on Choice fields that are strings or integers are supported. Only purely string and numeric fields are not supported. For example, a breakdown on Incident.Category would be supported because Category is a Choice field. A breakdown on Short Description would not be supported, because that is purely a string.
    Only some query operators are supported Unsupported operators for each field type on the source:
    • Boolean/ChoiceTable/Reference: ISEMPTYSTRING
    • SysClassName: INSTANCEOF
    • String: MATCH_PAT and MATCH_RGX
    • Currency: NOT_EQUALS, LESS_THAN, GREATER_THAN, LESS_THAN_OR_EQUALS, GREATER_THAN_OR_EQUALS, BETWEEN, EQUALS
    • Relative Dates: LESS_THAN, LESS_THAN_EQ, GREATER_THAN, GREATER_THAN_EQ, BETWEEN
    Formula indicators All contributing indicators must support data snapshots.
    Formula methods Formula indicators that use methods in their formulas are not supported.
    Manual or external indicators or breakdowns Only automated indicators, formula indicators, and automated breakdowns are supported. All contributing indicators in a formula indicator must be supported for the formula indicator to be supported.
    Indicators based on database views Only supported when the join conditions do not include fields other than sys_id.
    Database view prefix limitations If the indicator source is a database view and there is an uppercase character in the database view prefix, the indicator is not supported. Also, if the two tables in the database view have the same prefix, the indicator is not supported.
    Indicators with more than 250 breakdown/aggregation fields Only 250 levels of breakdown are supported.
    Indicators whose collection jobs have more than one timezone Only daily collection and only one timezone are supported.
    Historical processing Only data collected after the enablement date is supported. Attempts to apply more than two levels of breakdown to older data do not return any results.
    Breakdown matrices Not applicable. All breakdown combinations are supported by design.
    Collection periods set on data collector All collections are daily.

    Field-level limitations (Indicator, breakdown, source, and data collector fields)

    Limitation or unsupported feature Notes
    Label for unmatched The Label for unmatched option on breakdown sources is ignored with data snapshots.
    Value when nil The Value when nil option on automated indicators is ignored with data snapshots.
    Security type Data snapshots does not support the security type defined in the breakdown source.
    Data collection job settings Start/end periods, specific time configurations, and other settings do not affect data snapshots. All data collection is daily. Only the timezone set on the data collection record has an effect.
    Bucket groups Not supported
    Related list conditions Related list conditions do not apply with data snapshots
    Targets and Thresholds Support only up to two filters.
    KPI Signals Support only one filter.
    Indicator scorecard visualizations Support only up to two filters.
    Scoresheets Manual changes to scoresheets for indicators that are enabled for data snapshots have no effect.
    String fields in indicator or source conditions 4000-character limit