Writing Your First SAQL Query in CRM Analytics
Salesforce Analytics Query Language (SAQL) is a powerful tool for querying and transforming data in CRM Analytics (formerly Tableau CRM). If you're new to SAQL, this guide will walk you through writing your first query.
•

Introduction
Salesforce Analytics Query Language (SAQL) is a powerful tool for querying and transforming data in CRM Analytics (formerly Tableau CRM). If you're new to SAQL, this guide will walk you through writing your first query, explaining each line in detail.
Understanding SAQL Basics
SAQL is a JSON-based query language used to process and analyze datasets in Salesforce Analytics. It allows you to:
- Filter and aggregate data
- Perform calculations
- Group and pivot results
Let’s break down a simple SAQL query step by step.
Your First SAQL Query
Here’s a basic SAQL query that retrieves total sales by product category:
q = load "Sales_Data";
q = group q by 'Product_Category';
q = foreach q generate
'Product_Category' as 'Category',
sum('Amount') as 'Total_Sales';
q = order q by 'Total_Sales' desc;
q = limit q 10;
Line-by-Line Breakdown
q = load "Sales_Data";
- Loads the dataset named "Sales_Data" into a variable
q
.
- Loads the dataset named "Sales_Data" into a variable
q = group q by 'Product_Category';
- Groups the data by the field 'Product_Category'.
q = foreach q generate ...
- Processes each grouped record and generates new fields:
'Product_Category' as 'Category'
→ Renames the field for clarity.sum('Amount') as 'Total_Sales'
→ Calculates the sum of the 'Amount' field.
- Processes each grouped record and generates new fields:
q = order q by 'Total_Sales' desc;
- Sorts results by 'Total_Sales' in descending order.
q = limit q 10;
- Limits results to the top 10 records.
Running the Query in CRM Analytics
- Open CRM Analytics Studio.
- Create a new Dataset or Lens.
- Switch to SAQL Mode (instead of point-and-click).
- Paste the query and execute it.
Best Practices for SAQL
- Use meaningful aliases (e.g.,
'Total_Sales'
instead of'sum1'
). - Optimize grouping to improve performance.
- Test queries in small datasets first.
Conclusion
SAQL unlocks advanced analytics in Salesforce CRM Analytics. By mastering basic queries, you can extract powerful insights from your data.
Ready to try it yourself? Write your first SAQL query today!
Blog Thumbnail Image Description
- Background: Soft pastel solid color (e.g., light blue or mint green).
- Icon: A database/search icon in the center.
- Text Overlay: "Write Your First SAQL Query in CRM Analytics" in a clean, bold font.
Would you like me to generate a thumbnail image for you? Let me know! 🚀
Swarnil
Learn Salesforce Development
Master the #1 CRM platform with our comprehensive courses
Join our training program to become a certified Salesforce developer or administrator.