MINI MINI MANI MO

%
% Copyright (c) 2012, 2014, Oracle and/or its affiliates. All rights reserved. 
%
\name{ore.attach}
\alias{ore.attach}
\alias{ore.detach}
\title{Oracle R Enterprise Environment Management Functions}
\description{
  Attaches or detaches the \R \code{\link[base]{environment}} of the
  named schema to or from the \R \code{\link[base]{search}} path in the
  Oracle R Enterprise session. When the \R
  \code{\link[base]{environment}} is attached to the \R search path, the
  corresponding \code{\linkS4class{ore.frame}} objects, representing
  database tables and views, in the schema can be accessed directly by
  name.
}
\usage{
ore.attach(schema, pos = 2, warn.conflicts = TRUE)
ore.detach(schema)
}
\arguments{
  \item{schema}{
    A character string specifying the database schema name.
  }
  \item{pos}{
    An integer value larger than 1 specifying the position in the \R
    \code{\link[base]{search}} path.
  }
  \item{warn.conflicts}{
    A logical value indicating whether or not warnings should be printed for
    \code{\link[base]{conflicts}}, objects that share the same name,
    that result from attaching the \R \code{\link[base]{environment}}.
  }
}
\details{
  If argument \code{schema} is unspecified, the default schema - the one
  specified at connection time for the Oracle R Enterprise session - is
  used.

  By default the \R environment for a schema in the Oracle R Enterprise
  session is attached in position 2 in the \R search path, immediately
  after the user's workspace and before all previously attached packages
  and environment. The \code{pos} argument can be used to attach the \R
  environment for a schema in the Oracle R Enterprise session at a
  different location in the search path, but it cannot be attached at
  \code{pos = 1}.

  The functions \code{\link{ore.sync}} and \code{\link{ore.rm}} add and
  remove \code{\linkS4class{ore}} objects from this \R environment for a
  schema in the Oracle R Enterprise session.
}
\value{
  For the \code{ore.attach} function, the environment is returned
  invisibly with a \code{"name"} attribute.

  For the \code{ore.detach} function, the return value is 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.connect}},
  \code{\link{ore.exists}},
  \code{\link{ore.get}},
  \code{\link{ore.ls}},
  \code{\link{ore.rm}},
  \code{\link{ore.sync}},
  \code{\link[base]{search}}
}
\examples{
if (!interactive())
{
  search()
  ore.attach()
  search()
  ore.detach()
  search()
  ore.attach("rquser", 3)
  search()
  ore.detach("rquser")
  search()
}
}
\keyword{data}
\keyword{database}
\keyword{ORE}