Keyspaces: Restore a Table
Who can use this feature
Anyone with these permissions: Restore resources
This article explains how to restore a Keyspaces table from your Eon snapshots.
Restore the table
Before you start
Before you restore a Keyspaces table, make sure:
- A restore account has been connected to your Eon account.
Find the snapshot you want to restore
-
In your inventory, select the Keyspaces table you want to restore. The Resource Details drawer opens.
-
Click the Eon snapshots tab. You’ll see a calendar view with colored dots on the days when snapshots were taken. There can be more than one snapshot per day.
When you click a day, a list of Eon snapshots taken that day is displayed below the calendar.
-
Select the snapshot you want to restore, and then click Restore. The Restore Keyspaces wizard opens.
Choose the restore account
In the Restore Keyspaces wizard, you’re taken through a two-step process. The first step is to choose a restore account.
Choose the cloud account you want to restore the table in, and then click Next.
Set the table details
-
Set a Keyspace name, Table name, and Region for the restored table. You can restore to a new table or to an existing empty table in the specified region.
You can restore to an existing table only if the destination table has no rows and its schema matches the snapshot, including user-defined types.
-
Choose the write capacity for the restore from Write mode:
-
Provisioned: Set the Write capacity units for the restore. Higher values restore faster but require sufficient account quota.
-
On-demand: No capacity management needed, but costs significantly more than provisioned mode.
-
-
In Encrypt this resource, select Select an existing key to choose from your available keys, or select Enter a key ARN and provide the KMS key ARN.
Configure time-to-live (TTL) handling
Choose whether to honor the TTL settings by turning Discard TTL on or off:
-
On: Restores all records regardless of their original expiration date. No TTL is set for any record.
-
Off: Honor the original expiration times from the snapshot. Doesn’t restore records that expired before the time of restore. Calculates a new TTL for active records, where those records expire at the time set in the snapshot.
For example, suppose a row was written on June 1 with
USING TTL 259200(3 days), so it expires on June 4. If you restore that snapshot on June 3 with Discard TTL off, Eon writes the row with about 86,400 seconds (1 day) of TTL remaining, and it still expires on June 4. A row that had already expired before June 3 isn’t restored.
Set tags
To retain the tags that were present when the snapshot was taken, leave Keep original tags on. Otherwise, turn it off.
All restored tables are tagged with eon:restore=true regardless of this setting.
Tags with the eon: prefix aren’t included in the original tags because Eon uses this prefix for internal operations.
Start the restore job
Click Restore to start the asynchronous restore job.
You can see your list of restore jobs on the Restore jobs tab in the Jobs page.
After the job is completed, the status changes to SUCCESS, and you can work with the restored table as normal. If you run into issues, see Restore troubleshooting.