~hrbrmstr/metis-jars

03ae097b959b0cd83c6b945bdf51b5b704eeb136 — boB Rudis 2 years ago a0512cb
info abt signals
4 files changed, 69 insertions(+), 0 deletions(-)

M R/metis-package.R
M README.Rmd
M README.md
M man/metis.Rd
M R/metis-package.R => R/metis-package.R +19 -0
@@ 4,11 4,30 @@
#' perform queries and retrieve query results. A lightweight 'RJDBC' implementation
#' is included along with an interface to the 'AWS' command-line utility.
#'
#' @section IMPORTANT:
#'
#' Since R 3.5 (I don't remember this happening in R 3.4.x) signals sent from interrupting 
#' Athena JDBC calls crash the R #' interpreter. You need to set the `-Xrs` option to avoid
#' signals being passed on to the JVM owner. That has to be done _#' before_ `rJava` is 
#' loaded so you either need to remember to put it at the top of all scripts _or_ stick this
#' in your local #' `~/.Rprofile` and/or sitewide `Rprofile`:
#'
#'
#'     if (!grepl("-Xrs", getOption("java.parameters", ""))) {
#'       options(
#'         "java.parameters" = paste0(
#'           c(getOption("java.parameters", default = NULL), "-Xrs"),
#'           collapse=" "
#'         )
#'       )
#'     }
#'
#' @name metis
#' @encoding UTF-8
#' @docType package
#' @author Bob Rudis (bob@@rud.is)
#' @import RJDBC
#' @keywords internal
#' @import DBI
#' @import dplyr
#' @importFrom jsonlite fromJSON

M README.Rmd => README.Rmd +14 -0
@@ 24,6 24,20 @@ NOTE that the updated driver *REQUIRES JDK 1.8+*.

See the **Usage** section for an example.

## IMPORTANT

Since R 3.5 (I don't remember this happening in R 3.4.x) signals sent from interrupting Athena JDBC calls crash the R interpreter. You need to set the `-Xrs` option to avoid signals being passed on to the JVM owner. That has to be done _before_ `rJava` is loaded so you either need to remember to put it at the top of all scripts _or_ stick this in your local `~/.Rprofile` and/or sitewide `Rprofile`:

```r
if (!grepl("-Xrs", getOption("java.parameters", ""))) {
  options(
    "java.parameters" = paste0(
      c(getOption("java.parameters", default = NULL), "-Xrs"), 
      collapse=" "
    )
  )
}
```
## What's Inside The Tin?

The following functions are implemented:

M README.md => README.md +15 -0
@@ 25,6 25,21 @@ NOTE that the updated driver *REQUIRES JDK 1.8+*.

See the **Usage** section for an example.

## IMPORTANT

Since R 3.5 (I don't remember this happening in R 3.4.x) signals sent from interrupting Athena JDBC calls crash the R interpreter. You need to set the `-Xrs` option to avoid signals being passed on to the JVM owner. That has to be done _before_ `rJava` is loaded so you either need to remember to put it at the top of all scripts _or_ stick this in your local `~/.Rprofile` and/or sitewide `Rprofile`:

```r
if (!grepl("-Xrs", getOption("java.parameters", ""))) {
  options(
    "java.parameters" = paste0(
      c(getOption("java.parameters", default = NULL), "-Xrs"), 
      collapse=" "
    )
  )
}
```

## What’s Inside The Tin?

The following functions are implemented:

M man/metis.Rd => man/metis.Rd +21 -0
@@ 11,6 11,27 @@ Methods are provides to connect to 'Amazon' 'Athena', lookup schemas/tables,
perform queries and retrieve query results. A lightweight 'RJDBC' implementation
is included along with an interface to the 'AWS' command-line utility.
}
\section{IMPORTANT}{


Since R 3.5 (I don't remember this happening in R 3.4.x) signals sent from interrupting 
Athena JDBC calls crash the R #' interpreter. You need to set the `-Xrs` option to avoid
signals being passed on to the JVM owner. That has to be done _#' before_ `rJava` is 
loaded so you either need to remember to put it at the top of all scripts _or_ stick this
in your local #' `~/.Rprofile` and/or sitewide `Rprofile`:


    if (!grepl("-Xrs", getOption("java.parameters", ""))) {
      options(
        "java.parameters" = paste0(
          c(getOption("java.parameters", default = NULL), "-Xrs"),
          collapse=" "
        )
      )
    }
}

\author{
Bob Rudis (bob@rud.is)
}
\keyword{internal}