MINI MINI MANI MO

%
% Copyright (c) 2012, 2014, Oracle and/or its affiliates. All rights reserved. 
%
\name{ore.sync}
\alias{ore.sync}
\title{
Oracle R Enterprise - Objektsynchronisierungsfunktion
}
\description{
Synchronisiert \code{\linkS4class{ore.frame}}-Objekte, die
  Datenbanktabellen, Views und Abfragen in \R
  \code{\link[base]{environment}} darstellen, für ein Schema in der Oracle R
  Enterprise-Session.
}
\usage{
ore.sync(schema, table = NULL, use.keys = TRUE, query = NULL)
}
\arguments{
  \item{schema}{
Eine Zeichenfolge, die den Schemanamen der Datenbank angibt. Bei
    Verwendung des Arguments \code{query} nicht unterstützt.
}
  \item{table}{
Ein optionaler Zeichenvektor, der die Datenbanktabellen- oder View-
    Namen angibt, die beim Erstellen von Objekt \code{\linkS4class{ore.frame}} verwendet werden sollen.
}
  \item{use.keys}{
Ein logischer Wert, der angibt, ob Primärschlüssel – sofern vorhanden –
    beim Erstellen sortierter
    \code{\linkS4class{ore.frame}}-Objekte verwendet werden sollen.
}
  \item{query}{
Ein optionaler benannter Zeichenvektor, der Abfragen angibt, die beim
    Erstellen von \code{\linkS4class{ore.frame}}-Objekten verwendet werden sollen. Die Elementnamen
    werden als Namen der \code{\linkS4class{ore.frame}}-Objekte
    in \R \code{\link[base]{environment}} für das Standardschema verwendet.
}
}



\details{
Oracle R Enterprise erstellt Proxyobjekte in \R, die den
  Tabellen oder Views im Datenbankschema entsprechen. Diese Proxyobjekte enthalten
  Metadaten, die von Oracle R Enterprise intern verwendet werden, um
  Transparenzschichtfunktionalität zu gewährleisten.
  Standardmäßig verwendet Funktion \code{ore.sync} das Schema, das zum Zeitpunkt von
  \code{\link{ore.connect}} angegeben wird. Das Argument \code{schema} kann verwendet werden, um ein
  anderes Schema zu wählen, für das der Benutzer die entsprechenden
  Zugriffsberechtigungen hat.
  Wenn beide Argumente \code{table} und \code{query} in einem \code{NULL}-Funktionsaufruf
  \code{ore.sync} sind, werden alle Tabellen und Views, deren Namen
  \code{$} nicht enthalten oder nicht mit \code{SYS_} beginnen,
  gewählt. Die Auswahl aller Tabellen in einem Datenbankschema kann
  aufwändig sein, deshalb wird empfohlen, entweder das Argument
  \code{table} oder \code{query} festzulegen, um die Anzahl von Tabellen
  und Views zu begrenzen, die in der Oracle R Enterprise-
  Schemaumgebung dargestellt werden.
  Wenn Argument \code{use.keys} auf \code{FALSE} festgelegt ist oder wenn die Tabelle
  keinen Primärschlüssel enthält, ist das entsprechende \code{\linkS4class{ore.frame}}-Objekt
  nicht sortiert, sonst wird es sortiert. Bei vielen
  Vorgängen mit \code{\linkS4class{ore.frame}}-Objekten (Beispiel:
  \code{colMeans}) ist die Zeilenreihenfolge nicht wichtig. Bei Vorgängen,
  die eine Zeilensortierung erfordern (Beispiel: \code{diff}), wird eine Fehlermeldung
  ausgegeben, mit der angegeben wird, dass keine Sortierinformationen
  verfügbar sind. Eine Zeilensortierung kann für ein
  \code{\linkS4class{ore.frame}}-Objekt festgelegt werden, indem dessen Zeilennamen auf
  mindestens eine der Spalten festgelegt werden.
}
\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.get}},
  \code{\link{ore.ls}},
  \code{\link{ore.rm}},
  \code{\link{row.names<-}}
}
\examples{
if (!interactive())
{
  ore.sync()
  ore.sync("RQUSER", use.keys = FALSE)
  ore.exec("create table TABLE1 as select * from dual")
  ore.exec("create table TABLE2 as select * from dual")
  ore.sync(table = c("TABLE1", "TABLE2"))
  ore.sync("RQUSER", table = c("TABLE1", "TABLE2"))
  ore.sync(query = c("QUERY1" = "select 0 X, 1 Y from dual",
                     "QUERY2" = "select 1 X, 0 Y from dual"))
  ore.drop("TABLE1")
  ore.drop("TABLE2")
}
}
\keyword{environment}
\keyword{database}
\keyword{ORE}