Amazon Athena Connector

This Node Is Deprecated — This version of the node has been replaced with a new and improved version. The old version is kept for backwards-compatibility, but for all new workflows we suggest to use the version linked below.
Go to Suggested ReplacementAmazon Athena Connector

This node is part of the deprecated database framework. For more information on how to migrate to the new database framework see the migration section of the database documentation.

This node creates a connection to Amazon Athena via its JDBC driver. You need to provide the appropriate Amazon Athena hostname according to the region (e.g. athena.us-east-1.amazonaws.com) and the port. Login credentials can either be provided directly in the configuration or via credentials set on the workflow.

If not specified queries always run against the default schema. Queries can be run against a specific schema using queries of the form "SELECT * FROM schema.tablename LIMIT 100".

The s3 staging location must be set in order for the connection to work.

Addition parameters can also be provided, see Accessing Amazon Athena with JDBC.

Options

Hostname
The hostname corresponding to the region of Amazon Athena. (e.g. "athena.REGION.amazonaws.com")
Port
The port on which Amazon Athena is listening. The default port is 443.
S3 Staging Directory
The Amazon S3 location to which your query output is written, for example "s3://query-results-bucket/folder/".
Parameter
Additional parameters that can be set. For example "max_error_retries=20&bconnection_timeout=20000".
Use credentials
Selection this option if you want to provide authentication data via workflow credentials. Then select the desired credential name in the list below.
Use username & password
Provide your Access Key ID and your Secret Access Key
Timezone correction
Select the TimeZone to convert the date, time or timestamp field into. The current implementation can't represent time zones. In order to support persisting those fields into a database, the time values can be changed according to the selected time zone, which is used as the offset (including the daylight saving time) for the original values:
  • No correction (use UTC) is used for workflows (created before 2.8) and doesn't apply any correction,
  • Use local timezone uses the local time zone offset to correct the date field before reading or writing, and
  • Use selected timezone allows selecting the time zone to covert the date values into.
Validate connection on close
Check this option if you want to validate the connection when closing the dialog.
Retrieve metadata in configure
This option controls subsequent nodes. Usually when a database node is configured it retrieves the metadata of the current table or query from the database for usage in subsequent nodes. If metadata retrieval takes quite some time it will slow down workflow configuration and execution noticeably, especially since metadata is retrieved in both configure and execute. In such cases it's better to switch this option off and only retrieve metadata during execute.

Input Ports

This node has no input ports

Output Ports

Icon
A database JDBC connection

Views

This node has no views

Workflows

Links

Developers

You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.