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{
Funzioni script R incorporate di Oracle R Enterprise: creazione, elencazione, caricamento, 
eliminazione
}
\description{
Crea uno script \R, che contiene una sola definizione di funzione, nel
  repository di script \R del database Oracle oppure elenca, carica o
  elimina uno script \R dal repository.
}
\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}{
Stringa di caratteri che specifica il nome di uno script \R nel 
    repository di script \R; non può essere usata con l'argomento \code{pattern}.
}
  \item{FUN}{
Definizione di funzione da utilizzare con le funzioni
    \code{\link{ore.doEval}}, \code{\link{ore.groupApply}},
    \code{\link{ore.indexApply}}, \code{\link{ore.rowApply}} o
    \code{\link{ore.tableApply}}. La funzione non può richiamare in modo 
    ricorsivo queste interfacce API R incorporate.
}
  \item{pattern}{
Stringa di caratteri di espressione regolare facoltativa che specifica i nomi
    degli script \R corrispondenti; non può essere usata con l'argomento \code{name}.
}
  \item{global}{
Valore logico facoltativo che indica se creare o eliminare uno script \R globale.
    Il valore predefinito è \code{FALSE}, che indica che lo script \R da creare o eliminare
    è uno script privato. Ogni utente dispone dell'accesso in lettura a uno script 
    \R globale, mentre solo l'utente che ha creato lo script \R può accedere a uno 
    script \R privato ed eliminarlo. 
    Le funzioni \code{\link{ore.grant}} e \code{\link{ore.revoke}} possono essere utilizzate per concedere o revocare 
    ad altri utenti il privilegio di lettura per uno script \R privato.
}
  \item{overwrite}{
Valore logico che specifica se sovrascrivere lo script \R denominato,
    se esiste già.
}
  \item{type}{
Stringa di caratteri scalare che specifica il tipo degli script \R da elencare.
    I valori validi sono 'user' (predefinito), 'all', 'grant', 'granted' e 'global'.
    'user' elenca gli script \R creati dall'utente della sessione corrente.
    'grant' elenca gli script \R per i quali l'utente della sessione corrente ha 
    concesso il privilegio di lettura ad altri utenti.
    'granted' elenca gli script \R per i quali gli altri utenti hanno concesso il
    privilegio di lettura all'utente della sessione corrente.
    'global' elenca tutti gli script \R globali creati dall'utente.
    'system' elenca tutti gli script \R di sistema predefiniti.
    'all' elenca tutti gli script \R per i quali l'utente della sessione corrente 
    dispone dell'accesso in lettura.
}
  \item{owner}{
Stringa di caratteri facoltativa che specifica l'utente che ha creato lo 
    script \R denominato. L'argomento \code{owner} può essere usato con l'argomento 
    \code{name} per specificare lo script \R da caricare in un ambiente \R. 
    Senza l'argomento \code{owner}, \code{\link{ore.scriptLoad}} trova e carica lo script \R 
    che corrisponde a \code{name} secondo l'ordine seguente: 
    script \R creato dall'utente della sessione corrente, script \R globale.
}
  \item{newname}{
Stringa di caratteri facoltativa che specifica un nuovo nome nella sessione 
    corrente per la funzione \R caricata da \code{\link{ore.scriptLoad}}. 
    Il valore \code{newname} deve essere un nome di funzione R valido. Per impostazione 
    predefinita il nome della funzione \R assume il nome dello script.
}
  \item{envir}{
Variabile di ambiente \R facoltativa che specifica l'ambiente
    che contiene la funzione \R in cui \code{\link{ore.scriptLoad}} carica lo script 
    \R denominato.
}
  \item{silent}{
Valore logico facoltativo che indica se visualizzare un messaggio di errore 
    quando \code{\link{ore.scriptDrop}} rileva un errore durante l'eliminazione 
    dello script \R denominato.
}
}
\details{
Le funzioni \code{\link{ore.scriptCreate}} e \code{\link{ore.scriptDrop}} richiedono che
  l'utente disponga del ruolo \\option{RQADMIN} del database Oracle.
}
\value{
Le funzioni \code{ore.scriptCreate}, \code{ore.scriptDrop} e 
  \code{ore.scriptLoad} restituiscono un valore \code{NULL} invisibile se la creazione, l'eliminazione 
  o il caricamento di uno script \R riesce, altrimenti generano un errore. 
  La funzione \code{ore.scriptList} restituisce un data frame che contiene le colonne NAME 
  e SCRIPT e, facoltativamente, le colonne OWNER e GRANTEE.
}
\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}