Skip to navigation

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:

1

Find the snapshot you want to restore

  1. In your inventory, select the Keyspaces table you want to restore. The Resource Details drawer opens.

  2. 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.

  3. Select the snapshot you want to restore, and then click Restore. The Restore Keyspaces wizard opens.

2

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.

3

Set the table details

  1. 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.

  2. 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.

  3. 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.

4

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.

5

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.

6

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.