~hrbrmstr/metis-jars

ref: f74b9029f800d2417118ce6bcd61c964d1d8b452 metis-jars/README.Rmd -rw-r--r-- 2.4 KiB
f74b9029boB Rudis badges 3 years ago
                                                                                
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
---
output: rmarkdown::github_document
editor_options: 
  chunk_output_type: console
---
```{r include=FALSE}
knitr::opts_chunk$set(
  echo = TRUE,
  message = FALSE,
  warning = FALSE,
  fig.retina = 2
)

Sys.setenv(
  AWS_S3_STAGING_DIR = "s3://aws-athena-query-results-569593279821-us-east-1"
)

options(width=120)
```

[![Travis-CI Build Status](https://travis-ci.org/hrbrmstr/metis-jars.svg?branch=master)](https://travis-ci.org/hrbrmstr/metis-jars) 
[![Coverage Status](https://codecov.io/gh/hrbrmstr/metis-jars/branch/master/graph/badge.svg)](https://codecov.io/gh/hrbrmstr/metis-jars)
[![CRAN_Status_Badge](http://www.r-pkg.org/badges/version/metis-jars)](https://cran.r-project.org/package=metis.jars)

# metis.jars

Amazon Athena JDBC Driver Wrapper Supporting the 'metis' Package

## Description

Contents of the Amazon Athena JDBC Driver 
<https://docs.aws.amazon.com/athena/latest/ug/connect-with-jdbc.html>
provided to support functions in the 'metis' package. Version number 
reflects the version number of the included 'JAR' file.

## IMPORTANT

Until a release of 'rJava' newer than '0.9.10' is on CRAN signals sent 
from interrupting Athena JDBC calls crash the R interpreter. You therefore 
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
options(
  "java.parameters" = c(getOption("java.parameters", default = NULL), "-Xrs")
)
```
## What's Inside The Tin?

The following functions are implemented:

- `athena_supported_types`:	Retrieve the current supported type names in Athena
- `metis_jar_path()` : Retrieve the fully-qualified path to the included Athena JAR file
- `simba_driver_version`:	Retrieve the version of the Simba Athena JDBC driver included with the package

## Installation

```{r eval=FALSE}
devtools::install_git("https://git.sr.ht/~hrbrmstr/metis-jars")
# OR
devtools::install_gitlab("hrbrmstr/metis-jars")
# OR
devtools::install_github("hrbrmstr/metis-jars")
```

## Usage

```{r}
library(metis.jars)

# current verison
packageVersion("metis.jars")
```

```{r}
simba_driver_version()

athena_supported_types()

metis_jar_path()
```

## Code of Conduct

Please note that this project is released with a [Contributor Code of Conduct](CONDUCT.md). By participating in this project you agree to abide by its terms.