Skip to main content

Asynchronous Cross Region Queries with StackQL

In this guide, we will demonstrate a powerful capability within StackQL: the ability to query and aggregate resources across multiple regions in AWS. This involves numerous API requests to different endpoints, which are performed asynchronously. This is seamless and transparent to the user.

StackQL is a powerful dev tool that enables querying and deploying cloud infrastructure and resources using SQL syntax.

Tested with embedded sql backend postgres sql backend macos linux powershell

Understanding AWS Regions and Resources

AWS resources are hosted in multiple locations worldwide. These locations are composed of Regions and Availability Zones, designed to allow users to place instances and store data in various locations.

The problem with AWS Regions...

When working with AWS, it's crucial to understand that the AWS Management Console provides a regionally scoped view of resources, allowing users to interact with and manage resources within a specific region at a time. Similarly, AWS Command Line Interface (CLI) commands and Software Development Kits (SDKs) use the region as an entry point for operations, necessitating the specification of a region to execute commands or run programs.

The regional framework of cloud services introduces complexities when resources span multiple regions. Additionally, security breaches, including cryptocurrency mining exploits, frequently utilize resources in various areas, extending beyond the primary region typically used by organizations.

Specifying Regions in StackQL Queries

Using StackQL, you can specify regions to target resources across different geographic locations. This is particularly useful for managing resources that are distributed across the globe.

Example: Listing EC2 Instances Across Multiple Regions

SELECT instanceId, region
FROM aws.ec2.instances
WHERE region IN ('us-east-1', 'eu-west-1');

This query returns a list of EC2 instances from the us-east-1 (N. Virginia) and eu-west-1 (Ireland) regions, showcasing how StackQL can fetch data across regions in a single query. This could be used with aggregate queries as well, such as:

SELECT region, COUNT(*) as num_functions
FROM aws.lambda.functions
WHERE region IN (
GROUP BY region;

The Power of Asynchronous Queries

StackQL executes these cross-region queries asynchronously, making multiple parallel API requests to AWS. This ensures efficient data retrieval without waiting for one region's request to complete before moving on to the next.


Asynchronous cross-region queries in StackQL provide a robust and efficient method for managing AWS resources across different geographical locations. By leveraging SQL-like syntax for these queries, StackQL simplifies complex cloud management tasks, making it an invaluable tool for developers and cloud administrators aiming to optimize their AWS infrastructure.