Athena URI format

URI definition for Athena follows this standard:

Identifier fragments:

  • Namespace: awsathena://athena.{region_name}.amazonaws.com
    • Scheme = awsathena
    • Authority = athena.{region_name}.amazonaws.com
  • Unique name: {catalog}.{database}.{table}

URI format:

  • awsathena://athena.{region_name}.amazonaws.com/{catalog}.{database}.{table}

Parameters limitations:

  • region_name identifier must start with a lowercase letter and include only lowercase letters, numbers and dash (regex: [a-z][a-z0-9-]*)
  • catalog identifier must include only lowercases, uppercases, numbers, underscore, dash and @ (regex:
    [a-zA-Z0-9_@-]+)
  • database and table identifiers must include only characters included in those unicode ranges:
    • U+0020 to U+002D
    • U+002F to UD800
    • U+DBFF to U+DC00
    • U+DFFF to U+FFFD

Examples:

  • awsathena://athena.eu-west-1.amazonaws.com/AwsDataCatalog.test.daily_trade
  • awsathena://athena.us-west-3.amazonaws.com/default_catalog.데이터_베이스.table
  • awsathena://athena.eu-west-2.amazonaws.com/[email protected]._Table