MINI MINI MANI MO

%
% Copyright (c) 2012, 2015, Oracle and/or its affiliates. All rights reserved.
%
\name{ore.datastore}
\alias{ore.datastore}
\title{
Oracle R Enterprise 데이터 저장소 나열 함수
}
\description{
사용자의 Oracle Database 스키마에 있는 기존 데이터 저장소를 나열합니다.
}
\usage{
ore.datastore(name, pattern, type = c("user", "private", "all", 
                                      "grantable", "grant", "granted"))
}
\arguments{
  \item{name}{
데이터 저장소 이름을 지정하는 선택적 문자열니다.
    \code{pattern} 인수에 사용할 수 없습니다.
}
  \item{pattern}{
일치하는 데이터 저장소 이름을 지정하는 선택적 정규 표현식
    문자열입니다. \code{name} 인수에 사용할 수 없습니다.
}
  \item{type}{
나열할 데이터 저장소 유형을 지정하는 선택적인 스칼라 
    문자열입니다. 적합한 값은 'user'(기본값), 'private', 'all', 
    'grantable', 'grant' 또는 'granted'입니다.
    'user'에는 현재 세션 사용자가 생성한 데이터 저장소가 나열됩니다.
    'private'에는 현재 세션 사용자가 읽기 권한을
    다른 사용자에게 부여한 데이터 저장소가 나열됩니다.
    'all'에는 현재 세션 사용자가 읽기 액세스 권한을 갖고 있는 모든 데이터 저장소가
    나열됩니다.
    'grantable'에는 현재 세션 사용자가 다른 사용자에게 읽기 권한을
    부여할 수 있는 데이터 저장소가 나열됩니다.
    'grant'에는 현재 세션 사용자가 다른 사용자에게 읽기 권한을 
    부여한 데이터 저장소가 나열됩니다.
    'granted'에는 다른 사용자가 현재 세션 사용자에게 읽기 권한을 
    부여한 데이터 저장소가 나열됩니다.
}
}
\details{
\code{ore.datastore} 함수는 사용자의 Oracle Database 스키마에 있는
  데이터 저장소에 대해 고급 레벨의 정보를 나열합니다. 이 데이터 저장소
  목록은 선택적으로 \code{name} 또는 \code{pattern} 인수를 사용하여
  필터링할 수 있습니다.
}
\value{
\code{data.frame} 객체는 \code{datastore.name} 인수가 'user', 'private'
  또는 'grantable'인
  경우 \code{object.count}, \code{size}, \code{creation.date}, \code{description} 및 \code{type} 
  열과 함께 반환됩니다. 이러한 열은 데이터 저장소 이름,
  이름이 지정된 데이터 저장소의 객체 수, 데이터 저장소 크기(바이트),
  데이터 저장소 생성 날짜 및 데이터 저장소 주석을 각각
  지정합니다. 
  \code{data.frame} 인수가 'all' 또는 'granted'인 경우 \code{owner} 출력에는 
  데이터 저장소의 소유자를 지정하는 추가 열 \code{type}이(가) 포함됩니다.
  \code{type} 인수가 'grant'인 경우 \code{data.frame} 출력에는
  데이터 저장소 이름 및 현재 세션 사용자에 의해 
  이름이 지정된 데이터 저장소에 대한 읽기 권한이 부여된 다른 사용자의 
  이름을 지정하는 \code{datastore.name} 및 \code{grantee} 열이 포함됩니다. 
  \code{data.frame} 객체의 행은 \code{owner} 및 \code{datastore.name}(제공된 경우) 열에 
  따라 알파벳 순서로 정렬됩니다.
}
\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.load}},
  \code{\link{ore.delete}},
  \code{\link{ore.datastoreSummary}}
  \code{\link{ore.grant}}
  \code{\link{ore.revoke}}
}
\examples{
\dontshow{
if (!interactive())
    ore.connect(user     = Sys.getenv("ORE_USERNAME", "rquser"),
                sid      = Sys.getenv("ORACLE_SID"),
                host     = Sys.getenv("HOST"),
                password = Sys.getenv("ORE_PASSWORD", "rquser"),
                port  = if (.Platform$OS.type == "windows")
                           Sys.getenv("ORACLE_PORT")
                        else
                           Sys.getenv("TCPPORT"),
                all = TRUE)
}

if (!interactive())
{
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)

ore.save(list=ls(), name="rqds_1")
ore.save(x, y, name="rqds_2")
ore.save(z, name="rqds_3", grantable=TRUE)

# list overall information about the datastores in user's schema
ds <- ore.datastore()
\dontrun{
ds
}
\dontshow{
ds[, -(3L:4L)]
}

# list overall information about the datastores available in the user's schema
ds <- ore.datastore(type="all")
\dontrun{
ds
}
\dontshow{
ds[, -(3L:4L)]
}

# list overall information about the datastore the read privilege for which
# can be granted
ds <- ore.datastore(type="grantable")
\dontrun{
ds
}
\dontshow{
ds[, -(3L:4L)]
}

# list overall information about the datastore with name 'rqds_1'
ds <- ore.datastore(name="rqds_1")
\dontrun{
ds
}
\dontshow{
ds[, -(3L:4L)]
}

# list overall information about the datastores whose name starts
# with 'rqds_'
ds <- ore.datastore(pattern="^rqds_")
\dontrun{
ds
}
\dontshow{
ds[, -(3L:4L)]
}

sapply(c("rqds_1", "rqds_2", "rqds_3"), ore.delete)
rm(x, y, z)
}
}
\keyword{datastore}
\keyword{database}
\keyword{ORE}