Documentation Index
Fetch the complete documentation index at: https://docs.asteragents.com/llms.txt
Use this file to discover all available pages before exploring further.
What it does
The Snowflake SQL tool executes SQL queries directly on your Snowflake data warehouse. Perfect for data analysis, reporting, business intelligence, and accessing large-scale datasets with Snowflake’s cloud performance.Requires Snowflake Integration: You need to set up a Snowflake integration before agents can use this tool.
Key features
- Execute any SQL query on Snowflake warehouses
- Automatic warehouse management and suspension
- Enterprise-grade security and performance
- Support for complex analytical queries
- Clean, structured result formatting
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | The SQL query to execute on Snowflake |
Common use cases
Data analysis and reporting
Customer segmentation
Performance monitoring
Data quality checks
Complex analytics
Snowflake-specific features
- Automatic scaling: Warehouses scale based on query complexity
- Zero-copy cloning: Access cloned data without additional storage costs
- Time travel: Query historical data states
- Secure data sharing: Access shared datasets across organizations
- Semi-structured data: Query JSON, Parquet, and other formats natively
Best practices
- Use appropriate warehouse sizes for your query complexity
- Leverage Snowflake’s columnar storage with SELECT specific columns
- Use clustering keys for large tables to improve performance
- Take advantage of result caching for repeated queries
- Monitor credit usage and optimize expensive queries
- Use LIMIT clauses for exploratory queries
Troubleshooting
“Warehouse not found” or “Access denied”- Verify your Snowflake integration is properly configured
- Check that the specified warehouse exists and is accessible
- Ensure your user has the necessary permissions
- Validate your SQL syntax for Snowflake
- Check that table and column names exist
- Verify data types in your queries
- Ensure your user has SELECT permissions on the tables
- Check that you have USAGE permissions on the database and schema
- Verify warehouse usage permissions
- Consider using a larger warehouse for complex queries
- Optimize your query with proper filtering and indexing
- Break large queries into smaller, more focused ones
Related tools
- Execute Python - Analyze query results with Python
- Send Email - Share reports and insights
