Refresh data for snapshot layers

When you create a snapshot when publishing a map image layer from cloud data warehouse data in ArcGIS Pro, the data returned by the query layer in the map is copied to the system database. The map image layer references the data in the system database, which may perform better than going to the cloud to query the data warehouse. If you publish a feature layer and map image layer, two snapshots are created; one for the map image layer and one for the feature layer.

If the source data in the cloud data warehouse changes, you can refresh the snapshot of the data from each layer's item page. You can refresh the snapshot immediately or set up a scheduled task to update the snapshot automatically.

Refresh the snapshot immediately

If the source data changes infrequently, you can update the snapshot of the data when needed.

Follow these steps to refresh the contents of a snapshot layer immediately:

1. Sign in to the portal.

   You must sign in as the owner of the layer.

2. Open the item page for the layer that you need to refresh and click the Settings tab.
3. Scroll down to the Map Image Layer or Feature Layer section, click Snapshots to access those options, and click Refresh Snapshot.

   The Refresh Snapshot pop-up appears showing the layers to be updated.

4. Click OK to update the snapshot.

   How long it takes to refresh depends on how much data is in the layer.

   A message appears when the refresh operation completes. The date and time the snapshot was refreshed appears in the Snapshots section. You may need to refresh your browser to see the updated date.

Tip:

Remember that if you published a map image and feature layer, there are two snapshots. Repeat the steps above to update both snapshots.

Schedule the snapshot to refresh at specific intervals

If the source data updates frequently, you can define a schedule to update the snapshot automatically on a regular basis. Scheduling updates also allows them to take place when your network and servers are less busy.

Tip:

If you published a map image and feature layer, there are two snapshots. Add a scheduled task to both web layers.

You can define one schedule per web layer.

1. Sign in to the portal.

   You must sign in as the owner of the layer.

2. Open the item page for the layer for which you will schedule updates and click the Settings tab.
3. Scroll down to the Map Image Layer or Feature Layer section, click Snapshots to access those options, and click Schedule Refresh Snapshot.

   The Add snapshot refresh task pop-up appears.

4. In the Title field, type a name for the task.
5. Click the down arrow next to the date under Beginning on and use the calendar to choose the date on which automatic updates will start.
6. From the Repeat type drop-down menu, choose the temporal frequency, and define the interval at which the snapshot will update.
   • Day—From the Repeat interval drop-down menu, choose how often the snapshot will update. For example, to update the snapshot every two weeks, choose 14 – Every fourteen days.
   • Week—When you choose the Week repeat type, you define which days of the week the snapshot will update. Check the box next to the days that the update task will run. For example, check the boxes next to Wednesday and Sunday, and the task to refresh the snapshot will run every week on those two days.
   • Month—Type a number in the Day of the month field to represent the day on which the snapshot will update. From the Repeat interval drop-down menu, choose how often the snapshot will update. For example, to update the snapshot every other month on the 9th, type 9 in the Day of the month field and choose 2 – Every two months from the Repeat interval drop-down menu.
7. Click the down arrow next to the time and use the arrows on the clock pop-up to define the time of day that the task will run.
8. Define when the scheduled tasks will stop by choosing one of the following from the Ending on drop-down menu:
   • Never—The snapshot will refresh on the schedule you define until you pause or delete the task.
   • Date—Choose the date after which the task will not run.
   • Count—Type a number signifying the number of times that the task will run.
In the following example, the snapshot will update at 3:45 a.m. every Wednesday and Sunday. The scheduled task name is Biweekly snapshot update.



9. Click Create.

The scheduled task is created and listed in the Snapshots section of the Settings tab.

You can click the task name or choose View details from the Actions menu to access information about the task.

Edit the scheduled task

You can redefine a tasks schedule. For example, if you find that the source data is updated more frequently than you anticipated, you can alter the schedule to run the refresh task more often.

1. Sign in to the portal.

   You must sign in as the owner of the layer.

2. Open the item page for the layer and click the Settings tab.
3. Scroll down to the Map Image Layer or Feature Layer section and click Snapshots to access the task.
4. Click the Actions button next to the task and click Edit.

   The Edit snapshot refresh task pop-up appears.

5. Alter the settings (as explained in the previous set of steps) to define a new schedule.
6. Click Save task.

The task will run on the newly defined schedule.

Pause or resume the scheduled task

You can pause a task and resume it when you need it to start running again.

1. Sign in to the portal.

   You must sign in as the owner of the layer.

2. Open the item page for the layer and click the Settings tab.
3. Scroll down to the Map Image Layer or Feature Layer section and click Snapshots to access the task.
The status of the task is listed. If it is active, you can pause it, which will suspend the scheduled task from running until you resume it.
4. Click the Actions button next to the task and click one of the following:
   • Pause—Choosing this option will temporarily stop a task from running. For example, if you know that the person who edits the source data will be on vacation for three weeks, you can pause the task so it doesn't run until after the editor returns.
   • Resume—When you need to restart a paused task, resume it.
5. Click Yes to confirm that you want to change the status of the task.

Delete the scheduled task

Use the Delete option in the Actions menu for the task to delete it. To delete a scheduled snapshot refresh task, complete the following steps:

1. Sign in to the portal.

   You must sign in as the owner of the layer.

2. Open the item page for the layer and click the Settings tab.
3. Scroll down to the Map Image Layer or Feature Layer section and click Snapshots to access the task.
4. Click the Actions button next to the task and click Delete.

   The Delete task pop-up appears.

5. To proceed with deleting the scheduled task, click Yes.