Athena URI Format

The Uniform Resource Identifier (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}

Parameter 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 lowercase letters, uppercase letters, 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 U+D800
  • 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.eu-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.eu-west-3.amazonaws.com/default_catalog.데이터_베이스
• awsathena://athena.eu-west-2.amazonaws.com/[email protected]