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 데이터 저장소 저장 함수
}
\description{
사용자의 Oracle Database 스키마에 있는 데이터 저장소에 \R 객체를 저장합니다.
}
\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{...}{
심볼 또는 문자열로 저장할 \R 객체의
    이름입니다.
}
  \item{list}{
저장할 \R 객체의 이름이 포함된 문자 벡터입니다.
}
  \item{name}{
\R 객체를 저장할 데이터 저장소의 이름을 지정하는
    문자열입니다.
}
  \item{grantable}{
다른 사용자에게 부여할 수 있는 새 데이터 저장소 읽기 권한을
    생성할지 여부를 지정하는 스칼라 논리 값입니다.
    \code{grantable} 인수는 \code{overwrite} 또는 \code{append} 인수와 함께 사용할 경우 
    무시됩니다.
}
  \item{envir}{
저장할 \R 객체를 검색할 환경입니다.
}
  \item{overwrite}{
데이터 저장소가 존재할 경우 이를 겹쳐쓸지 여부를 지정하는
    논리 값입니다.
}
  \item{append}{
데이터 저장소가 존재할 경우 여기에 \R 객체를 첨부할지 여부를
    지정하는 논리 값입니다.
}
  \item{description}{
데이터 저장소에 대한 설명으로 사용할 2000자 미만의 설명이 포함된
    문자열입니다.
}
  \item{envAsEmptyenv}{
저장될 \R 객체의 참조된 환경이 직렬화 동안
     빈 환경으로 바뀌어야 할지 여부를 나타내는 논리 값입니다.
     \code{TRUE}의 경우 객체의 참조된 환경은
     상위가 \code{.GlobalEnv}인 빈 환경으로 바뀌므로
     원본 참조된 환경의 콘텐츠가
     직렬화되지 않고 데이터베이스에 저장되지
     않습니다. 이렇게 할 때 저장된 객체의 크기가
     상당히 줄어드는 경우도 있습니다. \code{FALSE}의 경우
     참조된 환경의 콘텐츠는 직렬화되고 저장되며,
     \code{ore.load}을(를) 호출할 때 직렬화 해제되고 메모리에
     로드될 수 있습니다. 기본값은 전역 옵션
     \code{ore.envAsEmptyenv}(으)로 제어됩니다.
}
}


\details{
\code{ore.save} 함수는 \code{...} 환경에서 검색을 위해 \code{list}
  인수에 항목화되었거나 \code{envir} 인수에서 가져온 \R
  객체를 사용자의 Oracle Database 스키마의 \code{name} 인수에
  지정된 데이터 저장소에 저장합니다. \code{list} 인수에 참조되는
  존재하지 않는 \R 객체는 무시됩니다. \code{list} 인수에 지정된
  \R 객체가 \code{envir} 환경에 존재하지 않을 경우 이 함수는
  오류를 발생시킵니다.
  기본적으로 \R 객체는 지정된 \code{name}의 새 데이터 저장소에
  저장됩니다. \code{overwrite} 및 \code{append} 인수를 사용하여 \R
  객체를 기존 데이터 저장소에 저장할 수 있지만 이들 중 하나만 \code{TRUE}일
  수 있습니다.
  설명은 \code{description} 인수를 통해 데이터 저장소에 추가할 수 있습니다.
}
\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}