Skip to content

Athena (S3 + Glue)

Install

See the Install guide for the full setup, including Windows PowerShell.

curl -fsSL https://install.skippr.io/install.sh | shClick to copy

Uses Athena as the configured warehouse target. In public skippr.yaml, Skippr stores Athena connection and discovery settings here and derives the lower-level skippr-el sink config at runtime.

Configuration

yaml
warehouse:
  kind: athena
  workgroup: primary
  region: us-east-1
  result_s3: s3://my-bucket/athena-results/
  schema: raw_data
FieldDefaultDescription
workgroupAthena workgroup name
regionAWS region
result_s3S3 location for Athena query results
schemaDefault database or schema for discovery and unqualified queries

CLI

bash
skippr connect warehouse athena \
  --workgroup primary \
  --region us-east-1 \
  --result-s3 s3://my-bucket/athena-results/ \
  --schema my_database
FlagDescription
--workgroupAthena workgroup name (default: primary)
--regionAWS region
--result-s3S3 output location for query results (omit to use workgroup default)
--schemaDefault database/schema for discovery and unqualified queries

Config output

Running connect warehouse athena writes the public Athena settings into skippr.yaml. Skippr then translates those values into the runtime Athena sink shape when it generates skippr-el.yaml.

yaml
warehouse:
  kind: athena
  workgroup: primary
  region: us-east-1
  result_s3: s3://my-bucket/athena-results/
  schema: my_database

Authentication

Authentication uses the AWS default credential chain.

  • AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY
  • IAM roles, instance profiles, or task roles
  • AWS SSO or shared config profiles

Permissions or Network Requirements

The AWS principal needs access to the target S3 bucket, Glue database, and Athena workgroup or result location you configure. The runner must also be able to reach the AWS APIs for the configured region.

Troubleshooting

SymptomFix
query or Glue metadata errorsVerify the Glue database name, Athena workgroup settings, and the configured result S3 location.
AccessDeniedCheck the AWS credential chain and confirm access to S3, Glue, and Athena resources.

Next steps

Install

See the Install guide for the full setup, including Windows PowerShell.

curl -fsSL https://install.skippr.io/install.sh | shClick to copy