Skip to content

Connecting to Amazon Athena

Connection Steps

Please follow the steps below to connect to the Amazon Athena data source.

  1. Click "New Data Connection" in the upper right corner of the data connection page.

  2. Select the Amazon Athena data source from the list of data source types.

  3. Fill in the required parameters for the data source connection as prompted.

    Connection Configuration Information Description

    FieldDescription
    NameThe name of the connection. Required and unique within the user.
    HostThe address of the database. If the URL field is filled, the URL takes precedence.
    PortThe port of the database. If the URL field is filled, the URL takes precedence.
    UsernameIAM key
    PasswordIAM password
    DatabaseDatabase name
    CatalogAWS metadata catalog, default is AwsDataCatalog
    RegionRegion name, e.g., cn-north-1
    Amazon Athena s3 Query Result Output PathAmazon Athena s3 query result output path, e.g., s3://athena-result/result/
    WorkgroupWork group
    Amazon Athena s3 Output Table Storage PathAmazon Athena s3 output table storage path, only used for output scenarios, e.g., s3://athena/0-storage/
    Max ConnectionsMaximum number of connections in the connection pool
    Prefer Using Database Comment as Dataset TitleWhether to display the table name or the table comment as the title. When enabled, the title is shown; when disabled, the table comment is shown.
    URLJDBC URL of the database
    Query Timeout (seconds)Default is 600. For large data volumes, you can increase the timeout as needed.
    Allow Write OperationsIndicates that this connection can be selected as an output connection in Data Integration and Batch Sync. You must have write permissions to the database and pass verification before configuring this parameter.
    Support Uploading Files to Specified PathIndicates the database name where tables generated when creating local file datasets are stored. You must have write permissions to the database and pass verification before configuring this parameter.
    Show Only Tables in Specified Database/SchemaWhen this option is selected and the database field is not empty, only tables under that database will be displayed.
  4. After filling in the parameters, click the Validate button to get the validation result (this checks the connectivity between HENGSHI SENSE and the configured data connection; you cannot add the connection if validation fails).

  5. After validation passes, Allow Write Operations and Support Uploading Files to Specified Path will be enabled and can be optionally turned on.

  6. Click Execute Preset Code to pop up the preset code for this data source, then click the execute button.

  7. Click the Add button to add the Amazon Athena connection.

Please Note

  1. Parameters marked with * are required; others are optional.
  2. You must execute the preset code when connecting to the data source. Failure to do so may result in certain functions being unavailable during data analysis. In addition, when upgrading from a version prior to 4.4 to 4.4, you need to execute the preset code for existing data connections in the system.

User Manual for Hengshi Analysis Platform