Amazon Athena JDBC Driver Wrapper Supporting the 'metis' Package
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

91 rivejä
2.6 KiB

7 vuotta sitten
5 vuotta sitten
[![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)
5 vuotta sitten
5 vuotta sitten
# metis.jars
6 vuotta sitten
5 vuotta sitten
Amazon Athena JDBC Driver Wrapper Supporting the ‘metis’ Package
7 vuotta sitten
6 vuotta sitten
## Description
7 vuotta sitten
5 vuotta sitten
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.
7 vuotta sitten
5 vuotta sitten
## IMPORTANT
5 vuotta sitten
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`:
5 vuotta sitten
5 vuotta sitten
``` r
5 vuotta sitten
options(
"java.parameters" = c(getOption("java.parameters", default = NULL), "-Xrs")
)
5 vuotta sitten
```
6 vuotta sitten
## What’s Inside The Tin?
7 vuotta sitten
The following functions are implemented:
5 vuotta sitten
- `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
6 vuotta sitten
## Installation
7 vuotta sitten
``` r
5 vuotta sitten
devtools::install_git("https://git.sr.ht/~hrbrmstr/metis-jars")
5 vuotta sitten
# OR
5 vuotta sitten
devtools::install_gitlab("hrbrmstr/metis-jars")
5 vuotta sitten
# OR
5 vuotta sitten
devtools::install_github("hrbrmstr/metis-jars")
7 vuotta sitten
```
6 vuotta sitten
## Usage
7 vuotta sitten
``` r
5 vuotta sitten
library(metis.jars)
7 vuotta sitten
# current verison
5 vuotta sitten
packageVersion("metis.jars")
6 vuotta sitten
```
4 vuotta sitten
## [1] '2.0.9'
6 vuotta sitten
``` r
5 vuotta sitten
simba_driver_version()
```
4 vuotta sitten
## [1] "02.00.09.1018"
5 vuotta sitten
``` r
5 vuotta sitten
athena_supported_types()
5 vuotta sitten
```
5 vuotta sitten
## [1] "BOOLEAN" "TINYINT" "SMALLINT" "INT" "INTEGER" "BIGINT" "REAL" "FLOAT" "DOUBLE"
## [10] "DECIMAL" "DATE" "TIMESTAMP" "BINARY" "VARBINARY" "CHAR" "VARCHAR" "STRING" "ARRAY"
## [19] "MAP" "ROW" "STRUCT"
5 vuotta sitten
``` r
5 vuotta sitten
metis_jar_path()
5 vuotta sitten
```
4 vuotta sitten
## [1] "/Library/Frameworks/R.framework/Versions/3.6/Resources/library/metis.jars/java/AthenaJDBC42_2.0.9.jar"
6 vuotta sitten
## 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.