LogoLogo
TrustAPI Docs
  • Application
  • Support
  • Platform
  • Infrastructure
  • Security
  • Notices
  • Overview
  • Protect Data
    • Auto Backup
      • Auto Backup API Usage
      • Supported Objects
      • Delete Tracking
      • Salesforce Metadata Backup
      • Missing Field Permissions
      • Viewing Records
      • Viewing Files
    • Archive
    • Restore
      • Restore Best Practices
    • Purge
  • Reuse Data
    • Data Replication
      • Data Replication API Usage
      • Supported Objects
      • Delete Tracking
      • Missing Field Permissions
      • Viewing Records
      • Viewing Files
    • Global Search
    • Data Lake (formerly History Stream)
      • AWS Data Lakehouse
      • DuckDB Data Lake
      • Heroku Data Lakehouse
      • Azure Data Lake
      • Data Lake FAQ
      • Data Lake v1 (formerly History Stream)
    • Salesforce Sandbox Seeding
      • Sandbox Seeding Walkthrough
    • Public API
    • Managed Package
      • Second Generation
        • Features
        • Install
        • Update
        • Uninstall
      • First Generation
        • Features
        • Configure
        • Uninstall
        • Migrate
      • Frequently Asked Questions
  • Other
    • Settings
      • Connecting Salesforce
      • Connecting Storage
      • Sandbox Refresh
    • Notifications
    • Permissions
      • Integration User
      • Integration User Scripts
    • Troubleshooting
      • Debugging Salesforce Triggers
    • Auto Updates

Copyright © 2025 GRAX, Inc.

On this page
  • Prerequisites
  • How It Works
  • Enabling Data Replication
  • Monitoring and Dashboard
  • Data Replication Toggle
  • Data Replication Status
  • Disabling an Object Replication
  • Frequently Asked Questions

Was this helpful?

Export as PDF
  1. Reuse Data

Data Replication

Last updated 22 days ago

Was this helpful?

With GRAX , you’re just a few clicks away from securely replicating your entire Salesforce org.

Prerequisites

  • Create an and configure their permissions

How It Works

Once the integration user is connected, GRAX:

  • Periodically describes all the objects and schema in your org and adds them to the Data Replication system.

  • Starts periodic jobs that pick an object and replicate everything new or changed since the last data replication job.

Enabling Data Replication

To enable Data Replication:

  • Navigate to the Data Replication tab within the GRAX Application

  • You'll see the screen below, and will be prompted to choose one of the following options: Start Data Replication to current bucket or Change the storage provider/bucket

When setting up Data Replication for the first time, GRAX starts by capturing and replicating object data in Salesforce, beginning with the oldest modified records and progressing to the most recently modified ones. Once the initial data replication job is complete, Data Replication seamlessly transitions to periodically capturing ongoing data changes.

The time to complete replication of new data may vary based on amount of new data to data replication, API limits, and system limits.

Monitoring and Dashboard

The Data Replication Dashboard in the GRAX Application serves as the central hub for tracking key metrics and statuses. It provides insights into the total volume of data replicated, the time frames covered by secure data replication jobs, and the historical progress of Data Replication operations.

Data Replication Toggle

You can easily control Data Replication behavior with the following options:

  • Replicate Objects and Files: Capture all available data objects

  • Replicate Objects, Pause Files: Exclude file data from the replication job

  • Replicate Paused: Disable all replication operations

Data Replication Status

Additionally, the dashboard displays detailed status information, as outlined below:

  • Backfilling: GRAX is replicating the history of your org, and at least one object has never been fully replicated

  • Behind: All objects were fully replicated previously, but replication has since fallen behind for at least one object

  • Running Continuously: GRAX is operating as expected and up to date on all objects within expected SLA

  • Paused: Data Replication has been paused by a user for records, files, or both

  • Error: An error has been encountered by the app while replicating data

The dashboard also contains a list of files and objects being replicated along with record count and version count. Objects can have the following statuses:

  • Waiting: object is caught up and waiting for new data

  • Running: object is nearly caught up and replicating new data

  • Backfilling: object is still replicating initial data

  • Paused: object isn't being processed because Data Replication has been turned off

  • Excluded: object isn't being processed because it has been explicitly excluded by the user

  • Unavailable: object isn't being processed because GRAX has lost access to the object in Salesforce

If the system encounters errors, Data Replication will display an Error status both for the entire process and the specific object affected. Additionally, a banner will appear on the dashboard with a link to the error summary page, where you can download a CSV containing detailed stack traces, if needed.

Disabling an Object Replication

There are two methods for excluding objects from replication: one on the Salesforce side and one within the GRAX Application.

