Skip to main content

AQL Troubleshooting

This is one of three documents aimed at helping answer common questions about AQL:

  1. Troubleshooting (this guide)
  2. AQL Error Reference

This guide covers two main topics:

Identify the Source of an Error​

When faced with an AQL error, your first step should be to identify the exact source of the problem. Most errors can be traced to a specific field (metric or dimension) in your code.

The problematic code will typically be highlighted in red, within the definition of the field causing the error, as shown in this example:

AQL error trace example showing highlighted error in code

This visual indication should provide enough information to help you fix most errors. If you need additional context or the error message isn't clear, consult the resources listed below.

Helpful Resources​

Documentation Resources​

  • AQL Error Reference A comprehensive reference guide for AQL error codes, including explanations and suggested fixes. Error messages in AQL will typically link directly to the relevant section of this document.

Testing and Reproduction​

AMQL Online Sandbox​

If the documentation doesn't resolve your issue, the AMQL online sandbox can be invaluable for troubleshooting:

  • Create a minimal reproduction of your problem
  • Isolate specific AQL code segments to identify issues
  • Test potential fixes in a controlled environment

Using the sandbox allows you to simplify complex queries and focus on the specific components causing errors, making it easier to find solutions.

Let us know what you think about this document :)