- All Implemented Interfaces:
AttachmentProperties,BaseProperties,ServiceConnectionProperties,NBackupManager,ServiceManager
- Author:
- Thomas Steinmaurer, Mark Rotteveel
-
Field Summary
Fields inherited from class org.firebirdsql.management.FBServiceManager
BUFFER_SIZE -
Constructor Summary
ConstructorsConstructorDescriptionCreate a new instance ofFBNBackupManagerbased on the default GDSType.FBNBackupManager(String gdsType) Create a new instance ofFBNBackupManagerbased on a given GDSType name.FBNBackupManager(GDSType gdsType) Create a new instance ofFBNBackupManagerbased on a given GDSType. -
Method Summary
Modifier and TypeMethodDescriptionvoidaddBackupFile(String backupFile) Add additional backup files.voidPerform the backup operation.voidClear the information about backup files.voidPerform the nbackup fixup operation.voidPerform the restore operation.voidsetBackupFile(String backupFile) Sets the location of the backup file.voidsetBackupGuid(String guid) Sets the backup GUID (Firebird 4 and higher only).voidsetBackupLevel(int backupLevel) Sets the backup level (0 = full, 1..n = incremental)voidsetCleanHistory(boolean cleanHistory) Enables clean history on backup.voidsetInPlaceRestore(boolean inPlaceRestore) Enables in-place restore.voidsetKeepDays(int days) Sets the number of days of backup history to keep.voidsetKeepRows(int rows) Sets the number of rows of backup history to keep (this includes the row created by the backup).voidsetNoDBTriggers(boolean noDBTriggers) Sets the option no database triggers when connecting at backup or in-place restore.voidsetPreserveSequence(boolean preserveSequence) Enables preserve sequence (for fixup or restore).Methods inherited from class org.firebirdsql.management.FBServiceManager
attachDatabase, attachServiceManager, connectionPropertyValues, createRequestBuffer, executeServicesOperation, getAuthPlugins, getBooleanProperty, getCharSet, getDatabase, getDbCryptConfig, getExpectedDb, getHost, getIntProperty, getLogger, getPassword, getPort, getPortNumber, getProperty, getServerName, getServerVersion, getServiceName, getUser, getWireCrypt, getWireCryptAsEnum, isWireCompression, queueService, setAuthPlugins, setBooleanProperty, setCharSet, setDatabase, setDbCryptConfig, setExpectedDb, setHost, setIntProperty, setLogger, setPassword, setPort, setPortNumber, setProperty, setServerName, setServiceName, setType, setUser, setWireCompression, setWireCryptAsEnumMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface org.firebirdsql.jaybird.props.AttachmentProperties
getAuthPlugins, getCharSet, getConnectTimeout, getDbCryptConfig, getEnableProtocol, getEncoding, getParallelWorkers, getPassword, getPortNumber, getProcessId, getProcessName, getRoleName, getServerName, getSocketBufferSize, getSocketFactory, getSoTimeout, getType, getUser, getWireCrypt, isWireCompression, setAuthPlugins, setCharSet, setConnectTimeout, setDbCryptConfig, setEnableProtocol, setEncoding, setParallelWorkers, setPassword, setPortNumber, setProcessId, setProcessName, setRoleName, setServerName, setSocketBufferSize, setSocketFactory, setSoTimeout, setType, setUser, setWireCompression, setWireCryptMethods inherited from interface org.firebirdsql.jaybird.props.BaseProperties
connectionPropertyValues, getBooleanProperty, getBooleanProperty, getIntProperty, getIntProperty, getProperty, getProperty, setBooleanProperty, setIntProperty, setPropertyMethods inherited from interface org.firebirdsql.management.NBackupManager
setDatabaseMethods inherited from interface org.firebirdsql.jaybird.props.ServiceConnectionProperties
getExpectedDb, getServiceName, setExpectedDb, setServiceNameMethods inherited from interface org.firebirdsql.management.ServiceManager
getDatabase, getHost, getLogger, getPort, getServerVersion, getWireCryptAsEnum, setHost, setLogger, setPort, setWireCryptAsEnum
-
Constructor Details
-
FBNBackupManager
public FBNBackupManager()Create a new instance ofFBNBackupManagerbased on the default GDSType. -
FBNBackupManager
Create a new instance ofFBNBackupManagerbased on a given GDSType name.- Parameters:
gdsType- type must be PURE_JAVA, EMBEDDED, or NATIVE
-
FBNBackupManager
Create a new instance ofFBNBackupManagerbased on a given GDSType.- Parameters:
gdsType- type must be PURE_JAVA, EMBEDDED, or NATIVE
-
-
Method Details
-
setBackupFile
Description copied from interface:NBackupManagerSets the location of the backup file.Warning: this method behaves identical to
NBackupManager.addBackupFile(String).- Specified by:
setBackupFilein interfaceNBackupManager- Parameters:
backupFile- the location of the backup file.
-
addBackupFile
Description copied from interface:NBackupManagerAdd additional backup files.Specifying multiple backup files is only valid for restore, for backup only the first file is used.
Use
NBackupManager.clearBackupFiles()to clear earlier backup files.- Specified by:
addBackupFilein interfaceNBackupManager- Parameters:
backupFile- the location of the backup file.
-
clearBackupFiles
public void clearBackupFiles()Description copied from interface:NBackupManagerClear the information about backup files. This method undoes all parameters set in theNBackupManager.addBackupFile(String)method.- Specified by:
clearBackupFilesin interfaceNBackupManager
-
backupDatabase
Description copied from interface:NBackupManagerPerform the backup operation.- Specified by:
backupDatabasein interfaceNBackupManager- Throws:
SQLException- if a database error occurs during the backup
-
restoreDatabase
Description copied from interface:NBackupManagerPerform the restore operation.Set
NBackupManager.setPreserveSequence(boolean)to preserve the original database GUID and replication sequence.- Specified by:
restoreDatabasein interfaceNBackupManager- Throws:
SQLException- if a database error occurs during the restore- See Also:
-
fixupDatabase
Description copied from interface:NBackupManagerPerform the nbackup fixup operation.A fixup will switch a locked database to 'normal' state without merging the delta, so this is a potentially destructive action. The normal use-case of this option is to unlock a copy of a database file where the source database file was locked with
nbackup -LorALTER DATABASE BEGIN BACKUP.Set
NBackupManager.setPreserveSequence(boolean)to preserve the original database GUID and replication sequence.- Specified by:
fixupDatabasein interfaceNBackupManager- Throws:
SQLException- if a database error occurs during the fixup
-
setBackupLevel
public void setBackupLevel(int backupLevel) Description copied from interface:NBackupManagerSets the backup level (0 = full, 1..n = incremental)- Specified by:
setBackupLevelin interfaceNBackupManager- Parameters:
backupLevel- backup level (e.g. 0 = full backup, 1 = level 1 incremental backup based on level 0 backup
-
setBackupGuid
Description copied from interface:NBackupManagerSets the backup GUID (Firebird 4 and higher only).The backup GUID is the GUID of a previous backup of the (source) database. This is used by Firebird to backup the pages modified since that backup.
This setting is mutually exclusive with
NBackupManager.setBackupLevel(int), but this is only checked server-side.- Specified by:
setBackupGuidin interfaceNBackupManager- Parameters:
guid- A GUID string of a previous backup, enclosed in braces.
-
setNoDBTriggers
public void setNoDBTriggers(boolean noDBTriggers) Description copied from interface:NBackupManagerSets the option no database triggers when connecting at backup or in-place restore.- Specified by:
setNoDBTriggersin interfaceNBackupManager- Parameters:
noDBTriggers-truedisable db triggers during backup or in-place restore.
-
setInPlaceRestore
public void setInPlaceRestore(boolean inPlaceRestore) Description copied from interface:NBackupManagerEnables in-place restore.- Specified by:
setInPlaceRestorein interfaceNBackupManager- Parameters:
inPlaceRestore-trueto enable in-place restore
-
setPreserveSequence
public void setPreserveSequence(boolean preserveSequence) Description copied from interface:NBackupManagerEnables preserve sequence (for fixup or restore).This preserves the existing GUID and replication sequence of the original database (they are reset otherwise).
- Specified by:
setPreserveSequencein interfaceNBackupManager- Parameters:
preserveSequence-trueto enable preserve sequence
-
setCleanHistory
public void setCleanHistory(boolean cleanHistory) Description copied from interface:NBackupManagerEnables clean history on backup.The backup will fail if
NBackupManager.setKeepDays(int)orNBackupManager.setKeepRows(int)has not been called.- Specified by:
setCleanHistoryin interfaceNBackupManager- Parameters:
cleanHistory-trueto enable clean history
-
setKeepDays
public void setKeepDays(int days) Description copied from interface:NBackupManagerSets the number of days of backup history to keep.Server-side, this option is mutually exclusive with
NBackupManager.setKeepRows(int), this is not enforced by the Java code.This option only has effect when
setCleanHistory(true)has been called.- Specified by:
setKeepDaysin interfaceNBackupManager- Parameters:
days- number of days to keep history when cleaning, or-1to clear current value- See Also:
-
setKeepRows
public void setKeepRows(int rows) Description copied from interface:NBackupManagerSets the number of rows of backup history to keep (this includes the row created by the backup).Server-side, this option is mutually exclusive with
NBackupManager.setKeepDays(int), this is not enforced by the Java code.This option only has effect when
setCleanHistory(true)has been called.- Specified by:
setKeepRowsin interfaceNBackupManager- Parameters:
rows- number of rows to keep history when cleaning, or-1to clear current value- See Also:
-