restoreBackup - Kinetica Docs

◆ restoreBackup() [1/4]

RestoreBackupResponse gpudb::GPUdb::restoreBackup ( const RestoreBackupRequest & request_ ) const

Restores database objects from a backup accessible via the data source specified by datasourceName.

Parameters

[in] request_ Request object containing the parameters for the operation.

Returns

Response object containing the result of the operation.

◆ restoreBackup() [2/4]

RestoreBackupResponse & gpudb::GPUdb::restoreBackup	(	const RestoreBackupRequest &	request_,
		RestoreBackupResponse &	response_ ) const

Restores database objects from a backup accessible via the data source specified by datasourceName.

Parameters

[in]	request_	Request object containing the parameters for the operation.
[out]	response_	Response object containing the results of the operation.

Returns

Response object containing the result of the operation (initially passed in by reference).

◆ restoreBackup() [3/4]

RestoreBackupResponse gpudb::GPUdb::restoreBackup	(	const std::string &	backupName,
		const std::map< std::string, std::string > &	restoreObjectsMap,
		const std::string &	datasourceName,
		const std::map< std::string, std::string > &	options ) const

Restores database objects from a backup accessible via the data source specified by datasourceName.

Parameters

[in]	backupName	Name of the backup to restore from, which must refer to an existing backup. The default value is ”.
[in]	restoreObjectsMap	Map of database objects to be restored from the backup. restore_backup_all: All object types and data contained in the given schema(s). restore_backup_catalog: Data Lake catalog that is external to the database. restore_backup_context: Context(s). restore_backup_credential: Credential(s). restore_backup_datasink: Data sink(s). restore_backup_datasource: Data source(s). restore_backup_directory: KiFS File directory(ies). restore_backup_function_environment: Python UDF function environment(s). restore_backup_graph: Graph definition(s). Source table(s), if applicable, are required in order to restore graph objects. restore_backup_monitor: Table monitor(s) / SQL stream(s). restore_backup_resource_group: Resource group(s). restore_backup_role: Role(s), role members (roles or users, recursively), and associated permissions. restore_backup_stored_procedure: SQL procedure(s). restore_backup_table: Table(s) and SQL view(s). Tables with subscriptions will by default be restored in the state they were in at the time of the snapshot. See restore_subscriptions for options to override the default behavior. restore_backup_user: User(s) (internal and external) and associated permissions. restore_backup_user_defined_function: UDF(s).
[in]	datasourceName	Data source through which the backup will be restored.
[in]	options	Optional parameters. restore_backup_backup_id: ID of the snapshot to restore. Leave empty to restore the most recent snapshot in the backup. The default value is ”. restore_backup_checksum: Whether or not to verify checksums for backup files when restoring. Supported values: restore_backup_true restore_backup_false The default value is restore_backup_false. restore_backup_create_schema_if_not_exist: Behavior to apply when the schema containing any database object to restore does not already exist. Supported values: restore_backup_true: If the schema containing any restored object does not exist, create it automatically. restore_backup_false: If the schema containing any restored object does not exist, return an error. The default value is restore_backup_true. restore_backup_ddl_only: Behavior to apply when restoring tables. Supported values: restore_backup_true: Restore table DDL, but do not restore data. restore_backup_false: Restore tables and their data. The default value is restore_backup_false. restore_backup_dry_run: Whether or not to perform a dry run of the restoration operation. Supported values: restore_backup_true restore_backup_false The default value is restore_backup_false. restore_backup_restore_subscriptions: Behavior to apply when restoring datasource subscriptions on tables. Supported values: restore_backup_resume: Resume subscriptions that were active when the backup was made. restore_backup_pause: Pause subscriptions that were active when the backup was made. restore_backup_cancel: Cancel active subscriptions. The default value is restore_backup_resume. restore_backup_reingest: Behavior to apply when restoring table data. Supported values: restore_backup_true: Restore table data by re-ingesting it. This is the default behavior if the cluster topology differs from that of the contained backup. restore_backup_false: Restore the persisted data files directly. The default value is restore_backup_false. restore_backup_renamed_objects_schema: If the restore_policy is rename, use this schema for relocated existing objects instead of the default generated one. The default value is ”. restore_backup_restore_all_permissions: Whether or not all permissions of restored principals should be restored or scoped to the restored objects. Supported values: restore_backup_true: Restore all permissions. restore_backup_false: Restore only permissions on restored objects. The default value is restore_backup_false. restore_backup_restore_policy: Behavior to apply when any database object to restore already exists. Supported values: restore_backup_none: If an object to be restored already exists with the same name, abort and return error. restore_backup_replace: If an object to be restored already exists with the same name, replace it with the backup version. restore_backup_rename: If an object to be restored already exists with the same name, move that existing one to the schema specified by renamed_objects_schema. This policy does not apply to non-schema objects. The default value is restore_backup_none. restore_backup_target_schema_map: Restore schema-based objects to alternate schema. Value is a comma delimitted list of key:value pairs mapping the original (source) schema name as it exists in the backup to a target (destination) schema namespace: “src: dst [, src: dst [, …]]”. Note that schema names are case sensitive and must adhere to the database schema naming criteria. The default value is ”. The default value is an empty map.

