MINI MINI MANI MO

%
% Copyright (c) 2012, 2014, Oracle and/or its affiliates. All rights reserved. 
%
\name{ore.exec}
\alias{ore.exec}
\title{SQL Query Execution Function}
\description{
  Executes the specified SQL query in the user's Oracle Database schema.
}
\usage{
ore.exec(qry)
}
\arguments{
  \item{qry}{
    A character string specifying the SQL statement.
  }
}
\details{
  The \code{ore.exec} function is intended for use with data definition
  language (DDL) type statements, such as CREATE TABLE, that have no
  return value.

  If the \code{ore.exec} function call creates a table in the user's
  Oracle Database schema, a corresponding \code{\linkS4class{ore.frame}}
  object is not created unless the user invokes function
  \code{\link{ore.sync}}. To avoid refreshing all
  \code{\linkS4class{ore.frame}} objects, the name of the table can be
  explicitly provided.
}
\value{
  Returns an invisible \code{NULL} value.
}
\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.sync}},
  \code{\link[DBI]{dbGetQuery}}
}
\examples{
if (!interactive())
{
  ore.exec("create table TEST_CREATE as select * from dual")
  ore.exists("TEST_CREATE")      # table not found
  ore.sync(table="TEST_CREATE")  # sync metadata of new table only
  ore.exists("TEST_CREATE")      # table TEST_CREATE is present
  ore.drop(table="TEST_CREATE")  # clean up
  ore.exists("TEST_CREATE")
}
}
\keyword{database}
\keyword{ORE}