MINI MINI MANI MO

%
% Copyright (c) 2012, 2017, Oracle and/or its affiliates. All rights reserved.
%
\name{ore.scriptCreate}
\alias{ore.scriptCreate}
\alias{ore.scriptList}
\alias{ore.scriptLoad}
\alias{ore.scriptDrop}
\title{
Oracle R Enterprise - Funktionen zum Erstellen, Auflisten, Laden und Löschen von Embedded 
R-Skripten
}
\description{
Erstellt ein \R-Skript mit einer einzelnen Funktionsdefinition im
  Oracle Database \R-Skript-Repository, bzw. lädt oder löscht ein \R-Skript
  aus dem Repository oder listet die Skripte im Repository auf.
}
\usage{
ore.scriptCreate(name, FUN, global = FALSE, overwrite = FALSE)
ore.scriptList(name = NULL, pattern = NULL, 
               type = c("user", "global", "system", "all", "grant", "granted"))
ore.scriptLoad(name, owner = NULL, newname = NULL, envir = parent.frame()) 
ore.scriptDrop(name, global = FALSE, silent = FALSE)
}
\arguments{
  \item{name}{
Eine Zeichenfolge, die den Namen eines \R-Skripts im 
    \R-Skript-Repository angibt. Kann nicht mit Argument \code{pattern} verwendet werden.
}
  \item{FUN}{
Eine Funktionsdefinition für Funktion
    \code{\link{ore.doEval}}, \code{\link{ore.groupApply}},
    \code{\link{ore.indexApply}}, \code{\link{ore.rowApply}} oder
    \code{\link{ore.tableApply}}. Diese eingebetteten R-APIs können nicht rekursiv 
    von der Funktion aufgerufen werden.
}
  \item{pattern}{
Eine optionale reguläre Ausdruckszeichenfolge, die die übereinstimmenden 
    \R-Skriptnamen angibt. Kann nicht mit Argument \code{name} verwendet werden.
}
  \item{global}{
Ein optionaler logischer Wert, der angibt, ob ein globales \R-Skript
    erstellt oder gelöscht werden soll. Standardwert ist \code{FALSE}, der angibt, dass
    das zu erstellende oder zu löschende \R-Skript ein privates Skript ist. Jeder Benutzer
    hat Lesezugriff auf das globale \R-Skript, aber nur der Benutzer, der das \R-Skript erstellt hat,
    kann auf ein privates \R-Skript zugreifen und dieses löschen. Die Funktionen \code{\link{ore.grant}}
    und \code{\link{ore.revoke}} dienen zum Erteilen oder Widerrufen der
    Leseberechtigung von anderen Benutzern für ein privates \R-Skript.
}
  \item{overwrite}{
Ein logischer Wert, der angibt, ob das \R-Skript überschrieben werden soll, 
    wenn es bereits vorhanden ist.
}
  \item{type}{
Eine skalare Zeichenfolge, die den Typ des aufzulistenden \R-Skripts angibt.
    Gültige Werte sind "user" (Standard), "all", "grant", "granted" oder "global".
    "user" listet \R-Skripte auf, die vom Benutzer der aktuellen Session erstellt wurden.
    "grant" listet die \R-Skripte auf, deren Leseberechtigung vom
    aktuellen Sessionbenutzer für andere Benutzer erteilt wurde.
    "granted" listet die \R-Skripte auf, deren Leseberechtigung von
    anderen Benutzern für den aktuellen Sessionbenutzer erteilt wurde.
    "global" listet alle benutzererstellten globalen \R-Skripte auf.
    "system" listet alle vom System vordefinierten \R-Skripte auf.
    "all" listet alle \R-Skripte auf, auf die der aktuelle Sessionbenutzer 
    Lesezugriff hat.
}
  \item{owner}{
Eine optionale Zeichenfolge, die den Benutzer angibt, der das benannte 
    \R-Skript erstellt hat. Argument \code{owner} kann zusammen mit Argument 
    \code{name} zur Angabe verwendet werden, welches \R-Skript in eine \R-Umgebung 
    geladen werden soll. Ohne das Argument \code{owner} sucht \code{\link{ore.scriptLoad}} nach dem 
    \R-Skript, das mit \code{name} in folgender Reihenfolge übereinstimmt, und lädt es: 
    \R-Skript, das der aktuelle Sessionbenutzer erstellt hat, globales \R-Skript.
}
  \item{newname}{
Eine optionale Zeichenfolge, die einen neuen Namen in der aktuellen Session 
    für die \R-Funktion angibt, die von \code{\link{ore.scriptLoad}} geladen wurde. 
    Der \code{newname}-Wert muss ein gültiger R-Funktionsname sein. Standardmäßig 
    übernimmt der Name der \R-Funktion den Namen des Skripts.
}
  \item{envir}{
Eine optionale \R-Umgebungsvariable, die die Umgebung angibt, die
    die \R-Funktion enthält, in die \code{\link{ore.scriptLoad}} das 
    benannte \R-Skript lädt.
}
  \item{silent}{
Ein optionaler logischer Wert, der angibt, ob eine Fehlermeldung angezeigt werden soll, 
    wenn \code{\link{ore.scriptDrop}} einen Fehler beim Löschen des 
    benannten \R-Skripts erkennt.
}
}
\details{
Für Funktionen \code{\link{ore.scriptCreate}} und \code{\link{ore.scriptDrop}} muss der
  Benutzer die Oracle Database-Rolle \\option{RQADMIN} haben.
}
\value{
Die Funktionen \code{ore.scriptCreate}, \code{ore.scriptDrop} und 
  \code{ore.scriptLoad} geben einen unsichtbaren \code{NULL}-Wert zurück, wenn ein
  \R-Skript erfolgreich erstellt, gelöscht oder geladen wurde. Andernfalls geben sie einen
  Fehler aus. Funktion \code{ore.scriptList} gibt einen Datenframe zurück, der die
  Spalten NAME und SCRIPT und optional die Spalten OWNER und GRANTEE enthält.
}
\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.doEval}}
}
\examples{
if (!interactive())
{
  # create an R script for the current user
  ore.scriptCreate("MYLM",
                   function(data, formula, ...) lm(formula, data, ...))
  IRIS <- ore.push(iris)
  ore.tableApply(IRIS[1:4], FUN.NAME = "MYLM",
                 formula = Sepal.Length ~ .)

  # create a global R script available to any user
  ore.scriptCreate("GLBGLM",
                   function(data, formula, ...) 
                     glm(formula=formula, data=data, ...),
                   global = TRUE)
  ore.tableApply(IRIS[1:4], FUN.NAME = "GLBGLM",
                 formula = Sepal.Length ~ .) 

  # list R scripts 
  ore.scriptList()
  ore.scriptList(pattern="LM", type="all")

  # load an R script to an R function object
  ore.scriptLoad(name="MYLM")
  ore.scriptLoad(name="GLBGLM", newname="MYGLM")
  MYLM(iris, formula = Sepal.Length ~ .)
  MYGLM(iris, formula = Sepal.Length ~ .)

  # grant and revoke R script read privilege to and from public
  ore.grant(name = "MYLM", type = "rqscript")
  ore.scriptList(type="grant")
  ore.revoke(name = "MYLM", type = "rqscript")
  ore.scriptList(type="grant")  

  # drop an R script
  ore.scriptDrop("MYLM")
  ore.scriptDrop("GLBGLM", global=TRUE)

  ore.scriptList(type="all")
}
}
\keyword{programming}
\keyword{database}
\keyword{ORE}