Amazon Athena Reader

Licensing options for this format begin with FME Professional Edition.

The Amazon Athena reader module provides FME with access to attribute data held in Amazon Athena tables. FME provides read access via Amazon's Athena JDBC driver.

Overview

Amazon's Athena JDBC driver is not bundled with FME, but can be downloaded from http://docs.aws.amazon.com/athena/latest/ug/connect-with-jdbc.html and manually installed.

Installing the JDBC Driver

To view instructions for installing the JDBC driver, please see Getting Started with JDBC.

AWS fees are incurred for Amazon Athena usage in the following ways:

  1. For the amount of data scanned (all data is scanned for every query, unless the underlying data supports columnar storage).
  2. The underlying data is stored on S3.
  3. The result set of each query is stored on S3 (and will not be cleaned up by FME).

The Amazon Athena reader will not typically be an efficient way to retrieve entire datasets from S3; it is intended for retrieving subsets of datasets.

Usage Notes

The performance of this format is dependent on the amount of memory allocated to the Java Virtual Machine (JVM). The following environment variables allow you to specify memory available to Java Plugins:

  • FME_JVM_MIN_HEAP_SIZE: Initial heap size for initializing the JVM.
  • FME32_JVM_MIN_HEAP_SIZE: Same as FME_JVM_MIN_HEAP_SIZE, but applies to 32-bit FME Desktop on Windows, and takes precedence over FME_JVM_MIN_HEAP_SIZE.

  • FME_JVM_MAX_HEAP_SIZE: Maximum heap size for initializing the JVM.
  • FME32_JVM_MAX_HEAP_SIZE: Same as FME_JVM_MAX_HEAP_SIZE, but applies to 32-bit FME Desktop on Windows, and takes precedence over FME_JVM_MAX_HEAP_SIZE.

These variables must be set for FME to honor them, and must be multiples of 1024K (for example, 4M and 64M, or 4096K and 32768K).

Note: To pass additional parameters used by FME to the Java Virtual Machine, use the JAVA_TOOL_OPTIONS environment variable.