MINI MINI MANI MO

%
% Copyright (c) 2012, 2014, Oracle and/or its affiliates. All rights reserved. 
%
\name{ore.get}
\alias{ore.get}
\title{Oracle R Enterprise Object Retrieval Function}
\description{
  Retrieves the specified \code{\linkS4class{ore.frame}} object,
  representing a database table or view, from the \R
  \code{\link[base]{environment}} for a schema in the Oracle R
  Enterprise session.
}
\usage{
ore.get(name, schema)
}
\arguments{
  \item{name}{
    A character string specifying the name of the
    \code{\linkS4class{ore.frame}} object.
  }
  \item{schema}{
    A character string specifying the database schema name.
  }
}
\details{
  If argument \code{schema} is unspecified, a searches is conducted
  across the attached \R environments for the schemas in the Oracle R
  Enterprise session, according to the search list order, and returns
  the first object instance found.
}
\value{
  If found within argument \code{schema}, returns an
  \code{\linkS4class{ore.frame}} object. If not found, an error is
  produced.
}
\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.ls}},
  \code{\link{ore.rm}},
  \code{\link{ore.sync}}
}
\examples{
if (!interactive())
{
  ore.create(data.frame(x=3, y="A", z=TRUE), table = "TABLE_GET")
  # search in the default schema
  ore.get("TABLE_GET")
  # search in the specified schema
  ore.get("TABLE_GET", "RQUSER")
  ore.drop(table = "TABLE_GET")
}
}
\keyword{data}
\keyword{database}
\keyword{ORE}