as_sqlite_backend {mlr3db} | R Documentation |
Convert to SQLite Backend
Description
Converts to a DataBackendDplyr using a RSQLite database, depending on the input type:
-
data.frame
: Creates a new mlr3::DataBackendDataTable first usingmlr3::as_data_backend()
, then proceeds with the conversion from mlr3::DataBackendDataTable to DataBackendDplyr. -
mlr3::DataBackend: Creates a new SQLite data base in the specified path. The filename is determined by the hash of the mlr3::DataBackend. If the file already exists, a connection to the existing database is established and the existing files are reused.
The created backend automatically reconnects to the database if the connection was lost, e.g. because the object was serialized to the filesystem and restored in a different R session. The only requirement is that the path does not change and that the path is accessible on all workers.
Usage
as_sqlite_backend(data, path = getOption("mlr3db.sqlite_dir", ":temp:"), ...)
Arguments
data |
( |
path |
(
The default for this argument can be configured via option |
... |
( |
Value
DataBackendDplyr or mlr3::Task.