MINI MINI MANI MO

%
% Copyright (c) 2012, 2015, Oracle and/or its affiliates. All rights reserved.
%
\name{ore.save}
\alias{ore.save}
\title{
Oracle R Enterprise - Datenspeicherspeicherfunktion
}
\description{
Speichert \R-Objekte in einem Datenspeicher im Oracle Database-Schema des Benutzers.
}
\usage{
ore.save(..., list = character(0), 
         name = stop("parameter 'name' must be specified"), 
         grantable = FALSE,
         envir = parent.frame(), overwrite = FALSE, append = FALSE, 
         description = character(0),
         envAsEmptyenv = getOption("ore.envAsEmptyenv", FALSE))
}
\arguments{
  \item{...}{
Die Namen der \R-Objekte, die gespeichert werden müssen (als Symbole oder
    Zeichenfolgen).
}
  \item{list}{
Ein Zeichenvektor, der die Namen der zu speichernden \R-Objekte enthält.
}
  \item{name}{
Eine Zeichenfolge, die den Namen des Datenspeichers angibt, in dem die
    \R-Objekte gespeichert werden sollen.
}
  \item{grantable}{
Ein skalarer logischer Wert, der angibt, ob ein neuer Datenspeicher erstellt
    werden soll, für den die Leseberechtigung an andere Benutzer erteilt werden kann.
    Argument \code{grantable} wird ignoriert, wenn es mit Argument 
    \code{overwrite} oder \code{append} angegeben wird.
}
  \item{envir}{
Eine Umgebung, in der nach den zu speichernden \R-Objekten gesucht werden muss.
}
  \item{overwrite}{
Ein logischer Wert, der angibt, ob der Datenspeicher überschrieben werden soll, 
    wenn er bereits vorhanden ist.
}
  \item{append}{
Ein logischer Wert, der angibt, ob die \R-Objekte an dem Datenspeicher
    angehängt werden sollen, wenn er bereits vorhanden ist.
}
  \item{description}{
Eine Zeichenfolge, die maximal 2000 Zeichen enthält, die als
    Kommentare für den Datenspeicher verwendet werden müssen.
}
  \item{envAsEmptyenv}{
Ein logischer Wert, der angibt, ob referenzierte Umgebungen
     in den zu speichernden \R-Objekten bei der Serialisierung durch
     eine leere Umgebung ersetzt werden sollen. Wenn \code{TRUE}, wird die referenzierte
     Umgebung in den Objekten durch eine leere
     Umgebung ersetzt, deren übergeordnetes Objekt \code{.GlobalEnv} ist. Daher wird der
     Content in der ursprünglich referenzierten Umgebung nicht
     serialisiert und in der Datenbank gespeichert. In einigen Situationen könnte dadurch
     die Größe der gespeicherten Objekte erheblich verringert werden. Wenn
     \code{FALSE}, wird der Content in der referenzierten Umgebung serialisiert
     und gespeichert und kann durch Aufruf von
     \code{ore.load} deserialisiert und in den Arbeitsspeicher geladen werden. Der Standardwert
     wird von der globalen Option \code{ore.envAsEmptyenv} gesteuert.
}
}


\details{
Funktion \code{ore.save} speichert die \R-Objekte aus Argument \code{...}
  oder aufgeschlüsselt in Argument \code{list} für den Abruf aus Umgebung
  \code{envir} in dem Datenspeicher, der in Argument \code{name} des Oracle 
  Database-Schemas angegeben wird. Nicht vorhandene \R-Objekte, die
  in Argument \code{list} referenziert werden, werden ignoriert. Wenn keine \R-Objekte,
  die in Argument \code{list} angegeben werden, in Umgebung \code{envir} vorhanden sind, 
  löst die Funktion einen Fehler aus.
  Standardmäßig werden \R-Objekte in einem neuen Datenspeicher mit den angegebenen
  \code{name} gespeichert. Argumente \code{overwrite} und \code{append} können zur Speicherung von \R-Objekten
  in einem vorhandenen Datenspeicher verwendet werden, jedoch nur eines der
  Argumente kann \code{TRUE} sein.
  Kommentare können über Argument \code{description} zu dem Datenspeicher hinzugefügt 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.load}},
  \code{\link{ore.delete}},
  \code{\link{ore.datastore}},
  \code{\link{ore.datastoreSummary}}
  \code{\link[OREbase]{ore.options}}
}

\examples{
if (any(sapply(c("x", "y", "z"), exists))) 
  stop("object x, y, or z 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")

# overwrite existing datastore rq$ds_1 with object x, y in 
# the current workspace environment 
ore.save(x, y, name="rq$ds_1", overwrite=TRUE)

# add object z in the current workspace environment to 
# the existing datastore rq$ds_1 
ore.save(z, name="rq$ds_1", append=TRUE)

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