Class: Rubyfb::Backup
- Inherits:
-
Object
- Object
- Rubyfb::Backup
- Defined in:
- lib/src.rb
Overview
This class represents a service manager task to backup an existing database on the Firebird server. NOTE: This class does not currently work on the Mac OS X platform.
Instance Attribute Summary collapse
-
#backup_file ⇒ Object
Attribute accessor.
-
#database ⇒ Object
Attribute accessor.
Instance Method Summary collapse
-
#blocking_factor ⇒ Object
This method fetches the blocking factor to be used in generating the back up.
-
#blocking_factor=(size) ⇒ Object
This method sets the blocking factor to be used in generating the back up.
-
#convert_tables ⇒ Object
This method fetches the convert tables setting for a Backup object.
-
#convert_tables=(setting) ⇒ Object
This method is used to set the indicator for whether external tables will be converted to internal tables as part of the backup.
-
#execute(manager) ⇒ Object
This method is used to execute a backup task against a service manager.
-
#garbage_collect ⇒ Object
This method fetches the garbage collect setting for a Backup object.
-
#garbage_collect=(setting) ⇒ Object
This method is used to set the indicator for whether the backup will undertake garbage collection.
-
#ignore_checksums ⇒ Object
This method fetches the ignore checksums setting for a Backup object.
-
#ignore_checksums=(setting) ⇒ Object
This method is used to set the indicator for whether checksum values should be ignored in performing a backup.
-
#ignore_limbo ⇒ Object
This method fetches the ignore limbo setting for a Backup object.
-
#ignore_limbo=(setting) ⇒ Object
This method is used to set the indicator for whether limbo transactions should be ignored in performing a backup.
-
#initialize(database, file) ⇒ Backup
constructor
This is the constructor for the Backup class.
-
#log ⇒ Object
This method fetches the log value for a Backup task.
-
#metadata_only ⇒ Object
This method fetches the metadata only setting for a Backup object.
-
#metadata_only=(setting) ⇒ Object
This method is used to set the indicator for whether a backup stores only the database metadata.
-
#non_transportable ⇒ Object
This method fetches the non-transportable setting for a Backup object.
-
#non_transportable=(setting) ⇒ Object
This method is used to set the indicator for whether backup generated by the task will be platform specific.
Constructor Details
#initialize(database, file) ⇒ Backup
This is the constructor for the Backup class.
Parameters
- database
-
A String or File giving the path and name (relative to the database server) of the main database file for the database to be backed up.
- file
-
A String or File giving the path and name (relative to the database server) of the back up file to be generated.
1408 1409 |
# File 'lib/src.rb', line 1408 def initialize(database, file) end |
Instance Attribute Details
#backup_file ⇒ Object
Attribute accessor.
1393 1394 1395 |
# File 'lib/src.rb', line 1393 def backup_file @backup_file end |
#database ⇒ Object
Attribute accessor.
1393 1394 1395 |
# File 'lib/src.rb', line 1393 def database @database end |
Instance Method Details
#blocking_factor ⇒ Object
This method fetches the blocking factor to be used in generating the back up. This will return nil until it has been explicitly set.
1416 1417 |
# File 'lib/src.rb', line 1416 def blocking_factor end |
#blocking_factor=(size) ⇒ Object
This method sets the blocking factor to be used in generating the back up.
Parameters
- size
-
A reference to an integer containing the new back up blocking factor setting.
1428 1429 |
# File 'lib/src.rb', line 1428 def blocking_factor=(size) end |
#convert_tables ⇒ Object
This method fetches the convert tables setting for a Backup object.
1525 1526 |
# File 'lib/src.rb', line 1525 def convert_tables end |
#convert_tables=(setting) ⇒ Object
This method is used to set the indicator for whether external tables will be converted to internal tables as part of the backup.
Parameters
- setting
-
True to convert external tables, false otherwise.
1536 1537 |
# File 'lib/src.rb', line 1536 def convert_tables=(setting) end |
#execute(manager) ⇒ Object
This method is used to execute a backup task against a service manager.
Parameters
- manager
-
A reference to the service manager to execute the backup task against.
Exceptions
- FireRubyException
-
Generated whenever a disconnected service manager is specified or a problem occurs executing the task.
1552 1553 |
# File 'lib/src.rb', line 1552 def execute(manager) end |
#garbage_collect ⇒ Object
This method fetches the garbage collect setting for a Backup object.
1489 1490 |
# File 'lib/src.rb', line 1489 def garbage_collect end |
#garbage_collect=(setting) ⇒ Object
This method is used to set the indicator for whether the backup will undertake garbage collection.
Parameters
- setting
-
True to perform garbage collection, false otherwise.
1500 1501 |
# File 'lib/src.rb', line 1500 def garbage_collect=(setting) end |
#ignore_checksums ⇒ Object
This method fetches the ignore checksums setting for a Backup object.
1435 1436 |
# File 'lib/src.rb', line 1435 def ignore_checksums end |
#ignore_checksums=(setting) ⇒ Object
This method is used to set the indicator for whether checksum values should be ignored in performing a backup.
Parameters
- setting
-
True to ignore checksums, false otherwise.
1446 1447 |
# File 'lib/src.rb', line 1446 def ignore_checksums=(setting) end |
#ignore_limbo ⇒ Object
This method fetches the ignore limbo setting for a Backup object.
1453 1454 |
# File 'lib/src.rb', line 1453 def ignore_limbo end |
#ignore_limbo=(setting) ⇒ Object
This method is used to set the indicator for whether limbo transactions should be ignored in performing a backup.
Parameters
- setting
-
True to ignore limbo transactions, false otherwise.
1464 1465 |
# File 'lib/src.rb', line 1464 def ignore_limbo=(setting) end |
#log ⇒ Object
This method fetches the log value for a Backup task. This value will always be nil until the task has been executed. After a successful execution the log value should contain output from the backup task generated on the server.
1562 1563 |
# File 'lib/src.rb', line 1562 def log end |
#metadata_only ⇒ Object
This method fetches the metadata only setting for a Backup object.
1471 1472 |
# File 'lib/src.rb', line 1471 def end |
#metadata_only=(setting) ⇒ Object
This method is used to set the indicator for whether a backup stores only the database metadata.
Parameters
- setting
-
True to store only metadata, false otherwise.
1482 1483 |
# File 'lib/src.rb', line 1482 def (setting) end |
#non_transportable ⇒ Object
This method fetches the non-transportable setting for a Backup object.
1507 1508 |
# File 'lib/src.rb', line 1507 def non_transportable end |
#non_transportable=(setting) ⇒ Object
This method is used to set the indicator for whether backup generated by the task will be platform specific.
Parameters
- setting
-
True to generate a platform specific backup, false otherwise.
1518 1519 |
# File 'lib/src.rb', line 1518 def non_transportable=(setting) end |