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{
Funktionen zum Erstellen oder Löschen von Datenbanktabellen
}

\description{
Erstellt eine Oracle-Datenbanktabelle anhand eines \code{data.frame}- oder 
  \code{ore.frame}-Objekts bzw. eine View anhand eines \code{ore.frame}-Objekts.
  Löscht eine Datenbanktabelle oder View.
}
\usage{
ore.create(x, table = NULL, view = NULL)
ore.drop(table = NULL, view = NULL)
}
\arguments{
  \item{x}{
Ein \code{\linkS4class{ore.frame}}-Objekt. Es kann auch 
    \code{\link[base]{data.frame}} sein, wenn Argument \code{table} verwendet wird.
}
  \item{table}{
Eine Zeichenfolge, die den Namen der Tabelle angibt. Dieses Argument
    kann nicht mit Argument \code{view} verwendet werden.
}
  \item{view}{
Eine Zeichenfolge, die den Namen der View angibt. Dieses Argument
    kann nicht mit Argument \code{table} verwendet werden.
}
}




\details{
Eines der Argumente \code{table} oder \code{view} muss angegeben werden, 
  je nachdem, ob eine Datenbanktabelle oder -View zum
  Erstellen oder Löschen verwendet werden soll.
  Wenn ein neues Objekt mit Funktion \code{ore.create} erstellt wird, wird es
  automatisch in der Liste der Objekte aufgenommen, auf die mit den
  Funktionen \code{ore.get} und \code{ore.ls} zugegriffen werden kann. Es wird außerdem 
  zu der Liste der zugeordneten \code{ore.frame}-Objekte hinzugefügt, wenn \code{ore.attach}
  bereits aufgerufen wurde. Für Funktion \code{ore.create} kann außerdem
  nur ein \code{\linkS4class{ore.frame}}-Objekt mit dem Argument \code{view}
  verwendet werden.
  Wenn ein Objekt mit Funktion \code{ore.drop} entfernt wird,
  wird es auch nicht mehr in der Ausgabe der Funktion \code{ore.ls} angezeigt. Es
  wird auch aus einer Liste der zugeordneten \code{ore.frame}-Objekte entfernt.
  Wenn das Eingabeobjekt Spaltennamen enthält, die nicht mit den Benennungsregeln
  des Backend-Servers übereinstimmen, werden sie mit der 
  Funktion \code{ore.make.names} geändert.
  Funktion \code{ore.create} behält \code{row.names} weder in der
  Datenbanktabelle noch in dem neu erstellten \code{ore.frame}-Objekt bei.
}
\value{
Beide Funktionen \code{ore.create} und \code{ore.drop} geben einen
  unsichtbaren \code{NULL}-Wert zurück.
}
\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}