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 - Datenspeicherladefunktion
}
\description{
Lädt \R-Objekte aus einem Datenspeicher in das Oracle Database-Schema des Benutzers.
}
\usage{
  ore.load(name, list = character(0), owner, envir = parent.frame())
}
\arguments{
  \item{name}{
Eine Zeichenfolge, die den Namen des Datenspeichers angibt.
}
  \item{list}{
Ein optionaler Zeichenvektor, der die Namen der \R-Objekte innerhalb des
    Datenspeichers enthält, die geladen werden müssen. Wenn dieses Argument nicht angegeben
    wird, werden alle \R-Objekte innerhalb des Datenspeichers geladen.
}
  \item{owner}{
Eine optionale Zeichenfolge, die den Eigentümer des zu ladenden Datenspeichers angibt.
    Wenn der Eigentümer des Datenspeichers nicht der aktuelle Benutzer ist, muss die Leseberechtigung 
    für den Datenspeicher von \code{\link{ore.grant}} an den aktuellen Benutzer 
    erteilt werden. Andernfalls wird \code{\link{ore.load}} mit einem Fehler beendet.
    Wenn das Argument \code{owner} nicht angegeben wird, ist der Standardwert 
    der aktuelle Benutzer.
}
  \item{envir}{
Die Umgebung, in der die \R-Objekte geladen werden sollen.
}
}
\details{
Die Funktionen \code{\link{ore.save}} und \code{ore.load} arbeiten ähnlich wie
  die Funktionen \code{\link[base]{save}} und \code{\link[base]{load}} aus dem
  \\pkg{base}-Package zusammen. Während die 
  \code{\link[base]{save}}- und \code{\link[base]{load}}-Funktionen \R-Objekte in bzw. aus 
  einer externen Datei speichern und laden, speichern
  und laden die \code{\link{ore.save}}- und \code{ore.load}-Funktionen \R-Objekte
  aus einem Datenspeicher.
}
\value{
Funktion \code{ore.load} gibt einen Zeichenvektor zurück, der die Namen der
  \R-Objekte angibt, die im aus dem Datenspeicher in die
  Umgebung \code{envir}.geladen werden.
}
\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}