Amazon Athena Connector (legacy)
KNIME Amazon Athena Connector version 4.0.0.v201906190742 by KNIME AG, Zurich, Switzerland
This node is part of the legacy 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.
Output Ports
Best Friends (Incoming)
- Table Column to Variable (33 %)
- Merge Variables (33 %)
- Credentials Input (33 %)
Best Friends (Outgoing)
- Database Reader (legacy) (33 %)
- Database Table Selector (legacy) (22 %)
- Database Connection Table Reader (legacy) (11 %)
- Database Query (legacy) (11 %)
- Database Row Filter (legacy) (11 %)
- Database SQL Executor (legacy) (11 %)
- Show all 6 recommendations
Workflows
Installation
To use this node in KNIME, install KNIME Amazon Athena Connector from the following update site: