MINI MINI MANI MO

%
% Copyright (c) 2012, 2014, Oracle and/or its affiliates. All rights reserved. 
%
%    NAME
%      ore.create.Rd - Create and Drop Data from the User's Oracle Schema
%
%    DESCRIPTION
%      Create an Oracle Database table from a data.frame or ore.frame
%      object, or a view from an ore.frame object. Drop a database table
%      or view.
%
%    NOTES
%
%    MODIFIED  (MM/DD/YY)
%    demukhin   11/02/12 - bug 14729804: document row names
%
\name{ore.create}
\alias{ore.create}
\alias{ore.create,data.frame-method}
\alias{ore.create,ore.frame-method}
\alias{ore.drop}
\title{
数据库表创建或析构函数
}

\description{
从 \code{data.frame} 或 \code{ore.frame} 对象创建 Oracle 数据库表,
  或者从 \code{ore.frame} 对象创建视图。
  删除数据库表或视图。
}
\usage{
ore.create(x, table = NULL, view = NULL)
ore.drop(table = NULL, view = NULL)
}
\arguments{
  \item{x}{
\code{\linkS4class{ore.frame}} 对象。如果使用参数
    \code{\link[base]{data.frame}}, 则也可为 \code{table}。
}
  \item{table}{
一个用于指定表名称的字符串。此参数
    不能与参数 \code{view} 一起使用。
}
  \item{view}{
一个用于指定视图名称的字符串。此参数
    不能与参数 \code{table} 一起使用。
}
}




\details{
必须且只能指定参数 \code{table} 或 \code{view} 中的一个,
  具体取决于需要创建或删除的是
  数据库表还是视图。
  如果新对象是使用函数 \code{ore.create} 创建的, 它将
  自动包括在可通过 \code{ore.get} 和 \code{ore.ls} 函数
  访问的对象列表中。如果已经调用了 \code{ore.frame},
  则它还将添加到已挂接 \code{ore.attach} 对象的
  列表中。另外, 对于函数 \code{ore.create} 来说, 
  只有 \code{\linkS4class{ore.frame}} 对象可以与 \code{view} 参数
  一起使用。
  与此类似, 使用函数 \code{ore.drop} 删除了对象时,
  它不会显示在 \code{ore.ls} 函数的输出中。它还将
  从已挂接 \code{ore.frame} 对象的列表中删除。
  如果输入对象包含与后端服务器命名惯例不符的
  列名, 则将由 \code{ore.make.names} 函数修改这些 
  修改。
  函数 \code{ore.create} 在数据库表和新创建的
  \code{row.names} 对象中均不保留 \code{ore.frame}。
}
\value{
函数 \code{ore.create} 和 \code{ore.drop} 均返回
  不可见的 \code{NULL} 值。
}
\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.ls}},
  \code{\link{ore.exists}},
  \code{\link{ore.sync}},
  \code{\link{ore.rm}},
  \code{\link{ore.attach}},
  \code{\link{ore.connect}}
}
\examples{
if (!interactive())
{
  ore.drop(table = "TEN_LETTERS")
  ore.drop(table = "IRIS_TABLE")
  ore.drop(view = "IRIS_VIEW")

  ore.create(data.frame(x = 1:10, y = letters[1:10]),
             table = "TEN_LETTERS")
  ore.exists("TEN_LETTERS")

  ore.create(iris, table = "IRIS_TABLE")
  ore.create(head(ore.get("IRIS_TABLE"), 10), view = "IRIS_VIEW")
  ore.exists("IRIS_VIEW")

  ore.drop(table = "TEN_LETTERS")
  ore.drop(table = "IRIS_TABLE")
  ore.drop(view = "IRIS_VIEW")
}
}
\keyword{environment}
\keyword{database}
\keyword{ORE}