MINI MINI MANI MO

%
% Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved.
%
\name{ore.connect}
\alias{ore.is.connected}
\alias{ore.connect}
\alias{ore.disconnect}
\title{
Oracle R Enterprise - Verbindungsfunktionen
}
\description{
Stellt eine Verbindung zu einem Oracle R Enterprise-Server
  her bzw. trennt diese.
}
\usage{
  ore.is.connected(type = c("ORACLE", "HIVE"))
  ore.connect(user = "", sid = "", host = "localhost", password = "",
              port = NULL, service_name = NULL, conn_string = NULL,
              all = FALSE, type = c("ORACLE", "HIVE"),
              tzone = Sys.getenv("TZ"), schema = NULL, ...)
  ore.disconnect()
}
\arguments{
  \item{user}{
Bei Argument \code{type = "ORACLE"} (Standard), eine Zeichenfolge, 
    die den Oracle Database-Benutzernamen angibt.
}
  \item{sid}{
Bei Argument \code{type = "ORACLE"} (Standard), eine Zeichenfolge, 
die die Oracle-Datenbank-SID oder die Oracle
Wallet-Verbindungszeichenfolge angibt.
}
  \item{host}{
Bei Argument \code{type = "ORACLE"} (Standard), eine Zeichenfolge
    für den Hostnamen der Oracle-Datenbank.
}
  \item{password}{
Bei Argument \code{type = "ORACLE"} (Standard), eine Zeichenfolge, 
    die das Oracle Database-Benutzerkennwort angibt.
}
  \item{port}{
Bei Argument \code{type = "ORACLE"} (Standard), eine Zahl, 
    die den Oracle Database-Port angibt (im Allgemeinen 1521).
}
  \item{service_name}{
Bei Argument \code{type = "ORACLE"} (Standard), eine Zeichenfolge, 
die den Servicenamen angibt, der in der Verbindungs-ID
    für Oracle Database verwendet werden soll.
}
  \item{conn_string}{
Bei Argument \code{type = "ORACLE"} (Standard), eine Zeichenfolge, 
    die die Verbindungszeichenfolge angibt, die für eine Verbindung
    zu Oracle Database verwendet wird. Im Allgemeinen wird sie für die 
    Datenbankverbindung zu Oracle Wallet verwendet.
}
  \item{all}{
Ein logischer Wert, der angibt, ob die Funktionen
    \code{\link{ore.sync}} und \code{\link{ore.attach}} mit ihren Standardargumenten
    aufgerufen werden sollen. Dies führt zur Synchronisierung und Zuordnung
    aller Tabellen und Views im Schema für die Oracle R Enterprise-
    Verbindung. Die Zeit zur Ausführung von \code{\link{ore.sync}} wächst
    linear mit der Anzahl der sichtbaren Tabellen und Views.
}
  \item{type}{
Eine Zeichenfolge, die den Datenbanktyp angibt: entweder
    \code{"ORACLE"} (Standard) oder \code{"HIVE"}.
}
  \item{tzone}{
Eine Zeichenfolge, die die Sessionzeitzone sowohl für \R-
    als auch für Datenbanksessions angibt. Der Standardwert von \code{tzone} ist der Wert
    der Systemumgebungsvariable \code{TZ}. Wenn 
    \code{tzone} den Wert \code{NA} oder eine leere Zeichenfolge hat, wird \code{UTC}
    sowohl für \R- als auch für Datenbanksessions verwendet.
}
  \item{schema}{
Eine Zeichenfolge, die das Schema angibt.
}
  \item{...}{
Zusätzliche Parameter für eine Hive-Verbindung bei Verwendung von Hiveserver2 in
    verschiedenen Modi, wie:
    \itemize{
      \item{HiveServer2 mit Kerberos-Authentifizierung:}{
        Verwenden Sie den Parameter \code{principal}, um den Kerberos-Server-
        Principal für den Host anzugeben, auf dem HiveServer2 ausgeführt wird.
      }
      \item{Hiveserver2 mit SSL:}{
        Verwenden Sie in diesem Modus Parameter wie \code{ssl="true"},
        \code{sslTrustStore}, um den Pfad zur Truststore-Datei des Clients anzugeben,
        und \code{trustStorePassword}, um das Kennwort für den Truststore anzugeben.
      }
      \item{Jede andere Konfiguration von HiveServer2:}{
        Es gibt zahlreiche derartige Konfigurationskombinationen, in denen HiveServer2
        ausgeführt werden kann. In der Hive-Dokumentation finden Sie die verschiedenen Modi
        und die Parameter für die Verbindung in diesen Modi.
      }
    }
}
}



\details{
Die Funktionen \code{ore.connect} und \code{ore.disconnect} werden für ihre
  Auswirkungen aufgerufen, nämlich das Herstellen bzw. Beenden einer Verbindung zu
  einem Oracle R Enterprise-Server. Der Aufruf der Funktion \code{ore.connect}
  muss allen anderen Aufrufen der Oracle R Enterprise-Funktionalität
  (außer \code{ore.is.connected}) vorangehen. Es kann jeweils nur eine aktive Oracle
  R Enterprise-Verbindung geben. Eine Oracle R Enterprise-Session kann optional
  mit einem Aufruf der Funktion \code{ore.disconnect} enden. Eine Oracle R
  Enterprise-Session wird implizit beendet, wenn die \R-Session endet.
  Die Zeitzonen der \R- und der Datenbanksession werden während der
  Ausführung der Funktion \code{ore.connect} festgelegt. Die Sessionzeitzonen werden
  auf den Wert des Arguments \code{tzone} gesetzt, dessen Standardwert
  der Systemumgebungsvariable \code{TZ} entspricht. Wenn sowohl \code{TZ}
  als auch \code{tzone} nicht angegeben sind, werden die Sessionzeitzonen auf
  \code{UTC} gesetzt.
  Wenn Sie Oracle Wallet zum Speichern von Benutzername und Kennwort verwenden,
  verwenden Sie das Argument \code{conn_string}, um die Verbindungszeichenfolge für
  die Wallet-Zuordnung zu übergeben (weitere Informationen finden Sie in Kapitel 3,
  "Configuring Clients to Use the External Password Store" im Oracle
  Database Security Guide). Außerdem können Sie über das Argument \code{service_name}
  Servicenameninformationen übergeben. (Weitere Informationen zu Servicenamen
  finden Sie in Kapitel 2 des Oracle Database Net Services
  Administrator's Guide).
  Der Aufruf von \code{ore.connect} bei einer bestehenden aktiven Oracle R Enterprise-
  Verbindung führt dazu, dass die aktive Session getrennt und
  eine neue Session gestartet wird.
}
\value{
Ein logischer Wert im Fall von Funktion \code{ore.is.connected},
  der angibt, ob eine aktive Oracle R Enterprise-Verbindung vorhanden ist; 
  andernfalls ein unsichtbarer \code{NULL}-Wert.
}
\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.exists}},
  \code{\link{ore.get}},
  \code{\link{ore.ls}},
  \code{\link{ore.rm}},
  \code{\link{ore.sync}}
}
\examples{
\dontrun{
  # pass the username password during connect
  if (!is.ore.connected())
    ore.connect("rquser", "orcl", "localhost", "rquser")
  ore.ls()
  ore.disconnect()

  # pass the connect string for wallet mode
  if (!is.ore.connected())
    ore.connect(conn_string = "<wallet_connect_string>")
  ore.ls()
  ore.disconnect()
}}
\keyword{database}
\keyword{ORE}