MINI MINI MANI MO

%
% Copyright (c) 2013, 2014, Oracle and/or its affiliates. All rights reserved. 
%
\name{ore.lazyLoad}
\alias{ore.lazyLoad}
\title{Oracle R Enterprise Datastore Lazy Loading Function}
\description{
  Lazy (just in time) loads \R objects from the named Oracle R Enterprise
  datastore in the user's Oracle Database schema.
}
\usage{
  ore.lazyLoad(name, list = character(0), envir = parent.frame())
}
\arguments{
  \item{name}{
    A character string specifying the name of the datastore.
  }
  \item{list}{
    An optional character vector containing the names of the objects
    within the datastore to lazy load. If this argument is not specified,
    then all of the objects within the datastore will be lazy loaded.
  }
  \item{envir}{
    The environment into which the objects are to be lazy loaded.
  }
}
\details{
  Unlike the \code{\link{ore.load}} function, the \code{ore.lazyLoad}
  function does not immediately retrieve the specified objects from an
  Oracle R Enterprise datastore. Instead objects are retrieved upon
  first reference to the object. See examples below for implications of
  lazy loading.
}
\value{
  Function \code{ore.lazyLoad} returns a character vector specifying the
  names of objects that are lazy loaded from the datastore.
}
\references{
  \href{http://www.oracle.com/technetwork/database/database-technologies/r/r-enterprise/documentation/index.html}{Oracle R Enterprise}
}
\author{
  Oracle \email{oracle-r-enterprise@oracle.com}
}
\seealso{
  \code{\link{ore.save}},
  \code{\link{ore.delete}},
  \code{\link{ore.datastore}},
  \code{\link{ore.datastoreSummary}},
  \code{\link{ore.load}}
}
\examples{
# save object to new datastore
x <- 1:10
ore.save(x, name = "rq$ds_1")

# enable lazy loading of object
e <- new.env()
ore.lazyLoad(name = "rq$ds_1", envir = e)
bindingIsActive("x", e)

# load object
e$x
bindingIsActive("x", e)

# re-enable lazy loading
ore.lazyLoad(name = "rq$ds_1", envir = e)
bindingIsActive("x", e)

# overwrite object in datastore
x <- letters
ore.save(x, name = "rq$ds_1", overwrite = TRUE)

# load updated object
e$x
bindingIsActive("x", e)

# clean up
rm(x, e)
ore.delete(name = "rq$ds_1")
}
\keyword{datastore}
\keyword{database}
\keyword{ORE}