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}

Asset URI format:

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

Database URI format:

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

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

Asset 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

Database examples:

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