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 数据库方案中的现有数据存储。
}
\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 数据库
  方案中数据存储的高级信息。此数据存储
  列表以选择按照 \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}