​
Introduction

The runQuery function allows you to dynamically execute SQL queries based on the results of a previous query. This functionality is particularly useful when you need to dynamically generate column names or perform operations based on values that are not known until runtime.

​
Syntax

The syntax is runQuery + ('query_file_name_to_run'). This would return the whole query. The payment_methods.sql results are:
idpayment_method
1cash
2credit_card
3transfer
4promotion
You can run a query from another one. For instace in purchases_validation we are going to run the payment_methods one.
purchases_validation
{results = runQuery('payment_methods')}
Then you can access a specific row with:
payment_validation
SELECT *
FROM table
WHERE payment_method IS NOT null
{#each results as row}
  OR payment_method = {payment_type = row['payment_method']}
{/each}
It is transformed into: 
SELECT *
FROM table
WHERE payment_method IS NOT null
  OR payment_method = cash
  OR payment_method = credit_card
  OR payment_method = transfer
  OR payment_method = promotion

​
Example

Consider a scenario where you have a payments table and you want to generate a table that shows the total amount for each payment method, along with a column for the total amount. The steps would be as follows:
  1. Identify Different Payment Methods:
-- payment_methods.sql
SELECT DISTINCT payment_method FROM payments
ORDER BY 1
  1. Generate Report Based on Distinct Payment Methods:
Generate a report based on distinct payment methods: Using the results of the first query, runQuery is called to dynamically generate a second SQL query. This second query aggregates the payment amounts by each different payment method obtained from the first query.
Remember to enclose any latitude logic in curly braces { }.
 
-- my_model.sql
{results = runQuery('payment_methods')}   -- Here we put in a variable the results from the payment_methods query
SELECT
  order_id,
  {#each results as row}    -- We create a loop to add the specfied SQL code for each row after run payment_methods
    {payment_type = row['payment_method']}    -- We create a variable that contain the value from payment_method column
    SUM(
        CASE WHEN payment_method = {payment_type}    -- We compare the current value of the loop with the
        THEN amount END
    ) AS {payment_type}_amount,
  {/each}
  SUM(amount) AS total_amount
FROM payments
GROUP BY 1
This approach is essential for creating dynamic SQL queries that adjust based on actual database contents, which is not directly possible with standard SQL due to its static nature.