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 - Funzione di salvataggio del data store
}
\description{
Salva gli oggetti \R contenuti in un data store nello schema del database Oracle dell'utente.
}
\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{...}{
I nomi degli oggetti \R da salvare (sotto forma di simboli o stringhe
    di caratteri).
}
  \item{list}{
Vettore di caratteri che contiene i nomi degli oggetti \R da salvare.
}
  \item{name}{
Stringa di caratteri che specifica il nome del data store in cui salvare
    gli oggetti \R.
}
  \item{grantable}{
Valore logico scalare che specifica se creare un nuovo data store
    per il quale sarà possibile concedere il privilegio di lettura ad
    altri utenti. L'argomento \code{grantable} viene ignorato quando utilizzato 
    con l'argomento \code{overwrite} o \code{append}.
}
  \item{envir}{
Ambiente in cui cercare gli oggetti \R da salvare.
}
  \item{overwrite}{
Valore logico che specifica se sovrascrivere il data store nel caso
    esista già.
}
  \item{append}{
Valore logico che specifica se aggiungere gli oggetti \R al data store
    nel caso esista già.
}
  \item{description}{
Stringa di caratteri costituita da non più di 2000 caratteri
    da utilizzare come commento per il data store.
}
  \item{envAsEmptyenv}{
Valore logico che indica se gli ambienti cui si fa riferimento
     negli oggetti \R da salvare devono essere sostituiti con un
     ambiente vuoto durante la serializzazione, Se \code{TRUE}, l'ambiente
     cui si fa riferimento negli oggetti verrà sostituito da un ambiente
     vuoto il cui padre è \code{.GlobalEnv} e, peranto, il contenuto
     dell'ambiente originale cui si fa riferimento non verrà
     serializzato e salvato nel database. In alcune situazioni, ciò
     può ridurre in modo significativo la dimensione degli oggetti salvati.
     Se \code{FALSE}, il contenuto dell'ambiente cui si fa riferimento verrà
     serializzato e salvato e sarà possibile annullarne la serializzazione
     e caricarlo in memoria quando si richiama \code{ore.load}. Il valore predefinito
     viene regolato dall'opzione globale \code{ore.envAsEmptyenv}.
}
}


\details{
La funzione \code{ore.save} salva gli oggetti \R dell'argomento \code{...},
  o quelli elencati separatamente nell'argomento \code{list} per il recupero
  dall'ambiente \code{envir}, nel data store specificato nell'argomento \code{name}
  dello schema del database Oracle dell'utente. Gli oggetti \R inesistenti
  ai quali si fa riferimento nell'argomento \code{list} vengono ignorati.
  Se non esiste alcuno degli oggetti \R specificati nell'argomento \code{list}
  nell'ambiente \code{envir}, la funzione restituisce un errore.
  Per impostazione predefinita, gli oggetti \R vengono salvati in un nuovo
  data store con il \code{name} specificato. Gli argomenti \code{overwrite} e \code{append} possono
  essere utilizzati per salvare gli oggetti \R in un data store esistente, ma solo
  uno di essi può essere \code{TRUE}.
  L'argomento \code{description} consente di aggiungere commenti al data store.
}
\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}