MINI MINI MANI MO

%
% Copyright (c) 2012, 2015, Oracle and/or its affiliates. All rights reserved.
%
\name{ore.datastore}
\alias{ore.datastore}
\title{
Oracle R Enterprise - Datenspeicherauflistungsfunktion
}
\description{
Führt vorhandene Datenspeicher im Oracle Database-Schema des Benutzers auf.
}
\usage{
ore.datastore(name, pattern, type = c("user", "private", "all", 
                                      "grantable", "grant", "granted"))
}
\arguments{
  \item{name}{
Eine optionale Zeichenfolge, die den Namen des Datenspeichers angibt; kann 
    nicht mit Argument \code{pattern} verwendet werden.
}
  \item{pattern}{
Eine optionale reguläre Ausdruckszeichenfolge, die die übereinstimmenden Namen 
    der Datenspeichers angibt; kann nicht mit Argument \code{name} verwendet werden.
}
  \item{type}{
Eine optionale skalare Zeichenfolge, die den Typ des aufzuführenden 
    Datenspeichers angibt. Gültige Werte sind "user" (Standard), "private", "all", 
    "grantable", "grant" und "granted".
    Mit "user" werden die vom aktuellen Sessionbenutzer erstellten Datenspeicher aufgelistet.
    Mit "private" werden die Datenspeicher aufgelistet, für die keine Leseberechtigungen vom
    aktuellen Sessionbenutzer an andere Benutzer erteilt werden können.
    Mit "all" werden alle Datenspeicher aufgelistet, für die der aktuelle Sessionbenutzer
    Lesezugriff hat.
    Mit "grantable" werden die Datenspeicher aufgelistet, für die Leseberechtigungen vom
    aktuellen Sessionbenutzer an andere Benutzer erteilt werden können.
    Mit "grant" werden die Datenspeicher aufgelistet, für die Leseberechtigungen vom
    aktuellen Sessionbenutzer an andere Benutzer erteilt wurden.
    Mit "granted" werden die Datenspeicher aufgelistet, für die Leseberechtigungen von 
    anderen Benutzern an den aktuellen Sessionbenutzer erteilt wurden.
}
}
\details{
Funktion \code{ore.datastore} führt Informationen zu Datenspeichern auf hoher
  Ebene zu dem Oracle Database-Schema des Benutzers auf. Diese
  Datenspeicherauflistung kann optional mit dem Argument \code{name} oder
  \code{pattern} gefiltert werden.
}
\value{
Ein \code{data.frame}-Objekt wird mit Spalten
  \code{datastore.name}, \code{object.count}, \code{size},
  \code{creation.date} und \code{description} zurückgegeben, wenn das Argument \code{type} 
  "user", "private" oder "grantable" lautet. Diese Spalten geben den Namen
  des Datenspeichers, die Anzahl von Objekten im benannten Datenspeicher,
  die Größe des Datenspeichers in Byte, das Erstelldatum des Datenspeichers
  bzw. den Kommentar zum Datenspeicher an. 
  Die Ausgabe \code{data.frame} enthält die zusätzliche Spalte \code{owner}, die den 
  Eigentümer der Datenspeicher angibt, wenn Argument \code{type} "all" oder "granted" lautet.
  Wenn das Argument \code{type} "grant" lautet, enthält die Ausgabe \code{data.frame} die
  Spalten \code{datastore.name} und \code{grantee}, in denen der Name des Datenspeichers 
  und der Name des Benutzers angegeben werden, dem die Leseberechtigung für den 
  benannten Datenspeicher vom aktuellen Sessionbenutzer erteilt wurde. 
  Die Zeilen des \code{data.frame}-Objekts sind alphabetisch nach Spalte
  \code{owner} und gegebenenfalls \code{datastore.name} sortiert.
}
\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.save}},
  \code{\link{ore.load}},
  \code{\link{ore.delete}},
  \code{\link{ore.datastoreSummary}}
  \code{\link{ore.grant}}
  \code{\link{ore.revoke}}
}
\examples{
\dontshow{
if (!interactive())
    ore.connect(user     = Sys.getenv("ORE_USERNAME", "rquser"),
                sid      = Sys.getenv("ORACLE_SID"),
                host     = Sys.getenv("HOST"),
                password = Sys.getenv("ORE_PASSWORD", "rquser"),
                port  = if (.Platform$OS.type == "windows")
                           Sys.getenv("ORACLE_PORT")
                        else
                           Sys.getenv("TCPPORT"),
                all = TRUE)
}

if (!interactive())
{
if (any(sapply(c("x", "y", "z"), exists)))
  stop("object x, y, or z exists")

x <- stats::runif(20)
y <- list(a = 1, b = TRUE, c = "oops")
z <- ore.push(x)

ore.save(list=ls(), name="rqds_1")
ore.save(x, y, name="rqds_2")
ore.save(z, name="rqds_3", grantable=TRUE)

# list overall information about the datastores in user's schema
ds <- ore.datastore()
\dontrun{
ds
}
\dontshow{
ds[, -(3L:4L)]
}

# list overall information about the datastores available in the user's schema
ds <- ore.datastore(type="all")
\dontrun{
ds
}
\dontshow{
ds[, -(3L:4L)]
}

# list overall information about the datastore the read privilege for which
# can be granted
ds <- ore.datastore(type="grantable")
\dontrun{
ds
}
\dontshow{
ds[, -(3L:4L)]
}

# list overall information about the datastore with name 'rqds_1'
ds <- ore.datastore(name="rqds_1")
\dontrun{
ds
}
\dontshow{
ds[, -(3L:4L)]
}

# list overall information about the datastores whose name starts
# with 'rqds_'
ds <- ore.datastore(pattern="^rqds_")
\dontrun{
ds
}
\dontshow{
ds[, -(3L:4L)]
}

sapply(c("rqds_1", "rqds_2", "rqds_3"), ore.delete)
rm(x, y, z)
}
}
\keyword{datastore}
\keyword{database}
\keyword{ORE}