Preventing Data Replication by Salesforce Permissions

Data Replication is built to capture and replicate all possible Salesforce data by replicating every object the Integration User has permission to view. This design lets you manage what objects are replicated with standard Salesforce permissions and automatically replicates new custom objects or fields without the need to modify GRAX settings. If you don't want GRAX to replicate an object or field because it isn't restorable, or isn't valuable to your data strategy, deny access to the object or field for the GRAX integration user.

Excluding Objects from Data Replication in GRAX

On the Settings page, under General Settings, you’ll find the Data Replication Exclusions field. Here, you can enter a comma-separated list of object API names to exclude from future replication jobs. Once specified, these objects will be ignored in subsequent replication jobs. However, if an object has already been replicated, it will still appear in the Objects list with an Excluded status.

Frequently Asked Questions

Can I configure the replication schedule?

GRAX is designed to replicate your entire Salesforce organization without complicated tools to configure objects, fields or schedules.

To achieve this, GRAX periodically scans your Salesforce organization for new data. If it finds new data, it then automatically schedules smaller jobs to replicate new data while staying within Salesforce API limits, and within system limits to keep replication jobs, searches, and Data Lake working as expected.

GRAX offers an option to change the period of scans between "daily" and "continuous."

  • Daily Data Replication: scans for new data once a day

  • Continuous Data Replication: scans for new data at a minimum of every hour

The time to complete replication of new data may vary based on amount of new data to replicate, API limits, and system limits.

How do I use daily replication? How does it work?

In the Data Replication Dashboard, you’ll observe continuous activity during the initial replication job and ‘backfill’ process. Afterward, daily scans will occur for each object, with activity distributed throughout the day.

No further configuration is necessary, or possible, on your part.

Why are formula fields showing outdated values?

Since formula fields are calculated in real time based on other field values and do not result in actual data changes, updates to these fields do not modify the SystemModStamp. As a result, changes to formula field values do not trigger the creation of a new record version. Therefore, the values displayed for formula fields reflect their state at the time of the most recent record replication.

What does "INSUFFICIENT_ACCESS" mean?

Example: salesforce INSUFFICIENT_ACCESS: insufficient access rights on cross-reference id

How does Data Replication handle records where a field is updated in SFDC, but the record's "SystemModStamp" remains unchanged?

For the most part, each time a record is modified within SFDC, SFDC updates the SystemModStamp to reflect the date/time of the modification, however, there are certain fields (including, but not limited to formula fields), that when changed, do not result in an updated SystemModStamp. This is a SFDC limitation, not a GRAX limitation.

Data Replication relies on a change in a record's SystemModStamp in order to identify, and therefore replicate, new or changed data. If a record is being replicated for the first time, GRAX will replicate the record with the value stored in SFDC at the time of replication, but if the record is modified after the initial replication and SFDC does not update the record's SystemModStamp, GRAX will not replicate the change.

What does "UNKNOWN_EXCEPTION" mean?

UNKNOWN_EXCEPTION: sfdc.keystone.catalog.blobforce.KeystoneGetBlobFromStoresException: Failed to get a blob from all stores: orgId=00AbC000000DeM0 keyPrefix=05T entityId=05T2R000016VbmO blobId=0KF2R00002uQzDX extentId=F00D0b000000GaMp0KE2R00001MVoIw1 [...] there are no stores that currently contain the extent= F00D0b000000GaMp0KE2R00001MVoIw1, so we can't read it!)

An error has occurred within the Salesforce backend infrastructure, outside the scope of the GRAX Application. Please contact Salesforce support to open a case and report the issue.

The Data Replication Dashboard offers a CSV export of all errors to include with your support case.

Additionally, the Excluded Objects tab displays objects that are not being replicated due to being unsupported; you can read more about supported objects .

to enable Daily Data Replication for your deployment.

Review your for View All Data, View All Files and other required permissions. If the error occurs on Campaign or other marketing related objects, try enabling "Marketing User" for the integration user.

See the for more information.

There are several documented workarounds detailing how to "trigger" a SystemModStamp update when fields that do not update the record's SystemModStamp are modified, one of which can be found .

here
Integration User permissions
User Fields reference doc
here
Data Replication
integration user
Connect to Salesforce
Connect Storage
"Enable Data Replication" popup
Healthy Data Replication Dashboard
Data Replication Mode Selector
Data Replication Dashboard Objects List
Data Replication Dashboard Excluded Objects List
GRAX Data Replication set up using Auto Config
Healthy Data Replication Dashboard
GRAX Data Replication - mode selector
Contact GRAX Support