MINI MINI MANI MO

%
% Copyright (c) 2012, 2015, Oracle and/or its affiliates. All rights reserved.
%
\name{ore.load}
\alias{ore.load}
\title{
Oracle R Enterprise 数据存储加载函数
}
\description{
从用户 Oracle 数据库方案中的数据存储加载 \R 对象。
}
\usage{
  ore.load(name, list = character(0), owner, envir = parent.frame())
}
\arguments{
  \item{name}{
一个用于指定数据存储名称的字符串。
}
  \item{list}{
可选字符向量, 其中包含数据存储中要加载的
    \R 对象的名称。如果未指定此参数, 
    则将加载数据存储中的所有 \R 对象。
}
  \item{owner}{
一个可选字符串, 指定要加载的数据存储的
    所有者。如果数据存储的所有者不是当前用户, 
    则必须由 \code{\link{ore.grant}} 将数据存储的读取权限授予当前
    用户; 否则将出现 \code{\link{ore.load}} 错误。
    如果未指定 \code{owner} 参数, 则默认值为
    当前用户。
}
  \item{envir}{
在其中要加载 \R 对象的环境。
}
}
\details{
函数 \code{\link{ore.save}} 和 \code{ore.load} 与 \\pkg{base} 程序包中
  函数 \code{\link[base]{save}} 和 \code{\link[base]{load}} 相似的方式
  共同操作。而
  \code{\link[base]{save}} 和 \code{\link[base]{load}} 函数通过外部文件
  来保存和加载 \R 对象,
  \code{\link{ore.save}} 和 \code{ore.load} 函数从数据存储
  保存和加载 \R 对象。
}
\value{
函数 \code{ore.load} 返回指定从数据存储
  向环境 \code{envir} 加载的 \R 对象名称的
  字符向量。
}
\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.lazyLoad}}
  \code{\link{ore.grant}}
  \code{\link{ore.revoke}}
}
\examples{
if (any(sapply(c("x", "y", "z", "e"), exists))) 
  stop("object x, y, z, or e exists")

x <- stats::runif(20)
y <- list(a = 1, b = TRUE, c = "oops")
z <- ore.push(x)

# save all objects in the current workspace environment to 
# a datastore with name 'rq$ds_1' in the user's schema
ore.save(list = ls(), name = "rq$ds_1")
rm(x, y, z)

# load all objects from datastore rq$ds_1 to current workspace
ore.load(name = "rq$ds_1")
ls()

# load x and y from datastore rq$ds_1 to environment e
e <- new.env()
ore.load(name = "rq$ds_1", list = c("x", "y"), envir = e)
ls(envir = e)

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