Restore Backup

Restores objects from a backup instance. Response from a backup restoration operation.

Input Parameter Description

Name

Type

Description

backup_name

string

Name of the backup object, which must refer to a currently existing backup. The default value is ''.

restore_objects_map

map of string to strings

Map of objects to be restored from the backup. Error if empty.

Supported Parameters (keys)	Parameter Description
all	All object types in a schema (excludes permissions, system configuration, host secret key, KiFS directories and user defined functions)
table	Database Table
credential	Credential
context	Context
datasink	Data Sink
datasource	Data Source
stored_procedure	SQL Procedure
monitor	Table Monitor (Stream)
user	User (internal and external) and associated permissions
role	Role, role members (roles or users, recursively) and associated permissions
configuration	If true, restore the database configuration file The default value is false. The supported values are: false true

datasource_name

string

Datasource where backup is located.

options

map of string to strings

Optional parameters. The default value is an empty map ( {} ).

Supported Parameters (keys)

Parameter Description

backup_id

Backup instance ID to restore. Leave empty to restore the most recent backup instance. The default value is ''.

restore_policy

Behavior to apply when restoring objects that already exist The default value is none.

Supported Values	Description
none	If an object to be restored currently exists with the same name, abort and return error
replace	If an object to be restored currently exists with the same name, replace it with the backup version
rename	If an object to be restored currently exists with the same name, rename the original version

renamed_objects_schema

If the restore policy is rename, optionally use this schema for renamed objects instead of a default generated one. The default value is ''.

create_schema_if_not_exist

Create the schema for an object to be restored if it does not currently exist. Error otherwise. The default value is true. The supported values are:

false
true

reingest

Restore table data by re-ingesting. If the cluster topology differs from the contained backup this is the default behavior, otherwise restore the persist directly. The default value is false. The supported values are:

false
true

ddl_only

Only recreates the objects from their DDL, do not restore table data The default value is false. The supported values are:

true
false

checksum

Verify checksum for backup files The default value is false. The supported values are:

false
true

dry_run

Does a dry-run restoration operation The default value is false. The supported values are:

true
false

Output Parameter Description

Name	Type	Description
backup_name	string	The backup name
backup_id	long	The backup ID that was restored
restored_bytes	long	Total size of data restored from backup
restored_files	long	Total number of files restored from backup
restored_records	long	Total number of records restored from backup
restored_objects	map of string to strings	Objects that were successfully restored and their associated types.
renamed_objects	map of string to strings	Original and new names of objects that were successfully restored and their associated types.
failed_objects	map of string to strings	Objects that failed to be restored and their associated types.
info	map of string to strings	Additional information.