Browse Source

info abt signals

master
boB Rudis 1 year ago
parent
commit
03ae097b95
No known key found for this signature in database GPG Key ID: 1D7529BE14E2BBA9
4 changed files with 69 additions and 0 deletions
  1. +19
    -0
      R/metis-package.R
  2. +14
    -0
      README.Rmd
  3. +15
    -0
      README.md
  4. +21
    -0
      man/metis.Rd

+ 19
- 0
R/metis-package.R View File

@@ -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


+ 14
- 0
README.Rmd View File

@@ -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:


+ 15
- 0
README.md View File

@@ -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:


+ 21
- 0
man/metis.Rd View File

@@ -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}

Loading…
Cancel
Save