Returns

Response object containing the result of the operation.

◆ restoreBackup() [4/4]

RestoreBackupResponse & gpudb::GPUdb::restoreBackup	(	const std::string &	backupName,
		const std::map< std::string, std::string > &	restoreObjectsMap,
		const std::string &	datasourceName,
		const std::map< std::string, std::string > &	options,
		RestoreBackupResponse &	response_ ) const

Restores database objects from a backup accessible via the data source specified by datasourceName.

Parameters

[in]	backupName	Name of the backup to restore from, which must refer to an existing backup. The default value is ”.
[in]	restoreObjectsMap	Map of database objects to be restored from the backup. restore_backup_all: All object types and data contained in the given schema(s). restore_backup_catalog: Data Lake catalog that is external to the database. restore_backup_context: Context(s). restore_backup_credential: Credential(s). restore_backup_datasink: Data sink(s). restore_backup_datasource: Data source(s). restore_backup_directory: KiFS File directory(ies). restore_backup_function_environment: Python UDF function environment(s). restore_backup_graph: Graph definition(s). Source table(s), if applicable, are required in order to restore graph objects. restore_backup_monitor: Table monitor(s) / SQL stream(s). restore_backup_resource_group: Resource group(s). restore_backup_role: Role(s), role members (roles or users, recursively), and associated permissions. restore_backup_stored_procedure: SQL procedure(s). restore_backup_table: Table(s) and SQL view(s). Tables with subscriptions will by default be restored in the state they were in at the time of the snapshot. See restore_subscriptions for options to override the default behavior. restore_backup_user: User(s) (internal and external) and associated permissions. restore_backup_user_defined_function: UDF(s).
[in]	datasourceName	Data source through which the backup will be restored.
[in]	options	Optional parameters. restore_backup_backup_id: ID of the snapshot to restore. Leave empty to restore the most recent snapshot in the backup. The default value is ”. restore_backup_checksum: Whether or not to verify checksums for backup files when restoring. Supported values: restore_backup_true restore_backup_false The default value is restore_backup_false. restore_backup_create_schema_if_not_exist: Behavior to apply when the schema containing any database object to restore does not already exist. Supported values: restore_backup_true: If the schema containing any restored object does not exist, create it automatically. restore_backup_false: If the schema containing any restored object does not exist, return an error. The default value is restore_backup_true. restore_backup_ddl_only: Behavior to apply when restoring tables. Supported values: restore_backup_true: Restore table DDL, but do not restore data. restore_backup_false: Restore tables and their data. The default value is restore_backup_false. restore_backup_dry_run: Whether or not to perform a dry run of the restoration operation. Supported values: restore_backup_true restore_backup_false The default value is restore_backup_false. restore_backup_restore_subscriptions: Behavior to apply when restoring datasource subscriptions on tables. Supported values: restore_backup_resume: Resume subscriptions that were active when the backup was made. restore_backup_pause: Pause subscriptions that were active when the backup was made. restore_backup_cancel: Cancel active subscriptions. The default value is restore_backup_resume. restore_backup_reingest: Behavior to apply when restoring table data. Supported values: restore_backup_true: Restore table data by re-ingesting it. This is the default behavior if the cluster topology differs from that of the contained backup. restore_backup_false: Restore the persisted data files directly. The default value is restore_backup_false. restore_backup_renamed_objects_schema: If the restore_policy is rename, use this schema for relocated existing objects instead of the default generated one. The default value is ”. restore_backup_restore_all_permissions: Whether or not all permissions of restored principals should be restored or scoped to the restored objects. Supported values: restore_backup_true: Restore all permissions. restore_backup_false: Restore only permissions on restored objects. The default value is restore_backup_false. restore_backup_restore_policy: Behavior to apply when any database object to restore already exists. Supported values: restore_backup_none: If an object to be restored already exists with the same name, abort and return error. restore_backup_replace: If an object to be restored already exists with the same name, replace it with the backup version. restore_backup_rename: If an object to be restored already exists with the same name, move that existing one to the schema specified by renamed_objects_schema. This policy does not apply to non-schema objects. The default value is restore_backup_none. restore_backup_target_schema_map: Restore schema-based objects to alternate schema. Value is a comma delimitted list of key:value pairs mapping the original (source) schema name as it exists in the backup to a target (destination) schema namespace: “src: dst [, src: dst [, …]]”. Note that schema names are case sensitive and must adhere to the database schema naming criteria. The default value is ”. The default value is an empty map.
[out]	response_	Response object containing the results of the operation.

Returns

Response object containing the result of the operation (initially passed in by reference).

​◆ restoreBackup() [1/4]

​◆ restoreBackup() [2/4]

​◆ restoreBackup() [3/4]

​◆ restoreBackup() [4/4]

◆ restoreBackup() [1/4]

◆ restoreBackup() [2/4]

◆ restoreBackup() [3/4]

◆ restoreBackup() [4/4]