MINI MINI MANI MO

%
% Copyright (c) 2012, 2014, Oracle and/or its affiliates. All rights reserved. 
%
\name{ore.sync}
\alias{ore.sync}
\title{
Oracle R Enterprise 对象同步函数
}
\description{
在 Oracle R Enterprise 会话中的
  方案的 \R \code{\linkS4class{ore.frame}} 中同步
  表示数据库表, 视图和查询的
  \code{\link[base]{environment}} 对象。
}
\usage{
ore.sync(schema, table = NULL, use.keys = TRUE, query = NULL)
}
\arguments{
  \item{schema}{
一个用于指定数据库方案名的字符串。不
    支持使用参数 \code{query}。
}
  \item{table}{
一个可选字符向量, 用于指定要用于 \code{\linkS4class{ore.frame}} 对象创建的
    数据库表或视图的名称。
}
  \item{use.keys}{
一个逻辑值, 用于指定主键 (如果存在) 是否
    应当用于构建排序的
    \code{\linkS4class{ore.frame}} 对象。
}
  \item{query}{
一个可选命名字符向量, 指定要用于 \code{\linkS4class{ore.frame}} 对象
    创建操作的查询。元素名称
    用作默认方案的 \R \code{\linkS4class{ore.frame}} 中的 \code{\link[base]{environment}} 对象
    的名称。
}
}



\details{
Oracle R Enterprise 在与数据库方案中的表或视图
  对应的 \R 中创建代理对象。这些代理对象包含
  由 Oracle R Enterprise 内部使用以提供
  透明层功能的元数据。
  默认情况下, 函数 \code{ore.sync} 使用在
  \code{\link{ore.connect}} 时提供的方案。\code{schema} 参数可用于
  选择用户具有合适访问权限的
  不同方案。
  当 \code{table} 和 \code{query} 参数是
  \code{NULL} 函数调用中的 \code{ore.sync} 时, 将选择名称
  不包含 \code{$} 或以 \code{SYS_} 开头的
  所有表和视图。选择数据库方案中所有表的开销
  可能会很大, 因此建议的做法是将
  \code{table} 或 \code{query} 参数设置为限制在
  Oracle R Enterprise 方案环境中所呈现表和视图
  的数量。
  如果参数 \code{use.keys} 设置为 \code{FALSE} 或者表
  没有主键, 则对应的 \code{\linkS4class{ore.frame}}
  对象将不排序; 否则将排序。对于
  \code{\linkS4class{ore.frame}} 对象上的许多操作 (例如
  \code{colMeans}), 行顺序并不重要。但是,
  对于需要行排序的操作 (例如 \code{diff}),
  则将发布错误消息, 说明排序信息
  不可用。可以在 \code{\linkS4class{ore.frame}} 对象上将其行名称
  设置为其一列或多列来强制进行
  行排序。
}
\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.attach}},
  \code{\link{ore.connect}},
  \code{\link{ore.exists}},
  \code{\link{ore.get}},
  \code{\link{ore.ls}},
  \code{\link{ore.rm}},
  \code{\link{row.names<-}}
}
\examples{
if (!interactive())
{
  ore.sync()
  ore.sync("RQUSER", use.keys = FALSE)
  ore.exec("create table TABLE1 as select * from dual")
  ore.exec("create table TABLE2 as select * from dual")
  ore.sync(table = c("TABLE1", "TABLE2"))
  ore.sync("RQUSER", table = c("TABLE1", "TABLE2"))
  ore.sync(query = c("QUERY1" = "select 0 X, 1 Y from dual",
                     "QUERY2" = "select 1 X, 0 Y from dual"))
  ore.drop("TABLE1")
  ore.drop("TABLE2")
}
}
\keyword{environment}
\keyword{database}
\keyword{ORE}